Construire avec l’API Livoxa v1
Un contrat OpenAPI 3.1 versionné pour connecter commandes, catalogue, stocks et rapports, avec pagination, idempotence et erreurs structurées.
Authentification
Clé bearer avec portées ; signature Ed25519 optionnelle selon la configuration de la clé.
Idempotence
Les mutations documentées exigent une clé stable afin de sécuriser les reprises réseau.
Traçabilité
Les réponses exposent une version d’API et un identifiant de requête, sans révéler les secrets.
Première requête
Créez une clé depuis le portail développeur authentifié, conservez-la côté serveur et envoyez-la dans l’en-tête Authorization.
curl --request GET --url "$LIVOXA_API_URL/orders?limit=50" --header "Authorization: Bearer $LIVOXA_API_KEY"Les variables sont volontairement laissées explicites : l’URL de production et la clé appartiennent à votre environnement.
Pagination par curseur
Les listes acceptent un curseur opaque et une limite de 1 à 100. Réutilisez uniquement le next_cursor renvoyé par la réponse précédente.
Erreurs actionnables
Une erreur fournit un code stable, un message et un request_id. Journalisez cet identifiant pour faciliter le diagnostic sans copier de secrets ni de données personnelles.
Environnements et clés
Les clés de test et de production doivent être séparées. Le portail privé permet de consulter les portées, environnements et versions d’événements réellement actives pour votre entreprise.