Geliştirici Portalı
v1.0

Onay360
Geliştirici API

SMS onay servisimizle projelerinizi dakikalar içinde entegre edin. Basit REST yapısı ve kapsamlı dokümantasyon ile hemen geliştirmeye başlayın.

API Key Al

Kimlik Doğrulama

API güvenliği Bearer Token standardı ile sağlanır. Tüm isteklerde Authorization başlığının gönderilmesi zorunludur.

Alternatif olarak, API anahtarınızı URL parametresi olarak da gönderebilirsiniz: ?key=YOUR_API_KEY

Güvenlik Uyarısı: API anahtarınızı asla istemci tarafında (frontend) veya herkese açık repolarda (GitHub vb.) paylaşmayın.

Header Yöntemi (Önerilen)

Authorization:Bearer YOUR_API_KEY
Content-Type:application/json

URL Parametre Yöntemi

https://onay360.com/api/v1/services?key=YOUR_API_KEY

Yanıt Formatı

Tüm API endpointleri tutarlı bir JSON yapısında yanıt döner. Bu sayede uygulamanızda yanıtları tek tip şekilde işleyebilirsiniz.

Yanıt Alanları

AlanTipAçıklama
successZorunlubooleanİsteğin başarılı olup olmadığını belirtir
requestIdZorunlustringİsteği takip etmek için benzersiz kimlik
timestampZorunlustringISO 8601 formatında yanıt zaman damgası
dataobjectYanıt verisi (başarılı isteklerde bulunur)
errorobjectHata kodu ve mesajı içeren detaylar (başarısız isteklerde bulunur)
JSON
{
  "success": true,
  "requestId": "c4f7d7f0-71f8-4e0d-9f71-87f26a3b3b21",
  "timestamp": "2026-03-28T10:15:30.000Z",
  "data": {
    "user": {
      "email": "user@example.com",
      "balance": 150.5,
      "currency": "TRY"
    }
  }
}

Kullanım Limitleri

Adil kullanım, platform kararlılığı ve hizmet sürekliliğini sağlamak amacıyla aşağıdaki koruma kuralları uygulanır.

IP Bazlı Limit

HTTP 503

Her bir IP adresi için saniyede en fazla 100 istek kabul edilir.

API Anahtarı Bazlı Limit

HTTP 429

Her bir API anahtarı için saniyede en fazla 100 istek kabul edilir.

Numara Satın Alma Endpoint Limiti

HTTP 503

Numara satın alma istekleri için saniyede en fazla 100 istek kabul edilir.

Geçici Erişim Kısıtlaması

10 dakikalık zaman aralığında 5 kez limit ihlali gerçekleşmesi durumunda erişim 10 dakika süreyle kısıtlanır.

GET/api/v1/user/profile

Kullanıcı Profili

Kullanıcı bakiyesini, hesap bilgilerini ve genel profil detaylarını getirir. API entegrasyonuna başlamadan önce hesap durumunuzu kontrol etmek için bu endpointi kullanabilirsiniz.

curl "https://onay360.com/api/v1/user/profile" \
  -H "Authorization: Bearer YOUR_API_KEY"
GET/api/v1/services

Servis Listesi

Mevcut tüm servisleri, desteklenen ülkeleri ve anlık fiyat bilgilerini listeler. Fiyatlar dinamik olarak değişebilir, bu nedenle işlem yapmadan önce kontrol etmeniz önerilir.

curl "https://onay360.com/api/v1/services" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST/api/v1/user/buy

Numara Satın Al

Belirtilen servis ve ülke için tek kullanımlık bir numara alır. İşlem başarılı olursa bakiye düşülür ve numara teslim edilir.

Parametreler

ParametreTipAçıklama
serviceZorunlustringServis kodu (örn: whatsapp)
countryZorunlustringÜlke kodu (örn: england)
curl -X POST "https://onay360.com/api/v1/user/buy" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service": "whatsapp", "country": "england"}'
GET/api/v1/user/orders/{id}

Sipariş Durumu

Aktif bir siparişin durumunu ve gelen SMS kodunu kontrol eder. SMS kodu geldiğinde sms_code alanı dolar ve status "COMPLETED" olur.

Parametreler

ParametreTipAçıklama
idZorunlustringSipariş ID
curl "https://onay360.com/api/v1/user/orders/58321" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST/api/v1/user/cancel

Sipariş İptali

Bekleyen siparişi iptal eder ve ücreti iade eder. SMS kodu gelmiş siparişler iptal edilemez.

Parametreler

ParametreTipAçıklama
idZorunlustringSipariş ID
curl -X POST "https://onay360.com/api/v1/user/cancel" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id": "58321"}'