API Sangho

L’API Sangho est une API REST qui accepte des requêtes JSON encodées en UTF-8 sur HTTPS. Elle supporte deux environnements : Production et Sandbox.

URL de base

Toutes les requêtes doivent être adressées à l’URL de base. Utilisez des clés sk_test_ pour le Sandbox et des clés sk_live_ pour la Production. L’environnement sera automatiquement déduit de ces clés.

Format des requêtes

• Protocole : HTTPS uniquement (TLS 1.2+)
• Format : JSON (Content-Type: application/json)
• Encodage : UTF-8
• Pagination : cursor-based (after, before, limit)
• Timestamps : ISO 8601 (UTC)
• Montants : entiers en centimes de la devise

SDKs disponibles

Sangho propose des SDKs officiels pour JavaScript/TypeScript, Python, PHP et Java. Ces SDKs gèrent automatiquement l’authentification, la pagination, les erreurs et les retries.

npm install @sangho/sdkpip install sanghocomposer require sangho/sangho-phpcom.sangho:sangho-java

Environnements

textCopier

https://api.sangho.com/v1/

Exemple de requête

cURLNode JSPythonPHP

bashCopier

curl https://api.sangho.com/v1/account \
  -H "Authorization: Bearer sk_test_xxxx" \
  -H "Content-Type: application/json"

Response 200 OK

jsonCopier

{
  "id": "app_xxxxxxxx",
  "name": "Ma boutique",
  "environment": "sandbox",
  "api_version": "v1",
  "created_at": "2026-01-15T09:00:00Z"
}