So-Mobile API Documentation

Quick Start

Tout ce qu'il faut pour commencer en 2 minutes.

https://preprod.so-mobile.net/api/v2

Authorization: Bearer <token>

Content-Type: application/json

{
  "success": true,
  "data": [...],
  "pagination": {
    "total": 150,
    "limit": 50,
    "offset": 0
  }
}

{
  "success": false,
  "error": "Invalid token",
  "code": "AUTH_INVALID"
}

Exemples prêts à copier-coller dans votre langage.

SDK universel en 3 langages + 10 packages CRM natifs.

🟨

JavaScript

npm install so-mobile

🐘

PHP

composer require so-mobile/sdk

🐍

Python

pip install so-mobile

☁️ Salesforce 🟠 HubSpot 🔴 Adobe AJO 🟢 Pipedrive 🔴 Zoho 🔵 Dynamics 365 🟡 Monday 🟣 Freshsales 🇫🇷 Sellsy 🛒 Shopify

Les limites sont par token API. Des headers X-RateLimit-* sont retournés à chaque requête.

100requêtes / seconde

10 000SMS / minute

5 000Webhooks / seconde

50 MoUpload max (contacts CSV)

99.9%SLA disponibilité

< 200msLatence moyenne API

Codes HTTP standard + codes métier spécifiques.

Code HTTP	Code métier	Description
`200`	—	Succès
`400`	`VALIDATION_ERROR`	Paramètre manquant ou invalide
`401`	`AUTH_INVALID`	Token absent, expiré ou invalide
`403`	`FORBIDDEN`	Pas les droits pour cette ressource
`404`	`NOT_FOUND`	Ressource inexistante
`409`	`DUPLICATE`	Ressource déjà existante (contact, webhook...)
`422`	`INVALID_PHONE`	Numéro de téléphone invalide
`422`	`BLACKLISTED`	Numéro dans la blacklist (STOP)
`422`	`INSUFFICIENT_CREDITS`	Solde wallet insuffisant
`429`	`RATE_LIMIT`	Trop de requêtes — réessayer après X secondes
`500`	`INTERNAL_ERROR`	Erreur serveur interne
`503`	`PROVIDER_DOWN`	Fournisseur (opérateur) temporairement indisponible

Créez votre compte, obtenez un token API et envoyez votre premier SMS en 2 minutes.