Geliştiriciler

İlk günden daha net geliştirici dokümantasyonu

Düzenli bir deneyim içinde temiz Base URL, auth header, örnekler, webhooks ve hata kodları.

cURL PHP Laravel WordPress Node Axios Python Flutter Kotlin Java C# Go Ruby

      
cURL • PHP • Laravel • Node • Axios • Python • Flutter • Kotlin • Java • C# • Go • Ruby
1Base URL ve Access Token’ı kopyalayın

Platformada farklı yerler arasında dolaşmadan aynı sayfadan hızla başlayın.

2OTP veya işlem SMS’ini test edin

Doğru senaryoyu seçin ve ilk isteği cURL veya hazır kod parçalarıyla çalıştırın.

3Webhook’unuzu bağlayın

sent, delivered ve failed callback’lerini sisteminizde retries ve görünür deneme kaydıyla alın.

4Yürütmeyi panelden takip edin

Aynı deneyimden çıkmadan cihazları, kuyruk sağlığını ve mesaj durumunu izleyin.

Hızlı başlangıç

Start integration through three clear tracks

  • Müşteri panelinden bir Access Token oluşturun.
  • Android Relay’i eşleyin ve çevrimiçi göründüğünü doğrulayın.
  • İlk Send OTP veya Send SMS çağrısını yapın, ardından durum ve webhook’ları izleyin.
Request basics
  • Base URL https://sms.yebrax.com/api
  • Auth Header Bearer YOUR_ACCESS_TOKEN
  • Content-Type application/json
  • Relay Mode Kurulumunuza göre auto veya manual
Health & launch endpoints

Lightweight checks before go-live

Geliştirme veya CI sırasında hizmetin çalıştığını ve hesabın gerçek trafik için hazır olduğunu doğrulamak için iki hızlı endpoint kullanın.

GET /v1/healthToken olmadan genel sağlık kontrolü
GET /v1/launch/readinessHesap lansman-hazırlık raporunu döndürür ve account.read gerektirir
POST /v1/relay/app/pairUygulamayı Pairing Code veya QR payload ile eşleyin.
Örnek yanıtlar
message.accepted
{
  "ok": true,
  "request_id": "req_01H...",
  "status": "queued",
  "queued_at": "2026-03-14T12:30:00Z"
}
otp.sent
{
  "ok": true,
  "otp_id": "otp_01H...",
  "status": "sent",
  "expires_in_seconds": 300
}
message.status
{
  "ok": true,
  "request_id": "req_01H...",
  "status": "delivered",
  "device_name": "Relay Device 1",
  "attempts": 1
}
Hızlı rehberler
OpenAPI

Geliştirici ve operasyon ekibini aynı hizaya getirmek için OpenAPI dosyası ve Postman koleksiyonunu kullanın.

Webhook Retry

Önemli hatalar webhook’lar ve net bir yeniden deneme günlüğüyle sisteminize dönmelidir.

Go Live

İlk gerçek yayından önce health, readiness ve uygulama eşlemesini test edin.

Endpoint referansı

Clear cards instead of scattered docs

API

POST /api/v1/sms/send

Kuyruk üzerinden cihaz yönlendirmesi ve durum takibiyle işlem mesajı gönderin.

API

POST /v1/otp/send

OTP’yi amaç, dil ve net geçerlilik süresiyle gönderin.

API

POST /v1/otp/verify

Kodu doğrulayın ve sonucu success/failed/expired olarak net döndürün.

API

GET /v1/messages/status

request_id ile mesaj durumunu, denemeleri ve hata nedenlerini okuyun.

API

GET /v1/recipients

Kayıtlı alıcı dizinini okuyun ve ad veya numarayla arayın.

API

POST /v1/recipient-lists/queue

Tam listeyi kuyruğa alın; her numara ayrı bir kuyruk öğesine dönüşür.

Webhook olayları
  • message.sent Relay üzerinden başarıyla gönderildi.
  • message.failed Gönderim bir sebeple başarısız oldu.
  • otp.verified OTP doğrulaması başarılı oldu.
  • device.offline Cihaz çevrimdışı oldu.
Hata kodları

unauthorized

API anahtarı veya yetkilendirme başlığı geçersiz.

invalid_device

Cihaz erişilemiyor veya yönlendirme için geçersiz.

rate_limited

Gönderim limitleri veya güvenlik eşikleri aşıldı.

queue_blocked

Gönderim, kuyruk durumu veya politikalar nedeniyle geçici olarak engellendi.

subscription_expired

Abonelik süresi doldu ve yenilenmesi gerekiyor.

What kinds of apps fit this integration best?+

It fits login systems, stores, bookings, invoices, and operational alerts that need OTP or event-driven messaging, not mass marketing campaigns.

Do you provide examples in multiple languages?+

Yes. Ready-to-copy examples include cURL, PHP, Laravel, Node, Axios, Python, Flutter, Kotlin, Java, C#, Go, and Ruby.

Can I use it only for OTP?+

Yes. You can rely only on Send OTP and Verify OTP if your project needs verification without other messaging flows.

Does the Android device need to stay online?+

The device should preferably stay online with permissions and foreground service enabled so sending and status heartbeat continue normally.

Where should I start in practice?+

Start by creating the account, pairing the Android Relay, taking an access token, then running your first request from the ready examples before moving to webhooks and production.

After the docs

Move to pricing, create the account, or ask for quick support

Once the integration picture is clear, the next step is account setup, pricing, or a direct message to the team for a faster rollout.

WhatsApp WhatsApp