API Documentation
REST API reference for developers
Getting Started
Post+ API is designed with RESTful architecture and uses JSON for data exchange. You need an API key to use the API.
Base URL
https://api.postplus.net/v1
Authentication
All API requests must include the Authorization header:
Authorization: Bearer YOUR_API_KEY
Getting API Key
- Log in to your dashboard
- Go to Settings > API
- Click "Generate API Key"
- Store your key securely
WhatsApp API
POST /whatsapp/send
Send WhatsApp message to a single recipient.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| phone | string | REQUIRED | Recipient phone number (+90...) |
| message | string | REQUIRED | Message content |
| sender_id | string | Optional | Sender account ID (default: first account) |
| media_url | string | Optional | Media file URL |
Example Request
curl -X POST https://api.postplus.net/v1/whatsapp/send \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phone": "+1234567890",
"message": "Hello! This is a test message.",
"sender_id": "wa_123456"
}'
Example Response
{
"success": true,
"message_id": "msg_987654",
"status": "sent",
"timestamp": "2025-01-19T10:30:00Z"
}
GET /whatsapp/status/{message_id}
Check message delivery status.
Example Response
{
"message_id": "msg_987654",
"status": "delivered",
"sent_at": "2025-01-19T10:30:00Z",
"delivered_at": "2025-01-19T10:30:05Z",
"read_at": "2025-01-19T10:31:20Z"
}
Error Codes
| Code | Description |
|---|---|
| 200 | Successful request |
| 400 | Invalid request parameters |
| 401 | Invalid or missing API key |
| 403 | Insufficient credits |
| 429 | Rate limit exceeded |
| 500 | Server error |
Rate Limits
The following limits apply to API usage:
- Starter: 60 requests/minute
- Pro: 300 requests/minute
- Enterprise: 1000 requests/minute