API Document
NOTES
- API - that is a protocol between your software and our service.
- API is needed in order to automate the process of receiving SMS messages on your side.
- All requests (supported by POST and GET) must go to http://vps.sms3t.com/stubs/handler_api.php .
- Our API the same like sms-activate.ru
- You can change your hosts to use it
- C:\Windows\System32\drivers\etc\
45.32.107.10 sms-activate.ru
- ATTENTION! If you replace host, there will be an https protocol error. To avoid it, send requests without https using http
- In all queries, there must be an API key in the form of the parameter "api_key"
Request the number of available phones
http://vps.sms3t.com/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country&operator=$operator

PARAMETERS

  • - API key
  • * - Country numbers (10: VietNam)
    • * optional field. If not specified, then by default the quantity will be displayed in accordance with the setting in the left menu.

  • * - Mobile operator numbers, you can specify several numbers separated by commas (available only for **):
    • * optional field. If not specified, then by default the quantity will be displayed in accordance with the setting in the left menu.

    • ** available for $country = 10

ANSWER

The response of the service will be in json format, example:

{"vk_0":149,"ok_0":190,"wa_0":64,"vi_0":140,"tg_0":86,"wb_0":14,"go_0":146,"av_0":251,"av_1":156,"fb_0":58}

Where to the dash - the name of the service, after the designation whether to turn on call redirection. 0 - do not turn on. 1 - turn on. The numbers with redirection, we unfortunately do not provide yet

Balance inquiry
http://vps.sms3t.com/stubs/handler_api.php?api_key=$api_key&action=getBalance

PARAMETERS

ANSWER

POSSIBLE MISTAKES

Order number
http://vps.sms3t.com/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&operator=$operator&ref=$ref&country=$country&phoneException=$phoneException

PARAMETERS

  • - API key
  • - Ordering service
  • * - Excluding prefixes for Russian numbers. Specify with commas. Recording format: country code and 3 to 6 digits of the mask (for example 7918,7900111). The default is the value set in the left menu.
    • * optional parameter accepts  0(not perform , set by default),  1(perform)

  • * - Mobile operator numbers, you can specify several numbers separated by commas (available only for **):
    • * optional field. If not specified, then by default the quantity will be displayed in accordance with the setting in the left menu.

    • ** available for $country = 10

  • - Pass referral identifier.
  • - Country numbers (10: VietNam)

By getting the number through the API, you agree with the project rules

ANSWER

POSSIBLE MISTAKES

Change of activation status
http://vps.sms3t.com/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id

PARAMETERS

  • - API key
  • - activationID
  • * - Phone number to be redirected to
    • * Mandatory only if the parameter forward = 1 was passed with getNumber.

  • * - Activation status
1report the readiness of the number (SMS to the number sent)
3request another code (free)
6complete activation*
8report the number used and cancel the activation

* complete activation (if the status was "code received" - marks successfully and finishes, if there was "preparation" - deletes and marks the error, if it was status "waiting for repetition" - translates activation into waiting for sms)

Simple logic of api chronology:

Get the number using the getNumber method after this, the following actions are available:
8 - Cancel the activation (if the number does not match you)
1 - Notify that SMS has been sent (optional)
To activation with status 1:
8 - Cancel activation
Immediately after receiving the code:
3 - Request another SMS
6 - Confirm SMS code and complete activation
To activation with status 3:
6 - Confirm SMS code and complete activation

ANSWER

POSSIBLE MISTAKES

Get activation status
http://vps.sms3t.com/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

PARAMETERS

ANSWER

POSSIBLE MISTAKES

Get current prices by country
http://vps.sms3t.com/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

PARAMETERS

  • - API key
  • - Short name of the service (optional, by default all services)
  • - Country code name (Optional, defaults to all countries)

ANSWER

JSON - object in the format:

{"A country":{"Service":{"cost":Cost,"count":Quant}}}
List of countries and operators
Id Name Operators
10 Vietnam any, mobifone, vietnamobile, viettel, vinaphone
List of services
Short name Name