Integreaza WhatsApp, SMS si Email in cateva minute
API-uri REST v4 simple, documentate si gata de productie. Autentificare JWT, webhooks, trimitere in masa si mult mai mult.
- Autentificare JWT Bearer securizata
- Webhooks in timp real pentru toate evenimentele
- Sandbox gratuit, fara card de credit necesar
- Documentatie completa OpenAPI 3.0
Integreaza in 3 pasi
De la zero la mesaje trimise in mai putin de 10 minute.
Obtine tokenul tau
Apeleaza endpoint-ul de autentificare cu credentialele tale pentru a obtine un token JWT de utilizat in toate cererile ulterioare.
{"username":"...","password":"..."}
→ {"token": "eyJh..."}
Trimite primul mesaj
Foloseste tokenul in antetul Authorization si apeleaza endpoint-ul pentru a trimite un mesaj WhatsApp, SMS sau Email.
Authorization: Bearer <token>
→ {"status": "sent"}
Primeste evenimente
Configureaza un webhook pentru a primi mesaje primite, confirmari de livrare si actualizari de status in timp real.
"url": "https://your-app.com/hook"
→ {"status": "active"}
Autentificare JWT Bearer
Toate API-urile Chat API folosesc tokenuri JWT. Genereaza tokenul cu un singur apel POST si include-l in antetul Authorization al fiecarei cereri.
Expirare configurabila
Tokenurile expira dupa o perioada configurabila. Regenereaza automat prin API fara intreruperi.
HTTPS necesar
Toate comunicatiile se fac prin HTTPS cu TLS 1.2+. Nu sunt acceptate apeluri in text simplu.
Credentiale securizate
Numele de utilizator si parola sunt schimbate o singura data pentru a obtine tokenul folosit in apelurile API.
{
"username": "your@email.com",
"password": "your-password"
} {
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...",
"expiresIn": 3600,
"type": "Bearer"
} Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp... Toate endpoint-urile disponibile
Fiecare endpoint este documentat cu parametri, raspunsuri si exemple in documentatia noastra OpenAPI.
Trimite mesaj
/api/v4/whatsapp/chats/{id}/message Trimite un mesaj WhatsApp direct
Lista sabloane
/api/v4/notifications/whatsapp/templates Vizualizeaza sabloanele WhatsApp aprobate
Notificare sablon
/api/v4/whatsapp/notifications Trimite notificare individuala in afara ferestrei de 24h
Trimitere in masa
/api/v4/whatsapp/bulk Trimite catre mii de contacte intr-un singur lot
Trimite SMS
/api/v4/sms/send Trimite un SMS catre orice numar din lume
Campanie SMS
/api/v4/sms/bulk Trimitere in masa catre liste de contacte
Raport de livrare
/api/v4/sms/reports/{id} Verifica statusul de livrare
Trimite email
/api/v4/email/send Email tranzactional cu DKIM/SPF
Campanie email
/api/v4/email/bulk Trimite campanii de marketing in masa
Evenimente email
/api/v4/email/events Rata de deschidere, click-uri, bounce-uri, dezabonari
Autentificare
/api/v4/auth/token Genereaza token JWT Bearer
Webhooks
/api/v4/webhooks/create Configureaza receptia evenimentelor in timp real
Widget Chat
/api/v4/iframes/whatsapp/chat-box Genereaza un iframe pentru chatul WhatsApp
Integreaza in limbajul tau
Exemple gata de utilizare pentru autentificare si trimiterea primului mesaj.
curl -X POST \
https://app.roxpay.eu/api/v4/auth/token \
-H "Content-Type: application/json" \
-d '{"username":"...","password":"..."}'
# Use the token:
curl -X POST \
.../whatsapp/chats/123/message \
-H "Authorization: Bearer <token>" \
-d '{"body":"Hello!"}' import requests
# Authentication
r = requests.post(
"https://app.roxpay.eu/api/v4/auth/token",
json={"username":"...", "password":"..."}
)
token = r.json()["token"]
# Send message
requests.post(
"...whatsapp/chats/123/message",
headers={"Authorization": f"Bearer {token}"},
json={"body": "Hello!"}
) // Authentication
const r = await fetch(
"https://app.roxpay.eu/api/v4/auth/token",
{ method: "POST",
headers: {"Content-Type":"application/json"},
body: JSON.stringify({username,password}) }
);
const { token } = await r.json();
// Send message
await fetch("...chats/123/message", {
method: "POST",
headers: { Authorization: `Bearer ${token}` },
body: JSON.stringify({ body: "Hello!" })
}); Sandbox si productie
Testeaza gratuit in mediul sandbox fara costuri, apoi treci la productie cu o singura schimbare de URL. Zero refactorizare.
Sandbox gratuit
Fara credite consumate. Mesaje simulate. Testare nelimitata fara configurare suplimentara.
Productie scalabila
Infrastructura enterprise cu SLA 99,9% si suport tehnic dedicat.
Comutare instantanee
Schimba doar URL-ul de baza pentru a trece de la sandbox la productie. Acelasi cod, acelasi contract API.
URL de baza
https://sandbox.roxpay.eu ✓ Mesaje simulate · ✓ Fara cost · ✓ Date de test
URL de baza
https://app.roxpay.eu ✓ Mesaje reale · ✓ SLA 99,9% · ✓ Suport dedicat
Documentatie completa disponibila
Toti parametrii, schemele de raspuns, codurile de eroare si exemplele interactive in interfata Swagger.