Ga direct naar de hoofdinhoud
- Endpoint-referentie

API-endpoint-referentie

Dit zijn de klantgerichte endpoints in de eerste API-versie. Alle paden zijn relatief ten opzichte van je API-basis-URL, die de app toont onder Instellingen → API keys zodra je een sleutel hebt aangemaakt.

Assets

MethodePadDoel
POST/assetsEen externe URL als asset importeren.
POST/assets/uploadsEen directe upload starten.
POST/assets/uploads/{uploadId}/completeEen directe upload afronden.
GET/assetsAssets weergeven.
GET/PATCH/DELETE/assets/{id}Een asset lezen, bijwerken of verwijderen.

Categorieën, koppelingen, packs, links en tags

MethodePadDoel
GET/POST/categoriesPlatte categorieën weergeven of aanmaken.
GET/PATCH/DELETE/categories/{id}Een categorie lezen, hernoemen of verwijderen.
GET/POST/mappingsShopify-productkoppelingen weergeven of upserten.
GET/PUT/DELETE/mappings/{id}Een koppeling lezen, vervangen of verwijderen.
GET/POST/packsPacks weergeven of aanmaken.
GET/DELETE/packs/{id}Een pack lezen of verwijderen.
GET/POST/linksLinks weergeven of aanmaken. Aanmaken vereist een betaald abonnement; bezoeklimieten en vervaldatum blijven alleen via de admin.
GET/POST/license-key-tagsLicentiecode-tags weergeven of aanmaken.

Bestellingen en toegang

MethodePadDoel
GET/orders/{shopify_order_id}De downloadstatus van een bestelling lezen.
GET/POST/orders/{shopify_order_id}/assignmentsToewijzingen op productniveau weergeven of aanmaken.
GET/orders/{shopify_order_id}/assignments/{purchaseId}/download-urlsDownload-URL's aanmaken.
POST/orders/{shopify_order_id}/revokeToegang uitschakelen.
POST/orders/{shopify_order_id}/restoreToegang herstellen.
POST/orders/{shopify_order_id}/grant-downloadsExtra downloads toekennen.
POST/orders/{shopify_order_id}/resendDe leverings-e-mail opnieuw versturen.

Het download-urls-endpoint retourneert 422 withdrawal_consent_required wanneer de shop EU-herroepingstoestemming heeft ingeschakeld en de bestelling nog geen toestemmingsregistratie heeft; download-URL's worden uitgegeven zodra de klant toestemming geeft.

De endpoints download-urls en resend retourneren 409 delivery_not_yet_released wanneer voor het product een vertraging van de downloadlevering is ingesteld en de bestanden van de koper nog niet zijn vrijgegeven. De waarde error.details.release_at is het ISO 8601-moment van vrijgave en het grant-downloads-endpoint geeft de bestelling vervroegd vrij.

Gezondheid en status

MethodePadDoel
GET/healthDe beschikbaarheid van de API controleren.
GET/pingDe authenticatie controleren.
GET/jobs/{jobId}De status van een asynchrone job lezen.

API-documentatie

Was dit nuttig?

Nog vastgelopen? Mail admin@alvaapps.com.

Laatst bijgewerkt 2026-06-05