📖 SANYA API v1

Tumia HTTP Basic Auth — api_key:secret base64-encoded:

Authorization: Basic <base64(api_key:secret)>
Content-Type: application/json

Pata API key kwenye /api/keys dashboard.

POSThttps://app.sanya.tz/api/v1/sms/send

Request body:

{
  "to": ["255712345678", "255713456789"],
  "message": "Habari, ujumbe wenu...",
  "sender_id": "SANYA"
}

Response:

{
  "ok": true,
  "sent": 2,
  "failed": 0,
  "balance_remaining": 4998,
  "results": [
    {"to": "255712345678", "status": "sent", "units": 1},
    {"to": "255713456789", "status": "sent", "units": 1}
  ]
}

cURL Example:

curl -X POST https://app.sanya.tz/api/v1/sms/send \
  -u "your_api_key:your_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["255712345678"],
    "message": "Habari mteja!"
  }'

PHP Example:

$ch = curl_init('https://app.sanya.tz/api/v1/sms/send');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode([
        'to'      => '255712345678',
        'message' => 'Habari mteja!',
    ]),
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Authorization: Basic ' . base64_encode('your_api_key:your_secret'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

GEThttps://app.sanya.tz/api/v1/sms/balance

Response:

{
  "ok": true,
  "balance": 4998,
  "plan": "free",
  "daily_limit": 1000,
  "daily_used": 12,
  "daily_remaining": 988,
  "sender_id": "SANYA"
}

GEThttps://app.sanya.tz/api/v1/sms/messages?limit=50&offset=0&status=sent

Returns recent SMS messages za API key yako (au za user kwa ujumla).

GEThttps://app.sanya.tz/api/v1/sender-ids

Onyesha sender IDs zinazokubalika kwako (public + zako exclusive).