API dokumentacio

Integralja a WhatsApp-ot, SMS-t es Emailt percek alatt

Egyszeru, dokumentalt, elesre kesz REST API v4. JWT auth, webhookok, tombegeskules es sok mas.

  • Biztonsgos JWT Bearer hitelesites
  • Valos ideju webhookok minden esemenyhez
  • Ingyenes sandbox, hitelkartya nem szukseges
  • Teljes OpenAPI 3.0 dokumentacio
Gyors kezdes

Integralja 3 lepesben

Nullarol az elso uzenetek kuldesiig kevesebb mint 10 perc alatt.

1

Token lekerdezese

Hivja meg a hitelesitesi endpontot a hitelesito adataival, hogy megkapja a JWT tokent, amelyet minden tovabbi keresben hasznalni fog.

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

Kuldje el az elso uzenetet

Hasznaljon tokent az Authorization fejlecben, es hivja meg az endpointot WhatsApp, SMS vagy Email uzenetek kuldesere.

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

Esemenyek fogadasa

Allitson be webhookot beerkező uzenetek, kozzeteli visszaigazolasok es allapotfrissitesek valos ideju fogadasahoz.

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

JWT Bearer hitelesites

Minden Chat API-API JWT tokeneket hasznalnak. Generaljon tokent egyetlen POST hivassal, es csatolja az Authorization fejlechoz minden keresben.

Konfiguralhato lejaras

A tokenek konfiguralhato ido utan lejamak. Automatikusan regeneraljon az API-n keresztul megszakitas nelkul.

HTTPS szukseges

Minden kommunikacio HTTPS-en tortenik TLS 1.2+ protokollal. Titkositatlan hivasok nem fogadhatoak el.

Biztonsgos hitelesito adatok

A felhasznalonev es jelszo csak egyszer cserelodik a token megszerzesere, amelyet API-hivasokban hasznal.

POST /api/v4/auth/token
{
  "username": "your@email.com",
  "password": "your-password"
}
200 OK Response
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...",
  "expiresIn": 3600,
  "type": "Bearer"
}
Hasznaljon tokent minden keresben
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...
Endpointok

Az osszes elerheto endpoint

Minden endpoint dokumentalva van parameterekkel, valasz-sematikakkal, hibakodokkal es peldakkal az OpenAPI dokumentacioba.

WhatsApp
POST

Uzenet kuldese

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

Kozvetlen WhatsApp uzenet kuldese

GET

Sablonok listaja

/api/v4/notifications/whatsapp/templates

Jovahagyott WhatsApp sablonok bongeszese

POST

Sablon ertesites

/api/v4/whatsapp/notifications

Egyedi ertesites kuldese a 24 oras ablakn kivul

POST

Tombeges kuldees

/api/v4/whatsapp/bulk

Kuldjon tobb ezer kontaktnak egyetlen kotegben

SMS
POST

SMS kuldese

/api/v4/sms/send

Kuldjon SMS-t barmely szamra a vilagon

POST

SMS kampany

/api/v4/sms/bulk

Tombeges kuldees kontakt listaknak

GET

Kozzeteli jelentes

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

Kozzeteli allapot ellenorzese

Email
POST

Email kuldese

/api/v4/email/send

Tranzakcios email DKIM/SPF-fel

POST

Email kampany

/api/v4/email/bulk

Marketing kampanyok tombeges kuldese

GET

Email esemenyek

/api/v4/email/events

Megnyitasi arany, kattintasok, visszapattanasok, leiratkozasok

Rendszer
POST

Hitelesites

/api/v4/auth/token

JWT Bearer token generalasa

POST

Webhookok

/api/v4/webhooks/create

Valos ideju esemenyfogadas konfiguracioja

POST

Chat widget

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

iframe generalasa a WhatsApp chathez

Kod-peldak

Integralja a sajat nyelvjevel

Hasznalatra kesz peldak a hitelesiteshez es az elso uzenet kuldeshez.

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!" })
});
Kornyezetek

Sandbox es eles

Tesztelje szabadon a sandbox kornyezetben koltseg nelkul, majd valsson eles kornyezetre egyetlen URL csere rel. Nulla refaktoras.

Ingyenes sandbox

Nincsen kreditfelhasznalasa. Szimulalt uzenetek. Korlat lan teszteles kiegeszito konfiguracio nelkul.

Skalazhato eles

Vallalati infrastruktura 99,9%-os SLA-val es dedikalt muszaki tamogatassal.

Azonnali atvaltas

Csak az alap URL-t valtoztassa meg a sandboxbol az elesre valo attereshez. Ugyanaz a kod, ugyanaz az API-szerzodes.

Sandbox

Alap URL

https://sandbox.roxpay.eu

✓ Szimulalt uzenetek  ·  ✓ Koltseeg nelkul  ·  ✓ Teszt adatok

Eles

Alap URL

https://app.roxpay.eu

✓ Valodi uzenetek  ·  ✓ 99,9% SLA  ·  ✓ Dedikalt tamogatas

OpenAPI 3.0 - Swagger UI

Teljes dokumentacio elerheto

Minden parameter, valasz-sematika, hibakod es interaktiv peldak a Swagger felhasznaloi felulletjen.