API Dökümanları

Her istekte key ve action gönderilir. Başarılı yanıtta status değeri success, hatalı yanıtta error olur; hatada code ve message döner.

Örnek istek

curl -X POST https://mail.premiumsms.net/api/v1 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=balance"

Örnek hata yanıtı

{
    "status": "error",
    "message": "API Key could not be validated",
    "code": 102
}

Tüm işlemlerde dönebilecek hatalar

Sipariş durumları

Hesabınızın güncel bakiyesini döner.

Parametreler

Örnek istek

curl -X POST https://mail.premiumsms.net/api/v1 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=balance"

Örnek yanıt

{
    "status": "success",
    "balance": 250.75,
    "currency": "TRY"
}

Siparişlerinizi en yeniden eskiye listeler (Siparişlerim ve Kiralanan Numaralar).

Parametreler

Örnek istek

curl -X POST https://mail.premiumsms.net/api/v1 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=orders" \
  -d "limit=20"

Örnek yanıt

{
    "status": "success",
    "currency": "TRY",
    "data": [
        {
            "id": 73,
            "type": "ACTIVATION",
            "service": 29,
            "service_name": "Tinder",
            "country": "US",
            "number": "12034653202",
            "status": "RECEIVED",
            "code": "609648",
            "charge": 19.07,
            "created_at": "2026-11-02 06:15:14",
            "end_date": null
        }
    ]
}

Hata kodları

Aktif ülkeler. Diğer işlemlerde ülke, cca2 koduyla gönderilir.

Aktif ülkeler ve CCA2 kodları (0)

Parametreler

Örnek istek

curl -X POST https://mail.premiumsms.net/api/v1 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=countries"

Örnek yanıt

{
    "status": "success",
    "countries": [
        {
            "name": "Türkiye",
            "common_name": "Turkey",
            "key": "turkey",
            "cca2": "TR"
        }
    ]
}

Sipariş alan operatörler. Numara alırken operator olarak operatörün id değeri gönderilir; fiyat ve stok operatöre göre değişir.

Aktif operatörler

Parametreler

Örnek istek

curl -X POST https://mail.premiumsms.net/api/v1 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=operators"

Örnek yanıt

{
    "status": "success",
    "operators": [
        {
            "id": 8,
            "name": "Operator - 1",
            "minutes": 20,
            "cancel_after": 2,
            "rebuy": true
        }
    ]
}

minutes: numaranın kullanım süresi (dakika). cancel_after: siparişten kaç dakika sonra iptal edilebileceği. rebuy: süresi dolan numaranın yeniden alınıp alınamayacağı.

Stoğu olan servisler; ülke ve operatöre göre fiyat (TRY) ve stok. Tüm liste büyüktür, ülke ile süzmeniz önerilir.

Aktif servisler ve servis ID'leri (0)

Parametreler

Örnek istek

curl -X POST https://mail.premiumsms.net/api/v1 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=services" \
  -d "country=TR"

Örnek yanıt

{
    "status": "success",
    "currency": "TRY",
    "data": {
        "TR": {
            "name": "Türkiye",
            "common_name": "Turkey",
            "key": "turkey",
            "operators": {
                "8": {
                    "name": "Operator - 1",
                    "services": {
                        "29": {
                            "name": "Tinder",
                            "charge": 22.44,
                            "quantity": 3697
                        }
                    }
                }
            }
        }
    }
}

Hata kodları

Bir servisin seçilen ülkedeki fiyatı ve stoğu. Operatör gönderilmezse tüm aktif operatörler döner.

Parametreler

Örnek istek

curl -X POST https://mail.premiumsms.net/api/v1 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=get_service" \
  -d "service=29" \
  -d "country=TR"

Örnek yanıt

{
    "status": "success",
    "service": {
        "id": 29,
        "name": "Tinder",
        "country": "TR",
        "operator": 8,
        "charge": 22.44,
        "quantity": 3697,
        "currency": "TRY"
    }
}

Operatör gönderilmezse charge ve quantity yerine data içinde operatör ID'sine göre name, charge, quantity döner.

Hata kodları

Tek kullanımlık numara satın alır, ücret bakiyeden düşülür. Gelen kodu status veya messages ile sorgulayın.

Parametreler

Örnek istek

curl -X POST https://mail.premiumsms.net/api/v1 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=get_number" \
  -d "service=29" \
  -d "country=TR" \
  -d "operator=8"

Örnek yanıt

{
    "status": "success",
    "data": {
        "id": 73,
        "service": 29,
        "country": "TR",
        "provider": 8,
        "number": "905321234567",
        "charge": 22.44,
        "currency": "TRY",
        "status": "PENDING"
    }
}

Hata kodları

Siparişin durumu, gelen kodlar ve bitiş zamanı. Tek kullanımlık siparişler sunucuda dakikada bir güncellenir.

Parametreler

Örnek istek

curl -X POST https://mail.premiumsms.net/api/v1 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=status" \
  -d "order=73"

Örnek yanıt

{
    "status": "success",
    "data": {
        "id": 73,
        "number": "905321234567",
        "type": "ACTIVATION",
        "status": "RECEIVED",
        "code": "609648",
        "codes": [
            "609648"
        ],
        "charge": 22.44,
        "currency": "TRY",
        "created_at": "2026-11-02 06:15:14",
        "end_date": "2026-11-02 06:35:14"
    }
}

Hata kodları

Siparişe gelen SMS'ler (eskiden yeniye). Sipariş ID veya numara ile sorgulanır; aynı numara birden fazla siparişteyse en yenisi kullanılır.

Parametreler

Örnek istek

curl -X POST https://mail.premiumsms.net/api/v1 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=messages" \
  -d "order=73"

Örnek yanıt

{
    "status": "success",
    "order": 73,
    "data": [
        "Tinder kodun: 609648"
    ],
    "messages": [
        {
            "text": "Tinder kodun: 609648",
            "code": "609648",
            "date": "2026-11-02 06:24:51"
        }
    ]
}

Hata kodları

SMS gelmemiş tek kullanımlık siparişi iptal eder, ücret bakiyeye iade edilir. Operatörün iptal bekleme süresi dolmadan iptal edilemez.

Parametreler

Örnek istek

curl -X POST https://mail.premiumsms.net/api/v1 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=cancel" \
  -d "order=73"

Örnek yanıt

{
    "status": "success",
    "data": {
        "id": 73,
        "status": "CANCELED",
        "refund": 22.44,
        "currency": "TRY"
    }
}

Hata kodları

Süresi dolup tamamlanan (FINISHED) siparişteki numarayı yeniden almanın ücretini döner. Ücret alınmaz.

Parametreler

Örnek istek

curl -X POST https://mail.premiumsms.net/api/v1 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=rebuy_price" \
  -d "order=73"

Örnek yanıt

{
    "status": "success",
    "data": {
        "order": 73,
        "number": "905321234567",
        "charge": 22.44,
        "currency": "TRY",
        "minutes": 20
    }
}

minutes: yeniden alınan numaranın kullanım süresi (dakika).

Hata kodları

Süresi dolup tamamlanan siparişteki numarayı yeniden satın alır; yeni bir sipariş açılır ve ücret bakiyeden düşülür.

Parametreler

Örnek istek

curl -X POST https://mail.premiumsms.net/api/v1 \
  -d "key=API_ANAHTARINIZ" \
  -d "action=rebuy" \
  -d "order=73"

Örnek yanıt

{
    "status": "success",
    "data": {
        "id": 74,
        "number": "905321234567",
        "charge": 22.44,
        "currency": "TRY",
        "status": "PENDING"
    }
}

Hata kodları