Ücretsiz SMS Pazarlama API Dokümantasyonu

Mobil Uygulama Entegrasyon Kılavuzu

Temel URL https://api.rcszilla.com/?endpoint={endpoint}

Önce API Anahtarınızı Alın

Ücretsiz SMS pazarlama mesajları göndermeden önce web panelinde kişisel bir API anahtarı oluşturun. Bu anahtar, web sitenizin, CRM'inizin veya otomasyon aracınızın API'yi doğrudan çağırmasını sağlar.

Web paneline giriş yapın ve Ayarlar sayfasına gidin.
API Anahtarı bölümüne inin ve Anahtar Oluştur düğmesine tıklayın.
Anahtarı kopyalayın ve isteklerinizin Authorization: Bearer başlığında kullanın.

Send a Test SMS

Paste your API key, enter a phone number and message, then queue a live SMS request.

JavaScript

API Key Endpoint Method

To Phone Channel Schedule Message

JSON Body / Query Parameters

https://api.rcszilla.com/?endpoint=queue_sms

{
  "status": "ready"
}

How to Send an SMS

Use queue_sms to add an outgoing SMS to the queue. The Android device/app sends it when it polls the API.

Endpoint	`POST https://api.rcszilla.com/?endpoint=queue_sms`
Auth	`Authorization: Bearer YOUR-API-KEY`
to	string	Recipient phone number, with country code recommended.
message	string	SMS text to send.
channel	string	Use `sms` (default). Also supports `whatsapp` and `email`. For `email`, `to` is an email address, `subject` is required, and `smtp_server_id` is optional (auto round-robin when omitted).
subject	string	Required when `channel=email`. Ignored for SMS/WhatsApp.
smtp_server_id	int	Optional. SMTP server to send the email through; omit to auto-rotate across your configured servers.
scheduled_at	string	Optional date/time in `YYYY-MM-DD HH:MM:SS` format.

cURLSend SMS

curl -X POST "https://api.rcszilla.com/?endpoint=queue_sms" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR-API-KEY" \
  -d "{\"to\":\"+40700000000\",\"message\":\"Hello from RCSZilla\",\"channel\":\"sms\"}"

JSONSuccess Response

{
  "success": true,
  "message": "Queued",
  "id": 123
}

API'ye Genel Bakış

Bu, RCSZilla Android uygulaması ve web paneli tarafından ücretsiz SMS pazarlama iş akışları için kullanılan REST API'dir. Giden mesajları kuyruğa almak, teslimat durumunu bildirmek, gelen yanıtları iletmek ve cihaz yapılandırmasını senkronize etmek için kullanın.

Tüm istekler ve yanıtlar JSON kullanır. Tüm uç noktalar https://api.rcszilla.com/ adresinden sunulur ve ?endpoint= sorgu parametresi ile seçilir.

İstek Formatı

Her istek Content-Type: application/json ve bir Authorization başlığı göndermelidir (herkese açık olan claim_device hariç).

HTTPÖrnek İstek

POST https://api.rcszilla.com/?endpoint=queue_sms HTTP/1.1
Host: api.rcszilla.com
Content-Type: application/json
Authorization: Bearer YOUR-API-KEY

{"to": "+40700000000", "message": "Hello from RCSZilla", "channel": "sms"}

Yanıt Formatı

Her yanıt bir JSON nesnesidir. Başarılı yanıtlar her zaman "success": true içerir. Başarısız yanıtlar "success": false ve bir "message" alanı içerir.

JSONÖrnek Yanıt - success

{
  "success": true,
  "message": "Queued",
  "id": 123
}

JSONÖrnek Yanıt - error

{
  "success": false,
  "message": "id required"
}

Quick Reference

Endpoint	Metot	Kimlik Doğrulama	Açıklama
queue_sms	POST	Bearer	Queue an SMS, WhatsApp, or email message to send
claim_device	POST	-	Register a new device (public)
register_device	POST	Bearer	Update device metadata
pending_messages	GET	Bearer	Fetch outgoing message queue
mark_processing	POST	Bearer	Lock a message as in-progress
mark_sent	POST	Bearer	Report message sent
mark_delivered	POST	Bearer	Report delivery receipt
mark_failed	POST	Bearer	Report send failure
submit_reply	POST	Bearer	Submit an incoming message to inbox
queue_status	GET	Bearer	Get single message status
poll	POST	Bearer	Unified heartbeat + queue + config fetch
heartbeat	POST	Bearer	Device keep-alive (deprecated; use poll)
get_config	GET	Bearer	Fetch device configuration
log_outgoing	POST	Bearer	Log a directly-sent message
ack_commands	POST	Bearer	Acknowledge processed commands