API-changelog

v1-update - juli 2026

Additieve toevoegingen van foutcodes en responsvelden aan het bestaande v1-contract.

• Nieuwe fout 422 withdrawal_consent_required op het download-urls-endpoint voor bestellingen: wordt geretourneerd wanneer de shop EU-herroepingstoestemming heeft ingeschakeld en de bestelling nog geen toestemmingsregistratie heeft; download-URL's worden uitgegeven zodra de klant toestemming geeft.
• Nieuwe fout 422 key_limit_reached bij het aanmaken van API-sleutels: een shop kan maximaal 25 actieve API-sleutels hebben; trek er eerst één in.
• Nieuwe fout 409 delivery_not_yet_released op de endpoints download-urls en resend voor bestellingen: wordt geretourneerd wanneer voor het product een vertraging van de downloadlevering is ingesteld en de bestanden van de koper nog niet zijn vrijgegeven. Er worden geen download-URL's uitgegeven en er wordt geen e-mail verstuurd totdat de vertraging is verstreken.
• Nieuw error.details-object in de foutenvelop: alleen aanwezig bij codes die veilige context voor de aanroeper meesturen. Op dit moment is delivery_not_yet_released de enige producent; het bevat release_at, het ISO 8601-moment waarop de downloads worden vrijgegeven. Behandel het object als open - er kunnen nieuwe sleutels bijkomen zonder een nieuwe hoofdversie.
• Nieuwe velden delivery_pending en release_at op het aankoopobject van de bestelstatus: delivery_pending is true zolang een aankoop nog wordt vastgehouden door een vertraging van de downloadlevering, en release_at is het ISO 8601-moment van vrijgave, of null wanneer er niets in behandeling is.
• Het grant-downloads-endpoint geeft vastgehouden aankopen van de bestelling nu direct vrij, zodat een merchant een vertraging van de downloadlevering via de API kan overrulen.

v1.0.0 - juni 2026

Eerste pilot-API-oppervlak achter toegang op uitnodiging.

• API-sleutels voor goedgekeurde winkels.
• Verplichte idempotency-sleutels bij schrijfverzoeken.
• Import van assets via remote-URL, directe uploads, asset-overzichten, asset-updates en asset-verwijdering.
• Platte categorieën, productkoppelingen, packs en licentiecode-tags.
• Ordertoewijzingen die gekoppelde downloads zichtbaar maken in Shopify-klantaccounts.
• Toegangsbeheer voor bestellingen: intrekken, herstellen, downloads verlenen en e-mail opnieuw versturen.
• Endpoints voor job- en orderstatus.
• Downloads van de OpenAPI-specificatie en de Postman-collectie.

Versiebeleid

Het v1-contract is uitsluitend additief: er kunnen nieuwe endpoints, optionele velden en nieuwe foutcodes worden toegevoegd. Breaking changes gebruiken een toekomstig /api/v2-pad.