DogeSMS Control API Documentation
Use the unified /api/control endpoints to automate number inventory, activations, SMS retrieval, cancellations, reuse, and rentals. Supports OAuth2 Client Credentials or API Key signing. All write operations require an Idempotency-Key.
Authentication
• OAuth2 Client Credentials recommended; access_token expires after 2 hours.
• Static API Key supported via X-API-Key header.
• Refresh keys anytime in the console; IP whitelist available.
Rate Limiting & Idempotency
• Default limits: 10 writes/sec, 30 reads/sec.
• Use the Idempotency-Key header to prevent duplicate charges; generate a unique UUID per transaction.
• On HTTP 429, apply exponential backoff before retrying.
Core Endpoints
Common endpoints shown below. See the OpenAPI file for the full list.
| Method | Path | Description | Common Responses |
|---|
Activation Request Example
Request body and response JSON when calling POST /api/control/activations.
POST /api/control/activations
Headers:
Authorization: Bearer <token>
Idempotency-Key: 73b7-...-ff2
Body:
{
"serviceCode": "whatsapp",
"countryCode": "US",
"reuse": true
}Response 200:
{
"requestId": "act-123",
"number": "+1 650 555 0101",
"expiresAt": "2024-03-18T08:10:00Z",
"canReuseUntil": "2024-03-18T08:30:00Z"
}Supported Services & Countries
Currently 0 services and 0 countries/regions available.
Technical Support
Last updated: 刚刚. For enterprise access or high-concurrency quotas, contact the sales team.