Documentatie API

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
Inceput rapid

Integreaza in 3 pasi

De la zero la mesaje trimise in mai putin de 10 minute.

1

Obtine tokenul tau

Apeleaza endpoint-ul de autentificare cu credentialele tale pentru a obtine un token JWT de utilizat in toate cererile ulterioare.

POST /api/v4/auth/token
{"username":"...","password":"..."}
→ {"token": "eyJh..."}
2

Trimite primul mesaj

Foloseste tokenul in antetul Authorization si apeleaza endpoint-ul pentru a trimite un mesaj WhatsApp, SMS sau Email.

POST /whatsapp/chats/{id}/message
Authorization: Bearer <token>
→ {"status": "sent"}
3

Primeste evenimente

Configureaza un webhook pentru a primi mesaje primite, confirmari de livrare si actualizari de status in timp real.

POST /api/v4/webhooks/create
"url": "https://your-app.com/hook"
→ {"status": "active"}
Securitate

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.

POST /api/v4/auth/token
{
  "username": "your@email.com",
  "password": "your-password"
}
200 OK Response
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...",
  "expiresIn": 3600,
  "type": "Bearer"
}
Foloseste tokenul in fiecare cerere
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...
Endpoint-uri

Toate endpoint-urile disponibile

Fiecare endpoint este documentat cu parametri, raspunsuri si exemple in documentatia noastra OpenAPI.

WhatsApp
POST

Trimite mesaj

/api/v4/whatsapp/chats/{id}/message

Trimite un mesaj WhatsApp direct

GET

Lista sabloane

/api/v4/notifications/whatsapp/templates

Vizualizeaza sabloanele WhatsApp aprobate

POST

Notificare sablon

/api/v4/whatsapp/notifications

Trimite notificare individuala in afara ferestrei de 24h

POST

Trimitere in masa

/api/v4/whatsapp/bulk

Trimite catre mii de contacte intr-un singur lot

SMS
POST

Trimite SMS

/api/v4/sms/send

Trimite un SMS catre orice numar din lume

POST

Campanie SMS

/api/v4/sms/bulk

Trimitere in masa catre liste de contacte

GET

Raport de livrare

/api/v4/sms/reports/{id}

Verifica statusul de livrare

Email
POST

Trimite email

/api/v4/email/send

Email tranzactional cu DKIM/SPF

POST

Campanie email

/api/v4/email/bulk

Trimite campanii de marketing in masa

GET

Evenimente email

/api/v4/email/events

Rata de deschidere, click-uri, bounce-uri, dezabonari

Sistem
POST

Autentificare

/api/v4/auth/token

Genereaza token JWT Bearer

POST

Webhooks

/api/v4/webhooks/create

Configureaza receptia evenimentelor in timp real

POST

Widget Chat

/api/v4/iframes/whatsapp/chat-box

Genereaza un iframe pentru chatul WhatsApp

Exemple de cod

Integreaza in limbajul tau

Exemple gata de utilizare pentru autentificare si trimiterea primului mesaj.

cURL
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!"}'
Python
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!"}
)
Node.js
// 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!" })
});
Medii

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.

Sandbox

URL de baza

https://sandbox.roxpay.eu

✓ Mesaje simulate  ·  ✓ Fara cost  ·  ✓ Date de test

Productie

URL de baza

https://app.roxpay.eu

✓ Mesaje reale  ·  ✓ SLA 99,9%  ·  ✓ Suport dedicat

OpenAPI 3.0 - Swagger UI

Documentatie completa disponibila

Toti parametrii, schemele de raspuns, codurile de eroare si exemplele interactive in interfata Swagger.