API pengesahan SMS

API SNSSIM menguruskan pembelian nombor, pengesahan kod, pembatalan, semakan kredit dan harga dalam satu permintaan HTTP. Menggunakan kaedah handler_api yang standard industri, hanya perlu menukar alamat dan kunci API pada program sedia ada untuk sambungan segera.

GET /stubs/handler_api.php
  ?api_key=API_KEY&action=getNumber
  &service=telegram&country=gb

ACCESS_NUMBER:SS8Q2K7:447700900123

GET ...&action=getStatus&id=SS8Q2K7
STATUS_OK:48215
Kaedah standard industri
handler_api

Kaedah standard industri

Setiap kunci API
300 kali seminit

Setiap kunci API

Negara / Perkhidmatan
145 / 1,255

Negara / Perkhidmatan

Bayaran dikembalikan jika tiada kod
20 minit

Bayaran dikembalikan jika tiada kod

Bagaimana cara mendapatkan kunci API?

Hasilkan kunci API di menu API pada skrin akaun selepas log masuk. Kunci hanya dipaparkan sekali semasa penjanaan, simpan dengan segera. API menggunakan kredit dan harga yang sama dengan antara muka web.

Apakah alamat asas?

Semua permintaan dihantar melalui GET ke alamat yang sama dengan menambah api_key dan action.

https://snssim.com/stubs/handler_api.php?api_key=API_KEY&action=...

Permintaan apa yang boleh dihantar?

Terdapat 7 jenis permintaan yang tersedia, dari pembelian nombor hingga pengesahan kod, pembatalan dan semakan kredit.

actionFungsiContoh respons
getBalanceSemak bakiACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbHarga dan nombor tersedia mengikut perkhidmatan dan negara{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbPembelian nomborACCESS_NUMBER:ID:PHONE
getStatus&id=IDSemak kodSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Batal penggunaan nombor (bayaran penuh dikembalikan jika kod tidak diterima)ACCESS_CANCEL
setStatus&id=ID&status=3Dapatkan kod pengesahan tambahan ke nombor yang samaACCESS_RETRY_GET
setStatus&id=ID&status=6Tamatkan penggunaanACCESS_ACTIVATION

Medan permintaan

NamaWajibPenerangan
api_keySemuaKunci API yang dibuat di skrin akaun
actionSemuagetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberKod nama perkhidmatan (contoh: telegram, whatsapp, google). Nilai yang sama seperti pada halaman senarai perkhidmatan
countrygetNumberKod negara 2 huruf (contoh: gb, us, id)
idgetStatus, setStatusID nombor yang dikeluarkan oleh getNumber (bermula dengan N)
statussetStatus8 untuk batal, 3 untuk minta kod semula, 6 untuk tamat, 1 untuk sedia

Teks respons dan maksud

Respons diberikan dalam teks ringkas. Status potongan kredit juga dipaparkan.

ResponsMaksudWang
ACCESS_NUMBER:ID:PHONENombor telah diterimaHarga nombor ditolak
STATUS_WAIT_CODESedang menunggu kodKekal
STATUS_OK:CODEKod telah tibaPembayaran selesai
STATUS_WAIT_RETRY:CODEMenunggu kod pengesahan tambahan (termasuk kod sebelumnya)Tiada caj tambahan
STATUS_CANCELDibatalkan atau masa tamatDipulangkan jika tiada kod
ACCESS_CANCELDibatalkanBayaran balik penuh
ACCESS_RETRY_GETMenunggu penerimaan kod sekali lagi ke nombor yang samaTiada caj tambahan
ACCESS_ACTIVATIONPenggunaan nombor telah selesaiKekal
NO_BALANCETambah nilai baki dan terima serta-mertaTidak ditolak
NO_NUMBERSKami tidak dapat menyediakan nombor untuk negara ini buat masa iniTidak ditolak
NO_ACTIVATIONSAnda mempunyai 20 nombor terbukaTidak ditolak
EARLY_CANCEL_DENIEDPilih 'Selesai' (6) untuk nombor yang telah menerima kod pengesahan, bukan 'Batal'Kekal
BAD_KEYKunci API tidak sepadanTidak ditolak
BAD_SERVICE / BAD_COUNTRYKod perkhidmatan atau negara tidak tepatTidak ditolak
NO_ACTIVATIONID nombor tidak ditemuiKekal
TOO_MANY_REQUESTSMelebihi 300 permintaan seminitTidak ditolak

Apakah urutan menerima kod melalui API?

Ini adalah 4 langkah lengkap: menerima nombor, memasukkannya, mengesahkan kod dan menyelesaikan.

  1. 1 langkah

    Dapatkan nombor

    Pilih perkhidmatan dan negara yang diinginkan melalui getNumber untuk mendapatkan nombor.

    action=getNumber&service=telegram&country=gb
    > ACCESS_NUMBER:SS8Q2K7:447700900123
  2. 2 langkah

    Masukkan nombor

    Masukkan nombor yang dibeli pada halaman pendaftaran atau program.

    +44 7700 900123
  3. 3 langkah

    Semak kod

    Periksa status kod setiap 5 saat dengan memanggil getStatus.

    action=getStatus&id=SS8Q2K7
    > STATUS_OK:48215
  4. 4 langkah

    Selesai

    Setelah memasukkan kod, selesaikan dengan setStatus 6. Kod akan dipulangkan automatik jika tiada dalam 20 minit.

    action=setStatus&id=SS8Q2K7&status=6
    > ACCESS_ACTIVATION

Contoh mengikut bahasa

Ini adalah proses lengkap menerima nombor, menunggu kod dan menyelesaikan. Ketik tab untuk menukar bahasa.

import time, requests

BASE = "https://snssim.com/stubs/handler_api.php"
KEY = "API_KEY"

def call(**p):
    return requests.get(BASE, params={"api_key": KEY, **p}, timeout=30).text

r = call(action="getNumber", service="telegram", country="gb")
if not r.startswith("ACCESS_NUMBER"):
    raise SystemExit(r)
_, num_id, phone = r.split(":")
print("Number:", phone)

for _ in range(240):                      # 20 minutes
    s = call(action="getStatus", id=num_id)
    if s.startswith("STATUS_OK"):
        print("Code:", s.split(":")[1])
        call(action="setStatus", id=num_id, status=6)
        break
    time.sleep(5)

Soalan Lazim API

API menyediakan nombor untuk 1,255 perkhidmatan di 145 negara pada harga yang sama seperti antaramuka web.

Apakah itu API pengesahan SMS?
Fungsi untuk membeli nombor maya, mengesahkan kod dan membatalkan melalui permintaan HTTP dalam program. API SNSSIM menggunakan kaedah handler_api standard industri.
Bolehkah saya terus menggunakan program yang saya gunakan di laman pengesahan SMS lain?
Jika program anda menggunakan kaedah handler_api, anda boleh menyambung serta-merta dengan hanya menukar alamat asas dan kunci API.
Adakah terdapat bayaran berasingan untuk API?
Tiada perbezaan. API dan antara muka web menggunakan kredit dan harga yang sama.
Berapa kali permintaan dibenarkan?
Sehingga 300 permintaan seminit setiap kunci API. Melebihi had akan menyebabkan ralat TOO_MANY_REQUESTS tanpa potongan kredit.
Adakah nombor yang dibeli melalui API boleh dipulangkan?
Ya. Jika kod tidak tiba dalam 20 minit, nombor yang dibeli melalui API juga akan dipulangkan secara automatik sebagai kredit.
Di mana saya boleh membuat kunci API?
Buat kunci API di menu API pada skrin akaun selepas log masuk. Kunci hanya dipaparkan sekali semasa penjanaan, simpan dengan segera.

Cuba sambung sebaik sahaja mencipta kunci API

Selepas pendaftaran, isi kredit dan anda boleh menjana kunci API terus dari skrin akaun.

API pengesahan SMS | SNSSIM