API Dokümanları

# 1) API anahtarını al — Dashboard → API anahtarları
export WPOTP_KEY=wpotp_live_xxxxxxxxxxxxxxxxxxxxxxxx

# 2) Kullanılabilir sistem şablonlarını listele
curl https://api.wpotp.com/v1/templates \
  -H "Authorization: Bearer $WPOTP_KEY"

# 3) İlk OTP'ni gönder — kodu wpotp üretir
curl -X POST https://api.wpotp.com/v1/otp/send \
  -H "Authorization: Bearer $WPOTP_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "recipient": "+905551112233" }'

Authorization: Bearer wpotp_live_xxxxxxxxxxxxxxxxxxxxxxxx

// Tüm istekler HTTPS üzerinden; kimlik Authorization header'ı ile.
// API anahtarları Dashboard → API anahtarları'ndan oluşturulur ve
// yalnızca oluşturulurken bir kez gösterilir.
// Geçersiz veya iptal edilmiş anahtar → 401 unauthorized.

POST /v1/otp/send
{
  "recipient":  "+905551112233",  // E.164, zorunlu
  "templateId": "tpl_xxx",         // opsiyonel; yoksa varsayılan AUTH şablonu
  "code":       "482913",          // opsiyonel; kendi kodun (4-8 hane)
  "reference":  "order-9f3a2c"     // opsiyonel; kendi benzersiz anahtarın
}

// 201 Created
{
  "id":        "otp_a1b2c3",
  "status":    "SENT",
  "recipient": "+905551112233",
  "expiresAt": "2026-05-17T12:05:00.000Z"
}

POST /v1/otp/{id}/verify
{ "code": "482913" }

// 200 OK
{ "verified": true, "status": "VERIFIED" }

// 400 Bad Request — yanlış kod
{ "error": { "code": "INVALID_CODE", "message": "Invalid OTP code" } }

// OTP durumu her değiştiğinde sunucuna POST atarız.
POST https://app.acme.com/webhooks/wpotp
Content-Type: application/json
X-Wpotp-Event: otp.delivered
X-Wpotp-Signature: sha256=8a2f1e9c...b4f

{
  "id": "evt_7c1a",
  "event": "otp.delivered",
  "createdAt": "2026-05-17T12:00:00.000Z",
  "data": {
    "id": "otp_a1b2c3",
    "recipient": "+905551112233",
    "reference": "order-9f3a2c",
    "status": "DELIVERED",
    "templateId": "tpl_xxx"
  }
}

// Olaylar: otp.sent, otp.delivered, otp.read, otp.verified, otp.failed, otp.expired
// İmza: HMAC-SHA256(secret, ham gövde) — X-Wpotp-Signature ile doğrula.