Reseller, SMM Panel & Bot API Motoru v1.0

OnaySIM Geliştirici & Bayi API Dokümantasyonu

Web panellerinize, SMS satış sitelerinize, Telegram/WhatsApp botlarınıza veya özel yazılımlarınıza OnaySIM altyapısını saniyeler içinde bağlayın. Evrensel Standart SMS Protokolü ve REST mimarisiyle %100 uyumludur.

Düşük Gecikme (<100ms) Standart Panel Uyumluluğu Atomik Bakiye Koruması
Sizin API Anahtarınız

API anahtarınızı görmek ve test istekleri atmak için giriş yapmalısınız.

Giriş Yap / Kayıt Ol

API Endpoint Adresleri

Tüm GET ve POST isteklerinizi aşağıdaki adreslere gönderebilirsiniz:

Standart Handler URL (Önerilen)
https://onaysim.com/api/v1/handler.php
Alternatif Standart Stub URL (Tak-Çalıştır)
https://onaysim.com/stubs/handler_api.php

Web Panellerine ve Bayilik Sistemlerine Bağlama

Yazılım geliştirmeden web panellerinize ve bayilik altyapılarınıza OnaySIM'i 1 dakikada entegre edin:

  1. Panelinizde Sağlayıcı / Provider Ekle sayfasına gidin.
  2. Protokol veya modül türü olarak Standart SMS API Protokolü seçin.
  3. API URL kısmına https://onaysim.com/api/v1/handler.php yazın.
  4. API Key kısmına profilinizdeki size özel OnaySIM anahtarınızı girip kaydedin.
  5. Tüm ülkeler, servisler ve toptan bayi fiyatları anında otomatik listelenecektir.

Hızlı Başlangıç & Kod Örnekleri

Favori programlama dilinizi seçerek test isteklerini hemen çalıştırabilirsiniz.

# 1. Bakiye Sorgulama
curl -X GET "https://onaysim.com/api/v1/handler.php?api_key=YOUR_API_KEY&action=getBalance"

# 2. WhatsApp (Türkiye) Numarası Satın Alma
curl -X GET "https://onaysim.com/api/v1/handler.php?api_key=YOUR_API_KEY&action=getNumber&service=wa&country=62"

# 3. Gelen SMS Kodunu Kontrol Etme (activation_id ile)
curl -X GET "https://onaysim.com/api/v1/handler.php?api_key=YOUR_API_KEY&action=getStatus&id=123456"

# 4. Numarayı İptal Etme & Bakiye İadesi Alma
curl -X GET "https://onaysim.com/api/v1/handler.php?api_key=YOUR_API_KEY&action=setStatus&id=123456&status=8"

API Parametre & Aksiyon Referansı

Tüm uç noktalar, parametreler ve standart dönüş kodları.

GET / POST action=getBalance
Hesap Bakiyesini Sorgular

Zorunlu Parametreler: api_key, action=getBalance

Opsiyonel: format=json

Dönüş: ACCESS_BALANCE:15.50 (JSON ise {"status":"ACCESS_BALANCE","balance":15.50,"currency":"USDT"})

GET / POST action=getPrices
Stok ve Güncel USDT Fiyatlarını Listeler

Zorunlu Parametreler: api_key, action=getPrices

Opsiyonel Filtreler: country=62, service=wa

Dönüş: JSON formatında ülke ve servis bazlı fiyat ve stok matrisi.

GET / POST action=getNumber
Sanal Numara Tahsis Eder

Parametreler: service (Örn: wa, tg, go, ig, tw, dr), country (Örn: 62=Türkiye, 12=ABD, 16=İngiltere), maxPrice (İsteğe bağlı tavan fiyat)

Başarılı Dönüş: ACCESS_NUMBER:AKTIVASYON_ID:TELEFON_NUMARASI

Hata Kodları: NO_BALANCE (Yetersiz bakiye), NO_NUMBERS (Stokta numara yok), BAD_SERVICE (Geçersiz servis)

GET / POST action=getStatus
SMS Kodunun Gelip Gelmediğini Sorgular

Parametreler: id (getNumber ile dönen aktivasyon ID)

Olası Dönüşler:

  • STATUS_WAIT_CODE: Kod henüz gelmedi, bekleniyor (3-5 saniye aralıklarla tekrar sorgulanmalıdır).
  • STATUS_OK:123456: SMS kodu başarıyla ulaştı! İki noktadan sonraki kısım gelen SMS kodudur.
  • STATUS_CANCEL: Numara iptal edildi veya 20 dakikalık süre dolduğu için otomatik kapatıldı ve bakiye iade edildi.
GET / POST action=setStatus
Siparişi İptal Eder veya Tamamlar

Parametreler: id (Aktivasyon ID), status (Durum kodu)

Status Kodları:

  • status=8: Numarayı iptal eder, sağlayıcıdan düşer ve harcanan tutarı anında kullanıcı bakiyesine %100 iade eder (ACCESS_CANCEL).
  • status=6: Aktivasyonu başarıyla tamamlandı olarak işaretler (ACCESS_ACTIVATION).
  • status=1: SMS'in telefona gönderildiğini ve hazır olunduğunu bildirir (ACCESS_READY).
  • status=3: İkinci bir SMS kodu talep eder (ACCESS_RETRY_GET).

Standart Hata Yanıtları

Hata Kodu Açıklama Çözüm Yolu
BAD_KEY Geçersiz veya eksik API anahtarı. Profilinizdeki güncel API anahtarınızı kontrol edin.
ERROR_IP_NOT_ALLOWED İstek atan sunucu IP adresi beyaz listede yer almıyor. Profil sayfasından IP kısıtlamasını güncelleyin veya kaldırın.
NO_BALANCE Kullanıcı bakiyesi bu numara alımı için yetersiz. USDT TRC-20 ile bakiye yükleyin.
NO_NUMBERS Seçilen ülke ve serviste anlık hat stoğu tükenmiş. Farklı bir ülke seçin veya 1-2 dakika sonra tekrar deneyin.
BAD_SERVICE Geçersiz servis kodu belirtilmiş. Desteklenen servis kodlarını kullanın (wa, tg, go vb.).
NO_ACTIVATION Belirtilen ID'ye ait aktivasyon kaydı bulunamadı. Sipariş ID değerinin size ait olduğunu doğrulayın.