Set up API access
1. Vérifiez que la boutique dispose d'une formule payante
L'API fonctionne avec toutes les formules payantes. Avec la formule Free, l'onglet API keys est masqué et les clés existantes renvoient plan_required ; passez à une formule payante pour utiliser l'API.
2. Créez une clé d'API
Ouvrez les Paramètres d'Alva, choisissez API keys et créez une clé pour l'intégration. Copiez le jeton une seule fois et stockez-le dans un gestionnaire de secrets. Alva ne conserve qu'un id de clé public et un hachage du secret. Une fois la clé créée, ce même onglet affiche votre URL de base d'API — l'adresse à laquelle chaque requête est envoyée.
3. Envoyez le jeton dans un en-tête Bearer
Envoyez chaque requête avec Authorization: Bearer adk_live_.... Une clé manquante, mal formée, inconnue ou révoquée renvoie la même réponse non autorisée, afin que les attaquants ne puissent pas énumérer les clés valides.
4. Incluez des clés d'idempotence sur les écritures
Chaque requête autre que GET doit inclure un en-tête Idempotency-Key. Réutiliser la même clé et le même corps rejoue en toute sécurité une réponse réussie au lieu de créer une ressource, une association, une attribution ou un changement d'accès en double.
Créer des ressources et associer des produits
Utilisez POST /api/v1/assets pour importer un fichier distant depuis un hôte autorisé, ou utilisez les endpoints de téléversement direct lorsque votre intégration téléverse elle-même vers le stockage Alva. Interrogez GET /api/v1/jobs/{job_id} jusqu'à ce que l'import distant soit terminé.
Une fois la ressource créée, créez ou mettez à jour une association avec POST /api/v1/mappings. Les ids de produit doivent utiliser le format GID de Shopify. L'API limite chaque association à la boutique rattachée à la clé d'API.
Attribuer des téléchargements aux commandes
Utilisez POST /api/v1/orders/{shopify_order_id}/assignments lorsqu'un système externe doit donner à un client l'accès à des produits numériques associés. L'attribution peut créer l'enregistrement du client, créer l'achat et, en option, envoyer l'e-mail de livraison.
Utilisez les endpoints d'accès aux commandes pour révoquer l'accès, le restaurer, accorder des téléchargements supplémentaires ou renvoyer l'e-mail de livraison. Ces actions sont limitées à la boutique et n'acceptent pas d'ids de boutique dans le corps de la requête.
Consulter la documentation de l'API
Utilisez le démarrage rapide, la référence des endpoints, le guide des erreurs et la spécification OpenAPI téléchargeable pour créer une intégration.
FAQ
Tous les marchands peuvent-ils utiliser l'API externe ?
Tout marchand disposant d'une formule payante (Basic, Pro ou Enterprise) peut l'utiliser. La formule Free n'inclut pas l'accès à l'API.
Do write requests need idempotency keys?
Oui. Chaque requête autre que GET doit inclure un en-tête Idempotency-Key afin que les nouvelles tentatives ne créent pas de ressources, d'associations, d'attributions ou de changements d'accès en double.
See also
Cet article vous a-t-il été utile ?
Dernière mise à jour 2026-10-05