API-Dokumentation für kostenloses SMS-Marketing

Integrationsleitfaden für mobile App

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

Holen Sie sich zuerst Ihren API-Schlüssel

Bevor Sie kostenlose SMS-Marketing-Nachrichten senden, erstellen Sie einen persönlichen API-Schlüssel im Web-Panel. Mit diesem Schlüssel kann Ihre Website, Ihr CRM oder Ihr Automatisierungstool die API direkt aufrufen.

Melden Sie sich im Web-Panel an und gehen Sie zu Einstellungen.
Scrollen Sie zum Abschnitt API-Schlüssel und klicken Sie auf Schlüssel generieren.
Kopieren Sie den Schlüssel und verwenden Sie ihn im Authorization: Bearer-Header Ihrer Anfragen.

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`. Also supports `whatsapp`.
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-Übersicht

Dies ist die REST-API der RCSZilla Android-App und des Web-Panels für kostenlose SMS-Marketing-Workflows. Verwenden Sie sie, um ausgehende Nachrichten in die Warteschlange zu stellen, den Lieferstatus zu melden, eingehende Antworten zu übermitteln und die Gerätekonfiguration zu synchronisieren.

Alle Anfragen und Antworten verwenden JSON. Alle Endpoints werden von https://api.rcszilla.com/ bereitgestellt und über den Parameter ?endpoint= ausgewählt.

Anfrageformat

Jede Anfrage muss Content-Type: application/json und einen Authorization-Header senden (außer claim_device, das öffentlich ist).

HTTPBeispielanfrage

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"}

Antwortformat

Jede Antwort ist ein JSON-Objekt. Erfolgreiche Antworten enthalten immer "success": true. Fehler enthalten "success": false und ein "message"-Feld.

JSONBeispielantwort - success

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

JSONBeispielantwort - error

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

Quick Reference

Endpoint	Methode	Authentifizierung	Beschreibung
queue_sms	POST	Bearer	Queue an SMS or WhatsApp 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