Beş dakikada ilk OTP
SDK, curl veya MCP — hangisini seçersen seç aynı uç noktalar, aynı davranış.
TypeScript SDK
Tip güvenli istemci, otomatik retry ve idempotency anahtarı üretimi.
npm i @kolayotp/sdk
MCP sunucusu
AI ajanlarının OTP gönderip doğrulaması için hazır MCP entegrasyonu.
npx @kolayotp/mcp
OpenAPI
Kontrat testleriyle doğrulanan şema; istemci üretimi için hazır.
GET /api/v1/openapi.json
$ curl -X POST https://api.kolayotp.com/api/v1/otp/send \
-H "Authorization: Bearer kotp_live_..." \
-H "Content-Type: application/json" \
-H "idempotency-key: $(uuidgen)" \
-d '{"recipient":"+905551234567","locale":"tr"}'
{
"id": "otp_3kQ9fT2a",
"channel": "whatsapp",
"status": "sent",
"expires_at": "2026-09-11T09:51:00Z",
"attempts_left": 5
}import { KolayOTP } from "@kolayotp/sdk";
const kotp = new KolayOTP({ apiKey: process.env.KOTP_KEY });
const otp = await kotp.send({
recipient: "+905551234567",
locale: "tr",
// channel: "whatsapp" — omit to use routing config
});
const result = await kotp.verify({
id: otp.id,
code: "482913",
});
if (result.verified) {
// session.create(user)
}{
"mcpServers": {
"kolayotp": {
"command": "npx",
"args": ["-y", "@kolayotp/mcp"],
"env": {
"KOLAYOTP_API_KEY": "kotp_test_..."
}
}
}
}
# Tools exposed to the agent:
# otp_send otp_verify
# otp_resend otp_status
# balance_get| Uç nokta | İşlev | Not |
|---|---|---|
| POST /otp/send | Kod gönder | channel opsiyonel; routing devreye girer |
| POST /otp/verify | Kodu doğrula | 5 deneme, 10 dk TTL |
| POST /otp/resend | Tekrar gönder | Cooldown uygulanır, kanal değişebilir |
| GET /otp/{id} | Durum sorgula | Teslim ve doğrulama durumu |
| GET /balance | Bakiye | Kanal bazlı tüketim dahil |
SDK & MCP
TypeScript SDK ve MCP sunucusu aynı API uç noktalarını kullanır. MCP yapılandırması yukarıdaki sekmelerde.MCP demosu →
5 dakikada ilk OTP'ni gönder.
Kredi kartı gerekmez. Sandbox anahtarıyla başla, hazır olduğunda canlıya geç.