Les bases de l'API REST

Nous avons conçu un API REST de commerce électronique complet qui vous permet de gérer vos données comme bon vous semble. Elle s'appuie sur les fonctionnalités standards du protocole HTTP — authentification, verbes et codes de réponse — pour rester prévisible et simple à utiliser.

L'essentiel

URL de base	https://app.snipcart.com/api
Format	JSON uniquement — envoyez toujours l'en-tête Accept: application/json dans chaque requête.
Authentification	HTTP Basic avec une clé API secrète (la clé comme nom d'utilisateur, mot de passe vide). Voir Authentification.
Erreurs	Codes d'état HTTP standards, avec un corps d'erreur JSON pour les 4xx. Voir Erreurs.
Évolution des réponses	Snipcart peut ajouter de nouveaux champs aux réponses de l'API en tout temps, sans préavis ni nouvelle version. Les champs existants ne sont ni renommés ni retirés : ignorez les champs que vous ne reconnaissez pas plutôt que de faire échouer votre intégration (p. ex. évitez une validation de schéma stricte qui rejette les propriétés inconnues).

Une première requête

curl -H "Accept: application/json" \
  https://app.snipcart.com/api/orders \
  -u {YOUR_SECRET_API_KEY}:

Si vous débutez avec les API, vous pouvez lire cette introduction à l'intégration des API.