# CySmS

> API de numéros virtuels pour réception d'OTP SMS (WhatsApp, Telegram, Google, TikTok, etc.).

Site: https://cysms.net
Documentation HTML (publique, sans compte): https://cysms.net/api-docs
Spécification Markdown (pour assistants IA): https://cysms.net/docs/api.md
Alias FR: https://cysms.net/documentation

## API

- Base REST: `https://cysms.net/api/reseller`
- Stubs SMS-Activate: `https://cysms.net/stubs/handler_api.php`
- Auth recommandée: header `X-Api-Key: cs_live_...` (Bearer accepté; query `api_key` réservée surtout à la compatibilité Stubs)
- Toujours lire `success` dans le JSON, même avec HTTP 200

## Actions

- `GET ?action=getBalance`
- `GET ?action=getServices&country=77&provider=v1|v2` pour le prix et le stock; sans pays, catalogue uniquement
- `GET ?action=getCountries`
- `POST ?action=buyNumber` body `{ "service": "wa", "country": "77", "provider": "auto" }`
- `GET ?action=getStatus&orderId=CY-...`
- `POST ?action=cancelOrder` body `{ "orderId": "CY-..." }`; succès confirmé uniquement par `success: true`, montant dans `refunded`
- Webhooks: `getWebhook` / `setWebhook` / `testWebhook` / `deleteWebhook`

`provider` est une priorité de routage. La gamme réellement utilisée est renvoyée par `buyNumber` dans `serviceType` et `providerName`.

Lisez la spec complète: https://cysms.net/docs/api.md