Set up API access
1. Controleer of de winkel een betaald abonnement heeft
De API werkt bij elk betaald abonnement. Met het Free-abonnement is het tabblad API keys verborgen en geven bestaande sleutels plan_required terug; stap over op een betaald abonnement om de API te gebruiken.
2. Maak een API-sleutel aan
Open de Alva-instellingen, kies API keys en maak een sleutel aan voor de integratie. Kopieer het token één keer en bewaar het in een secret manager. Alva slaat alleen een openbare sleutel-id en een hash van het secret op. Zodra de sleutel bestaat, toont datzelfde tabblad je API-basis-URL — het adres waar elk verzoek naartoe gaat.
3. Verstuur het token als Bearer-header
Verstuur elk verzoek met Authorization: Bearer adk_live_.... Een ontbrekende, onjuist opgemaakte, onbekende of ingetrokken sleutel geeft dezelfde unauthorized-respons, zodat aanvallers geen geldige sleutels kunnen achterhalen.
4. Voeg idempotentiesleutels toe bij schrijfacties
Elk verzoek dat geen GET is, moet een Idempotency-Key-header bevatten. Door dezelfde sleutel en body opnieuw te gebruiken wordt een geslaagde respons veilig herhaald in plaats van een dubbele asset, koppeling, toewijzing of toegangswijziging aan te maken.
Assets aanmaken en producten koppelen
Gebruik POST /api/v1/assets om een extern bestand op te halen van een toegestane host, of gebruik de directe-uploadendpoints wanneer je integratie zelf naar de Alva-opslag uploadt. Poll GET /api/v1/jobs/{job_id} totdat de externe import is voltooid.
Nadat de asset bestaat, maak je een koppeling aan of werk je deze bij met POST /api/v1/mappings. Product-id's moeten de Shopify GID-indeling gebruiken. De API beperkt elke koppeling tot de winkel die aan de API-sleutel is gekoppeld.
Downloads toewijzen aan bestellingen
Gebruik POST /api/v1/orders/{shopify_order_id}/assignments wanneer een extern systeem een klant toegang moet geven tot gekoppelde digitale producten. De toewijzing kan het klantrecord aanmaken, de aankoop aanmaken en optioneel de bezorgmail versturen.
Gebruik de endpoints voor besteltoegang om toegang in te trekken, te herstellen, extra downloads te verlenen of de bezorgmail opnieuw te versturen. Deze acties zijn beperkt tot de winkel en accepteren geen winkel-id's in de body van het verzoek.
Lees de API-documentatie
Gebruik de snelstart, de endpointreferentie, de foutgids en de downloadbare OpenAPI-specificatie bij het bouwen van een integratie.
FAQ
Kan elke verkoper de externe API gebruiken?
Elke verkoper met een betaald abonnement (Basic, Pro of Enterprise) kan dat. Het Free-abonnement bevat geen API-toegang.
Do write requests need idempotency keys?
Ja. Elk verzoek dat geen GET is, moet een Idempotency-Key-header bevatten, zodat nieuwe pogingen geen dubbele assets, koppelingen, toewijzingen of toegangswijzigingen aanmaken.
See also
Was dit nuttig?
Laatst bijgewerkt 2026-10-05