API und Integration

JSON-API unter /api/v1/…. Aktuelle Routen stehen in OpenAPI auf Ihrer Instanz. In den Beispielen ersetzen Sie YOUR_HOST durch Ihren Host.

Dokumentation

Interaktiv: /docs (falls aktiviert).
Schema: GET /api/v1/openapi.json.
Status: GET /health, GET /readiness, GET /api/v1/status.

Konventionen

HTTPS in Produktion.
Content-Type: application/json (außer Datei-Uploads bei Streitfällen).
Nach POST /api/v1/auth/login — Cookie und/oder Authorization: Bearer ….
Aktualisierung: POST /api/v1/auth/refresh.
Sensible Operationen können Idempotency-Key nutzen — siehe OpenAPI.

Hauptgruppen

Auth und Sitzungen: register, login, refresh, logout, MFA.
Profil und Wallet: /api/v1/me, /api/v1/wallet/balances, /api/v1/wallet/activity.
Treuhand (Escrow): create, list, fund, release, dispute.
Helpdesk: Tickets.
Vollständige Liste — in OpenAPI.

Integrationssupport

Fragen zu Zugang und Szenarien: Hilfe oder support@evopay.biz. Angemeldete Clients können Tickets über POST /api/v1/helpdesk/tickets erstellen.

Beispiele

json · Anfragekörper

{
  "email": "user@example.com",
  "password": "YourStrongPassw0rd!",
  "display_name": "Demo User"
}

bash · Registrierung

curl -sS -X POST "https://YOUR_HOST/api/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "YourStrongPassw0rd!",
    "display_name": "Demo User"
  }'

bash · Anmeldung

curl -sS -X POST "https://YOUR_HOST/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -c cookies.txt \
  -d '{
    "email": "user@example.com",
    "password": "YourStrongPassw0rd!"
  }'

bash · Profil und Wallet

curl -sS "https://YOUR_HOST/api/v1/me" -b cookies.txt

curl -sS "https://YOUR_HOST/api/v1/wallet/balances" -b cookies.txt

curl -sS "https://YOUR_HOST/api/v1/wallet/activity?limit=20" -b cookies.txt

bash · Treuhand erstellen

curl -sS -X POST "https://YOUR_HOST/api/v1/escrow" \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "title": "Gerätelieferung",
    "description": "Serverausrüstung laut Spezifikation",
    "amount": "8000.00",
    "currency": "USD"
  }'

Danach ESCROW_ID einsetzen:

bash · Treuhand-Lebenszyklus

curl -sS "https://YOUR_HOST/api/v1/escrow/contracts/ESCROW_ID" -b cookies.txt

curl -sS -X POST "https://YOUR_HOST/api/v1/escrow/ESCROW_ID/fund" \
  -H "Content-Type: application/json" -b cookies.txt -d '{}'

curl -sS -X POST "https://YOUR_HOST/api/v1/escrow/ESCROW_ID/release" \
  -H "Content-Type: application/json" -b cookies.txt -d '{}'

bash · Status

curl -sS "https://YOUR_HOST/api/v1/status"
curl -sS "https://YOUR_HOST/readiness"