Set up API access
1. Confirmez que la boutique est approuvée pour le pilote
Alva doit approuver la boutique avant que des clés d'API puissent être créées ou utilisées. Si l'accès n'est pas encore actif, contactez admin@alvaapps.com.
2. Créez une clé d'API
Ouvrez les Paramètres d'Alva, choisissez Clés d'API 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.
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 ?
Non. L'accès à l'API est disponible sur approbation. Contactez admin@alvaapps.com pour activer l'accès à l'API de votre boutique.
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 ?
Last updated 2026-06-05