API : sessions utilisateur

Une session utilisateur (client) relie un acheteur connecté à son compte. À partir d'un jeton de session, vous pouvez récupérer la session ainsi que le client auquel elle appartient. Les requêtes sont authentifiées avec votre clé API secrète, transmise comme nom d'utilisateur en authentification HTTP Basic avec un mot de passe vide. Avec curl : -u {API_KEY}:. Voir Authentification pour plus de détails.

• Obtenir une session par jeton

GET /usersessions/{token}

Cette méthode retourne les informations de la session ainsi que les détails du client.

URL de la ressource

GET https://app.snipcart.com/api/usersessions/{token}

En-têtes

Nom	Valeur	Obligatoire?	Description
Accept	application/json	Oui	L'API ne retourne que du application/json.

Paramètres de chemin

Nom	Obligatoire?	Type	Description
token	Oui	guid	Le jeton de session, transmis dans l'URL.

Exemple de requête

curl -H "Accept: application/json" \
  https://app.snipcart.com/api/usersessions/c83945cd-1802-4861-b1b9-4e98eed8939d \
  -u {API_KEY}:

Exemple de réponse

{
  "token": "c83945cd-1802-4861-b1b9-4e98eed8939d",
  "expires": "2026-04-03T01:09:10.207Z",
  "customer": {
    "id": "c25f6054-3fc9-4792-b2d2-3e10eed55708",
    "email": "geeks@snipcart.com",
    "status": "Confirmed",
    "creationDate": "2026-03-23T20:06:28.577Z",
    "statistics": {
      "ordersCount": 1,
      "ordersAmount": 320.00
    },
    "billingAddressName": "Charles Ouellet",
    "billingAddressCompanyName": "Snipcart",
    "billingAddressAddress1": "226 rue St-Joseph Est",
    "billingAddressAddress2": null,
    "billingAddressCity": "Québec",
    "billingAddressCountry": "CA",
    "billingAddressProvince": "QC",
    "billingAddressPostalCode": "G1K3A8",
    "billingAddressPhone": "555 555 5555",
    "shippingAddressName": "Charles Ouellet",
    "shippingAddressCompanyName": "Snipcart",
    "shippingAddressAddress1": "226 rue St-Joseph Est",
    "shippingAddressAddress2": null,
    "shippingAddressCity": "Québec",
    "shippingAddressCountry": "CA",
    "shippingAddressProvince": "QC",
    "shippingAddressPostalCode": "G1K3A8",
    "shippingAddressPhone": "555 555 5555",
    "shippingAddressSameAsBilling": true,
    "gravatarUrl": "https://www.gravatar.com/avatar/43c0d10549c1cafa66c416c7e7a59698?s=70&d=https%3a%2f%2fapp.snipcart.com%2fcontent%2fimages%2favatar.jpg"
  }
}