Référence API
Les endpoints disponibles, leurs permissions et leurs réponses.
URL de base
https://esimy.siraj-ai.com/api/v1Tous les chemins ci-dessous sont relatifs à cette URL. Les identifiants, prix et dates des exemples sont illustratifs. Utilisez les valeurs retournées par vos propres appels.
Endpoints
| Méthode | Chemin | Permission | Documentation |
|---|---|---|---|
| GET | /catalogue | catalog:read | Catalogue |
| POST | /quotes | orders:write | Devis |
| POST | /orders | orders:write | Créer une commande |
| GET | /orders | orders:read | Lister les commandes |
| GET | /orders/{id} | orders:read | Suivre une commande |
| GET | /orders/{id}/esim | orders:read | Installation |
| GET | /orders/{id}/usage | orders:read | Consommation |
| GET | /wallet | wallet:read | Solde |
Conventions
| Élément | Format |
|---|---|
| Authentification | En-tête Authorization: Bearer …. |
| Corps / réponses | JSON ; Content-Type: application/json. |
| Montants | Entiers en 1/10 000 USD, suffixe Units. |
| Volumes | Octets, suffixe Bytes. |
| Pagination | Pages à partir de 1, jusqu’à 50 résultats par page. |
| Dates | Dates ISO 8601 pour les devis et commandes. |
| Erreurs | Objet error contenant code et message. |
Environnement de production
Paiements et commandes
Les commandes débitent le solde réel. Aucun bouton de test ne déclenche un achat depuis cette documentation.
La création de comptes, les clés et les recharges sont gérées dans le portail agences. Le suivi des commandes se fait par polling ; les webhooks sortants ne sont pas disponibles dans cette version.