Rate Limits

HTTP/1.1 429 Too Many Requests
Retry-After: 60
 
{
  "detail": "Request was throttled. Expected available in 60 seconds."
}

// Node.js example
async function sendWithRetry(payload, maxRetries = 3) {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    const res = await fetch('https://api.talkntalk.africa/v1/sms/send/', {
      method:  'POST',
      headers: { 'Authorization': 'Bearer tk_live_xxxx', 'Content-Type': 'application/json' },
      body:    JSON.stringify(payload),
    });
 
    if (res.status !== 429) return res.json();
 
    if (attempt === maxRetries) throw new Error('Rate limit exceeded after retries');
 
    const retryAfter = parseInt(res.headers.get('Retry-After') ?? '60', 10);
    const delay = retryAfter * 1000 * Math.pow(2, attempt); // exponential
    await new Promise(r => setTimeout(r, delay));
  }
}

# Python example
import time, requests
 
def send_with_retry(payload, max_retries=3):
    for attempt in range(max_retries + 1):
        r = requests.post(
            'https://api.talkntalk.africa/v1/sms/send/',
            headers={'Authorization': 'Bearer tk_live_xxxx'},
            json=payload,
        )
        if r.status_code != 429:
            return r.json()
        if attempt == max_retries:
            raise Exception('Rate limit exceeded after retries')
        retry_after = int(r.headers.get('Retry-After', 60))
        time.sleep(retry_after * (2 ** attempt))