Get-SMS自己的API

以下是我们的 API 工作原理的描述。 API 将允许您将您的软件解决方案与我们的服务集成,从而加快帐户验证过程并摆脱手动工作。

接收用户余额

对 url 的 GET 或 POST 请求:
https://get-sms.com/api/v1/?method=getbalance&userkey=testapikey
参数:
method = getbalance
userkey = YOUR_APIKEY

回应:
如果请求成功,则会返回 "status" 200 的 json。
"data" 对象中的 "balance" 键描述您的当前余额:
{
   "status": 200,
   "data": {
      "balance": 100,00
   }
}

错误代码 (status):
500 - 请求处理错误
401 - 未指定用户 API KEY 或 API KEY 不正确
404 - 方法参数不正确

获取服务列表和可用号码的数量

如果您需要系统上当前编号的服务列表,则应使用此方法。

对 url 的 GET 或 POST 请求:
https://get-sms.com/api/v1/?method=getcount&userkey=testapikey&country=kazakhstan
参数:
method = getcount
userkey = YOUR_APIKEY
country = kazakhstan 国家。可选参数。默认为哈萨克斯坦(哈萨克斯坦)。您可以在 " 中找到可能的国家/地区值的完整列表国家名单"部分

回应:
如果查询成功,则会返回 "status" 200 的 json。查询结果是一个具有两个键的对象:"status" 和 "data"。 "status" 键描述查询结果的特征。 "data" 键包含带有运算符键的对象。每个操作员键都有一个描述服务的对象。
每个服务对象都有两个键:"count" - 当前数量,"price" - 价格。
这种结构可以让您轻松获取所需信息。例如,在 PHP 中解码 json 后,您可以读取任意运营商的 WhatsApp 计数:$decoded_json['ANY']['wapp']['count']。
所有服务的代码都可以在服务列表部分中找到。
{
   "status": 200,
   "data": {
   // any operator
      "ANY": {
         "vk": {
            "count": 0,
            "price": "5"
         },
         "ok": {
            "count": 0,
            "price": "5"
         },
         "wapp": {
            "count": 1,
            "price": "2"
         },
         "vbr": {
            "count": 10,
            "price": "2"
         }
      }
      ...
      // Only Tele2
      "TELE2": {
         ...
      },
      // Only Beeline
      "BEELINE": {
         ...
      },
      // Only Megafon
      "MEGAFON": {
         ...
      },
      // Only MTS
      "MTS": {
         ...
      }
   }
}

如果查询执行期间发生错误,则会返回 "status" 500 的 json。该问题是由使用数据库时的错误引起的。
如果您在此请求中收到此错误,请联系 立即管理 Get-SMS 项目:
{
   "status": 500,
   "data": {
      "msg": "Failed to generate a service count"
   }
}
错误代码 (status):
500 - 请求处理错误
401 - 未指定用户 API KEY 或 API KEY 不正确
404 - 方法参数不正确

获取电话号码

整个项目的主要部分是发放用于激活的电话号码。在获得电话号码之前,您应该检查您的余额是否足够,以及系统中是否有免费号码。
一点题外话和信息。
电话号码发放后,我们会创建一个虚拟订单,让您在 15 分钟内收到来自发放号码的短信。在订单的生命周期内,我们会将您的部分余额转入储备金,这是为了避免在使用 API 的多流工作期间发生错误收费,以及防止用户在未收到短信的情况下退出订单。

对 url 的 GET 或 POST 请求:
https://get-sms.com/api/v1/?method=getnumber&service=vk&userkey=testapikey&country=kazakhstan
参数:
method = getnumber
service = vk 服务。强制参数。完整的服务值列表可以在 " 中找到服务清单"部分.
userkey = YOUR_APIKEY
country = kazakhstan 国家。可选参数。默认为哈萨克斯坦(哈萨克斯坦)。您可以在 " 中找到可能的国家/地区值的完整列表国家名单"部分

回应:
如果查询成功,它将检索一个 "status" 键等于 200 的 json。
"data" 键将有一个对象,其中键为 "order_id"(随后与电话号码配合使用的订单号),而 "phone" 键包含用于接收带有验证码的 SMS 消息的电话号码。
电话号码采用国际格式,包含国家/地区代码,不带 +标志。考虑到这一点。
{
   "status": 200,
   "data": {
      "order_id": "377253343",
      "phone": "79969817867",
      "start_time": "2023-02-23T13:11:57.373Z"
   }
}

我们可能暂时用完所订购服务的电话号码,那么"状态"将为 500:
{
   "status": 500,
   "data": {
      "msg": "No phone number was found for this request",
      "advice": "Please try to retrieve the phone number later, after new numbers become available"
   }
}
错误代码 (status):
401 - 未指定用户 API KEY
404 - 方法参数不正确
500 - 没有可用号码
502 - 该服务不存在
503 - 该运营商不存在
504 - 余额不足
505 - 该国家不存在
506 - 您已被临时封禁至次日
507 - 系统正在维护中

从短信中检索代码

最后的激活步骤是接收代码和全文消息以确认帐号。
接收短信的算法具体为:
1.发送短信请求,其中 order_id 键替换 getnumber 请求中的值。
2.如果"状态"为 200,则会收到短信。
3.如果"状态"为 400,则表示短信尚未到达或未找到,然后在 5 秒后重复步骤 1。
4.如果 "status" 为 500,则表示订单时间已过期。

如果我的订单已过期但未收到短信,我该怎么办?
这可能是由多种原因造成的:
- 订单服务尚未发送短信
- 短信搜索模板不是最新的
- 我们的操作过程中出现错误设备
- 您错误地输入了错误的电话号码。
在任何情况下,如果没有收到短信,都不会从您的帐户中扣款。
如果您确定该错误是由于我们的过错造成的。我们很乐意为您提供帮助 技术支持.

对 url 的 GET 或 POST 请求:
https://get-sms.com/api/v1/?method=getcode&order_id=377253343&userkey=testapikey
参数:
method = getcode
order_id = 377253343 订单号源自编号请求。所需值。
userkey = YOUR_APIKEY

回应:
成功执行查询后,将收到一个 json,其 "status" 键等于 200。
"data" 键将包含带有短信详细信息的对象:
code - 系统在短信中找到的代码。如果无法检测到,该代码可能为空
fullSms - 收到的全文消息
phone - 以国际格式发送短信的电话号码,不带 + 号
receivedDate - 收到 ISO 格式短信的日期
sender - 短信中指示的发件人。可以为空。
id - 错误代码方法的短信标识符(附加短信作为参数 "last_id")
phonePass - 服务提供商个人帐户的密码。可以留空。
{
   "status": 200,
   "data": {
      "code": "753455",
      "fullSms": "753455",
      "phone": "79969817867",
      "receivedDate": "2023-02-23T13:18:57.373Z",
      "sender": "",
      "id": "377253343",
      "phonePass": ""
   }
}

您还可以获得 "status" 400 的 json,这不是错误,而是当您的短信尚未到达时系统的自然响应。
要继续,您只需在 5 秒后重复代码请求即可。
必须重复该操作,直到您收到短信或出现错误,说明订单有效期已过(错误 500):
{
   "status": 400,
   "data": {
      "msg": "The SMS has not been found yet",
      "advice": "The SMS has probably not been received yet. Please try the request again in 10 seconds"
   }
}
错误代码 (status):
500 - 订单有效期已过
502 - 内部错误,请重试
504 - 余额不足
505 - 系统中未找到该订单
506 - 未指定 order_id 参数
401 - 未指定用户 API KEY
404 - 方法参数不正确

检索代码

在我们的项目中,您不必为每个代码付费,而是为特定服务的电话号码临时租用付费。实际上,您有 15 分钟的时间,在此期间您可以接收发送到所订购服务的电话号码的所有短信。
您在哪里需要此功能?例如,您注册了 Qiwi 钱包,需要接收短信以禁用 Qiwi 中的安全功能。为此,您会收到第一条短信,注册钱包,禁用 Qiwi 钱包中的安全功能,向我们发送错误的代码请求,然后我们会向您发送来自 Qiwi 的第二条短信完全免费。作为订单的一部分,您可以接收的附加短信数量没有限制。
警告!
您只能在订单有效期内(即收到电话号码后 15 分钟内)接收附加代码。

对 url 的 GET 或 POST 请求:
https://get-sms.com/api/v1/?method=wrongcode&order_id=377253343&userkey=testapikey&last_id=377253343
参数:
method = wrongcode
order_id = 377253343 订单号源自编号请求。所需值。
userkey = YOUR_APIKEY
last_id = 377253343 您通过 getcode 或之前的错误代码请求收到的最后一条短信的标识符。几乎总是与 order_id 相同,但也可能不同,请小心。所需值。

回应:
成功执行查询后,将收到一个 json,其 "status" 键等于 200。
"data" 键将包含带有短信详细信息的对象:
code - 系统在短信中找到的代码。如果无法检测到,该代码可能为空
fullSms - 收到的全文消息
phone - 以国际格式发送短信的电话号码,不带 + 号
receivedDate - 收到 ISO 格式短信的日期
sender - 短信中指示的发件人。可以为空。
id - 错误代码方法的短信标识符(附加短信作为参数 "last_id")
phonePass - 服务提供商个人帐户的密码。可以留空。
{
   "status": 200,
   "data": {
      "code": "753455",
      "fullSms": "753455",
      "phone": "79969817867",
      "receivedDate": "2023-02-23T13:18:57.373Z",
      "sender": "",
      "id": "377253343",
      "phonePass": ""
   }
}

您还可以获得 "status" 400 的 json,这不是错误,而是当您的短信尚未到达时系统的自然响应。
要继续,您只需在 5 秒后重复代码请求即可。
必须重复该操作,直到您收到短信或出现错误,说明订单有效期已过(错误 500):
{
   "status": 400,
   "data": {
      "msg": "The SMS has not been found yet",
      "advice": "The SMS has probably not been received yet. Please try the request again in 10 seconds"
   }
}
错误代码 (status):
500 - 订单有效期已过
501 - 方法参数不正确
502 - 内部错误,请重新发起请求
504 - 您尚未通过 getcode 方法收到第一条短信
505 - 系统中未找到该订单
506 - 未指定 order_id 参数
401 - 未指定用户 API KEY
404 - 方法参数错误

取消号码订单

如果您在此过程中收到了电话号码,但由于只有您知道的原因想要取消订单,则需要使用此拒绝号码方法执行取消电话号码的过程。

对 url 的 GET 或 POST 请求:
https://get-sms.com/api/v1/?method=refusenumber&order_id=377253343&userkey=testapikey
参数:
method = refusenumber
order_id = 377253343 订单号源自编号请求。所需值。
userkey = YOUR_APIKEY

回应:
如果查询成功,将检索 "status" 键设置为 200 的 json:
{
   "status": 200,
   "data": {
      "msg": "The phone number order has been canceled"
   }
}

如果您收到不同的消息,请参阅下面的错误代码。

错误代码 (status):
500 - 订单有效期已过
502 - 内部错误,请重试
506 - 未指定 order_id 参数
401 - 未指定用户 API KEY
404 - 方法参数错误

禁止电话号码

如果在账户注册过程中发现提供给您的电话号码不适合注册,建议您使用此封号方法来封禁您的电话号码。

对 url 的 GET 或 POST 请求:
https://get-sms.com/api/v1/?method=bannumber&order_id=377253343&userkey=testapikey
参数:
method = bannumber
order_id = 377253343 订单号源自编号请求。所需值。
userkey = YOUR_APIKEY

回应:
如果查询成功,将检索 "status" 键设置为 200 的 json:
{
   "status": 200,
   "data": {
      "msg": "The phone number is banned"
   }
}

如果您收到不同的消息,请参阅下面的错误代码。

错误代码 (status):
500 - 订单有效期已过
502 - 内部错误,请重试
506 - 未指定 order_id 参数
401 - 未指定用户 API KEY
404 - 方法参数错误

获取其中可用的国家和服务的所有值

我们的新方法允许您检索所有国家/地区的值以及每个国家/地区提供的所有服务。
此外,该方法还允许您指定特定服务并获取特定服务的所有国家/地区的数量和价格。

对 url 的 GET 或 POST 请求:
https://get-sms.com/api/v1/?method=getallcount&service=tg&userkey=testapikey
参数:
method = getallcount
service = tg 可选参数。如果未指定,该方法将返回所有国家和所有服务
userkey = YOUR_APIKEY

回应:
如果请求成功,会得到一个不带service参数的json:
{
 "kazakhstan": [
  {
   "vk": {
    "name": "VK",
    "price": "62.3",
    "count_all": "3712"
   },
   "wa": {
    "name": "Whatsapp",
    "price": "195",
    "count_all": "3740"
   },
   "vi": {
    "name": "Viber",
    "price": "6.55",
    "count_all": "3876"
   },
   "tg": {
    "name": "Telegram",
    "price": "209.49",
    "count_all": "3861"
   },
   "ask": {
    "name": "SVOE",
    "price": "8.98",
    "count_all": "3525"
   }
  }
 ],
 "england": [
  {
   "vk": {
    "name": "VK",
    "price": "2.28",
    "count_all": "3909"
   },
   "ok": {
    "name": "Ok.ru",
    "price": "38.2",
    "count_all": "4026"
   },
   "atp": {
    "name": "Vonage",
    "price": "2.13",
    "count_all": "3979"
   }
  }
 ],
 ...
}
或:
如果请求成功,将会获取到带有service参数的json:
{
   "kazakhstan": {
      "price": "214.15",
      "count_all": "4036"
   },
   "england": {
      "price": "98.67",
      "count_all": "3654"
   },
   "canada": {
      "price": "28.57",
      "count_all": "3970"
   },
   "germany": {
      "price": "295.73",
      "count_all": "1499"
   },
   "ssha": {
      "price": "41.03",
      "count_all": "4459"
   },
   "brazil": {
      "price": "178.28",
      "count_all": "4157"
   },
   ...
}

如果您收到不同的消息,请参阅下面的错误代码。

错误代码 (status):
502 - 内部错误,请重新发起请求
401 - 未指定用户 API KEY
404 - 方法参数设置不正确

与其他激活服务兼容的API

如果您选择与其他激活服务兼容而不重写您的软件,则可以使用我们的兼容 API。但我们强烈建议您不要这样做,因为它尚未更新或得到适当的支持。
要开始使用我们的兼容 API,您需要做的第一件事是在 Windows 中输入主机文件,该文件可在以下地址
C:\Windows\System32\drivers\etc\
并向其中添加以下行:
5.253.63.28 domain.com(其他激活服务)

如果您不想在主机文件中放置任何内容,请将软件中的域从其他激活服务的域更改为 get-sms.com。您的请求地址应采用以下形式:
https://get-sms.com/stubs/handler_api.php
您可以通过 POST 或 GET 方式发送所有请求。
请注意,目前还没有呼叫转接功能!而且很可能不会出现在这个版本的 API 中!
否则我们所有兼容的 API 都是完全相同的!因此我们决定只复制说明,以免增加和误导我们的用户。

请求可用号码的数量(getNumbersStatus)

对 url 的 GET 或 POST 请求:
https://get-sms.com/stubs/handler_api.php?action=getNumbersStatus&api_key=testapikey&country=2
参数:
action = getNumbersStatus
api_key = YOUR_APIKEY
country = 2 国家。可选参数。默认值为 2(哈萨克斯坦)。您可以在 " 中找到可能的国家/地区值的完整列表国家名单"部分

回应:
如果查询成功,您将收到以下类型的 json:
{
   "vk_0": 28,
   "ok_0": 4,
   "wa_0": 9,
   "vi_0": 19,
   "tg_0": 30,
   "wb_0": 21,
   "go_0": 30,
   "av_0": 8,
   "av_0": 23,
   "fb_0": 24
}

余额请求(getBalance)

对 url 的 GET 或 POST 请求:
https://get-sms.com/stubs/handler_api.php?action=getBalance&api_key=testapikey
参数:
action = getBalance
api_key = YOUR_APIKEY

回应:
如果查询成功,您将收到以下类型的 TEXT:
ACCESS_BALANCE:100 // 其中 100 是您当前的美元余额

可能的错误:
BAD_KEY - Invalid API key
ERROR_SQL - SQL server error

订购电话号码 (getNumber)

对 url 的 GET 或 POST 请求:
https://get-sms.com/stubs/handler_api.php?action=getNumber&service=vk&country=2&api_key=testapikey
参数:
action = getNumber
service = vk 服务。强制参数。完整的服务值列表可以在 " 中找到服务清单"部分. 
maxPrice = 25 Optional. The maximum price in your account currency you agree to pay for the number. Without it the number is sold only at the lowest available price; with it, when no numbers are available at the lowest price, more expensive offers are tried automatically up to maxPrice. You are charged the actual price of the sold number, never more than maxPrice. Available price levels: getPrices with tiers=1.
country = 2 国家。可选参数。默认值为 2(哈萨克斯坦)。您可以在 " 中找到可能的国家/地区值的完整列表国家名单"部分
api_key = YOUR_APIKEY

回应:
如果查询成功,您将收到此类型的文本,其中 $id 是交易 ID,$number 是电话号码:
ACCESS_NUMBER:$id:$number
其他回应:
NO_NUMBERS - 没有可用的号码
NO_BALANCE - 没有余额
WRONG_MAX_PRICE:$minPrice - maxPrice is lower than the minimum available price (the minimum available price is returned after the colon)

可能的错误:
BAD_ACTION - invalid action
BAD_SERVICE - invalid service name
WRONG_SERVICE - The service is not in the system
BAD_KEY - Invalid API key
ERROR_SQL - SQL server error
YOU_TEMPORARY_BANNED - You are banned until the next day

更改激活状态(setStatus)

对 url 的 GET 或 POST 请求:
https://get-sms.com/stubs/handler_api.php?action=setStatus&status=1&id=1234567&api_key=testapikey
参数:
action = setStatus
status = STATUS CODE 下面列出了可能的状态代码
id = OPERATION ID 从 getNumber 请求收到的订单 ID
api_key = YOUR_APIKEY

可能的状态:
1 通知该号码已准备好(发送短信到该号码)
3 请求另一个代码(免费)
6 完全激活 如果状态为“代码已收到”,请将其标记为成功且完成。如果状态为“正在准备”,请将其删除并将其标记为错误。如果状态为“等待重试”,请将激活更改为“等待短信”。
8 报告该号码已被使用并取消激活。

回应:
如果请求成功,您将收到文本,具体取决于状态:
ACCESS_READY - the readiness of the number has been confirmed
ACCESS_RETRY_GET - waiting for a new SMS
ACCESS_ACTIVATION - service successfully activated
ACCESS_CANCEL - 激活已取消

可能的错误:
BAD_ACTION - invalid action
NO_ACTIVATION - activation id does not exist
BAD_STATUS - Incorrect status
BAD_KEY - Invalid API key
ERROR_SQL - SQL server error

获取激活状态(getStatus)

对 url 的 GET 或 POST 请求:
https://get-sms.com/stubs/handler_api.php?action=getStatus&id=1234567&api_key=testapikey
参数:
action = getStatus
id = OPERATION ID 从 getNumber 请求收到的订单 ID
api_key = YOUR_APIKEY

回应:
如果请求成功,您将收到文本,具体取决于状态:
STATUS_WAIT_CODE - 等待短信
STATUS_WAIT_RETRY:'The previous code that did not work' - 等待代码的进一步说明
STATUS_WAIT_RESEND - 等待短信重新发送(软件应按重新发送短信并将状态更改为 6)
STATUS_CANCEL - 激活已取消
STATUS_OK: 'activation code' - 收到代码

可能的错误:
BAD_ACTION - invalid action
NO_ACTIVATION - activation id does not exist
NO_BALANCE - insufficient balance
BAD_KEY - Invalid API key
ERROR_SQL - SQL server error

获取所有服务价格 (getPrices)

对 url 的 GET 或 POST 请求:
https://get-sms.com/stubs/handler_api.php?action=getPrices&api_key=testapikey&service=SERVICE&country=2
参数:
action = getPrices
service = vk 服务。可选参数。完整的服务值列表可以在 " 中找到服务清单"部分.
api_key = YOUR_APIKEY
tiers = 1 Optional. With tiers=1 the response contains all available price levels for each service (several "price": count pairs sorted by price) instead of a single minimum price. Use these prices as maxPrice in getNumber.
country = 2 国家。强制参数。默认值为 2(哈萨克斯坦)。您可以在 " 中找到可能的国家/地区值的完整列表国家名单"部分

回应:
如果查询成功,您将收到以下类型的 json:
{
 "0": {
    "vk": {
        "25": 36
    },
    "lb": {
        "25": 169
    },
    "wa": {
        "51": 178
    },
    "vi": {
        "2.96": 0
    },
    "tg": {
        "38.8": 0
    },
    "wb": {
        "6.56": 3580
    },
    "go": {
        "7.87": 4433
    },
    "av": {
        "6.69": 3595
    },
    "fb": {
        "3.94": 3932
    },
    "qw": {
        "20": 3759
    }
  }
}
层次结构采用以下形式 - { "国家/地区": { "服务": { "价格": { "数量"}}}

tiers=1 — response example (all available price levels per service):
{
"2": {
"tg": {
"38.8": 120,
"45.5": 340,
"52": 1210
},
"vk": {
"25": 36
}
}
}

电话号码长期租用API

本节介绍如何使用 API 来租用电话号码。 API 可让您将您的软件解决方案与我们的服务集成。
如果您有任何疑问,可以随时联系支持人员。

API 服务器接受 POST 和 GET 请求
请求将发送到以下地址 - https://get-sms.com/api/v2/rent/rent_number.php

获取可用电话号码、服务和租赁价格的数量

对 url 的 GET 或 POST 请求:
https://get-sms.com/api/v2/rent/rent_number.php?method=getdatacountry&country=KZ
参数:
method = getdatacountry
country = KZ 国家。必需的参数。可以从请求 " 获取可能的国家/地区值的完整列表请求检索所有国家"

回应:
如果请求成功,将返回 "status" 键等于 200 的 JSON 响应。
"data" 键将包含一个包含服务、价格、可用电话号码数量和运营商的对象:
1xbet(示例) - 由服务代码名称键入的对象,包含可用于租赁的电话号码数量和特定期间的租赁价格
qty - 数量可用的电话号码
price_day - 1 天号码租赁的价格
operators - 可用的运营商
{
   "status": 200,
   "data": {
      "country": {
      "code": "KZ",
      "name": "Kazakhstan",
      "icon": "/uploads/country_img/Kazakhstan.png",
      "available_numbers": 6714
  },
  "operators": [
    {
      "id": "49",
      "name": "Aktiv_Kazakhstan",
      "codename": "Aktiv_Kazakhstan"
    }
  ],
  "services": [
    {
      "id": 1,
      "name": "1xbet",
      "img": "/uploads/service_img/1xbet.png",
      "price_day": 69.72,
      "qty": 57
    },
    ...
    ]
  }
}

获取租赁电话号码

创建电话号码租赁后,不提供任何退款,包括如果您改变决定、拒绝使用该号码或出于与技术上无法提供服务无关的其他原因。

对 url 的 GET 或 POST 请求:
https://get-sms.com/api/v2/rent/rent_number.php?userkey=testapikey&method=createorder&type=week&period=1&services=82,1,4&country=KZ&operator=ANY
参数:
method = createorder
userkey = YOUR_APIKEY
type = week必需的参数。周期类型:周(week)或月(month)。
period = 1 周数或月数。必需的参数。值 1 和周期类型 week 表示我们要租用电话号码 1 周。
services = 82,1,4 服务(ID 为 82、1 和 4)。必需的参数。服务值的完整列表可以在 " 中找到租赁服务一览".
country = KZ Country. Required parameter. A full list of possible country values can be obtained from the "租赁国家列表"
operator = ANY 移动运营商。可选参数。运营商列表可以从请求国家列表或服务列表中获取


回应:
如果请求成功,将返回 "status" 键等于 200 的 JSON 响应。
"data" 键将包含一个对象,其中包含 "order_id" 键(用于后续处理电话号码的订单号)和 "phone" 键(包含用于接收带有验证码的 SMS 消息的电话号码)。
电话号码以国际格式发布,带有国家/地区代码,不带国家/地区代码+ 符号。请考虑这一点。

为方便起见,时间间隔以 UNIX 时间戳形式提供,并采用标准 24 小时格式:
end_time_timestamp - 租用期结束之前的 UNIX 时间戳
end_time - 电话号码租用结束时的日期和时间
start_timestamp - 号码租用开始时的日期和时间(UNIX 时间戳)
{
   "status": 200,
   "data": {
      "order_id": 123,
      "country_code": "+7",
      "phone": "79991234567",
      "end_time_timestamp": 1771234567,
      "end_time": "18.02.2026 14:30",
      "start_timestamp": 1768642567,
      "orders_count": 1,
      "order_ids": [123]
   }
}
错误代码 (status):
401 - userkey 参数错误
402 - country 参数错误
404 - 未找到该国家
502 - services 参数错误
504 - 周期类型不正确
506 - 周/月类型的周期数不正确
504 - 无法获取服务器响应
503 - 服务器内部错误,请稍后再试
507 - 系统正在维护中

检索租用号码上的所有短信

对 url 的 GET 或 POST 请求:
https://get-sms.com/api/v2/rent/rent_number.php?method=getsms&userkey=testapikey&rentid=888
参数:
method = getsms
userkey = YOUR_APIKEY
rentid= 888 必需的参数。从获取租赁号码的请求中收到的订单 ID。该参数也可以在检索所有活跃订单的请求中找到。

回应:
如果请求成功,将返回 "status" 键等于 200 的 JSON 响应。
"data" 键将包含一个带有 "sms_list" 键的对象,该对象包含通过该电话号码收到的所有 SMS 消息。

{
   "status": 200,
   "data": {
     "msg": "List of all SMS messages",
     "sms_list": [
       {
         "date": "2026-05-21 14:30:00",
         "text": "Your code: 123456",
         "timestamp": 1779363000
       },
       {
         "date": "2026-05-21 14:35:00",
         "text": "Your code: 45345345",
         "timestamp": 1779363500
       }
     ]
  }
}

您还可以收到 "status" 200 的 JSON 响应。这不是错误;而是错误。这是租赁到期时的正常系统响应。
{
   "status": 200,
   "data": {
      "msg": "Rent is not active, SMS refresh was skipped",
      "can_reload_sms": false,
      "status_rent": 0,
      "sms_list": []
   }
}
错误代码 (status):
401 - 未指定用户 API KEY
404 - 未找到该租用订单
504 - 无法获取服务器响应
502 - 未指定租用 ID

延长租赁订单

对 url 的 GET 或 POST 请求:
https://get-sms.com/api/v2/rent/rent_number.php?userkey=testapikey&method=prolong&type=week&period=1&rentid=888
参数:
method = prolong
userkey = YOUR_APIKEY
type = week Required parameter. Period type: week (weeks) or month (month).
period = 1 周数或月数。必需的参数。值 1 和周期类型 week 表示我们要将电话号码延长 1 周。
rentid= 888 必需的参数。从获取租赁号码的请求中收到的订单 ID。该参数也可以在检索所有活跃订单的请求中找到。

回应:
如果请求成功,将返回 "status" 键等于 200 的 JSON 响应。这意味着号码扩展已成功完成。

{
   "status": 200,
   "data": {
      "msg": "Rental successfully extended",
      "order_id": 888,
      "days": 7,
      "price": 350,
      "rent_at": 1779967800,
      "rent_at_formatted": "2026-05-28 14:30:00"
   }
}

错误代码 (status):
401 - userkey 参数错误
504 - 周期类型不正确
506 - 周/月类型的周期数不正确
504 - 无法获取服务器响应
503 - 服务器内部错误,请稍后再试
507 - 系统正在维护中

检索所有出租国家

对 url 的 GET 或 POST 请求:
https://get-sms.com/api/v2/rent/rent_number.php?method=countries
参数:
method = countries

回应:
如果请求成功,将返回 "status" 键等于 200 的 JSON 响应,其中包含所有可用国家/地区及其移动运营商的列表

{
 "status": 200,
   "data": {
     "countries": [
       {
       "code": "AT",
       "name": "Austria",
       "available_numbers": 93,
       "operators": [
         {
         "id": 30,
         "name": "Tele2",
         "codename": "Tele2_AT",
         "available_numbers": 93
       }
     ]
   },
   {
       "code": "AR",
       "name": "Argentina",
       "available_numbers": 3969,
       "operators": [
         {
         "id": 25,
         "name": "Claro",
         "codename": "Claro_AR",
         "available_numbers": 3969
         }
       ]
     },
   {
       "code": "BE",
       "name": "Belgium",
       "available_numbers": 2363,
       "operators": [
         {
         "id": 69,
         "name": "Lycamobile",
         "codename": "Lycamobile_BE",
         "available_numbers": 2363
       }
     ]
    }
  ],
  "count": 33
 }
}

检索所有租赁订单

对 url 的 GET 或 POST 请求:
https://get-sms.com/api/v2/rent/rent_number.php?userkey=testapikey&method=allorders
参数:
method = allorders
userkey = YOUR_APIKEY

回应:
如果请求成功,将返回一个 JSON 响应,其中包含所有订购的租赁号码的数组,包括已取消或已完成租赁的号码。
status 键的含义:
status = 0 号码租赁期已过期
status = 1 租赁已激活

{
 "status": 200,
 "data": {
    "msg": "List of all orders",
    "orders": [
       {
       "id": 123,
       "phone": "77991234567",
       "number_phone": "77991234567",
       "status_rent": 1,
       "status_label": "Active",
       "can_reload_sms": true,
       "service_name": "Telegram",
       "country_code": "KZ",
       "country_name": "Kazakhstan",
       "code_country_phone": "+7",
       "operator": "Aktiv_KZ",
       "price_day": 50,
       "total_price": 350,
       "period_price": 7,
       "rent_from": 1779363000,
       "rent_at": 1779967800,
       "date_from": "2026-05-21 14:30:00",
       "date_at": "2026-05-28 14:30:00",
       "userkey": "USERKEY"
     }
   ],
   "count": 1
   }
}
如果没有租用的号码,您将收到一个空数组:
{
   "status": 200,
   "data": {
      "msg": "List of all orders",
      "orders": [],
      "count": 0
   }
}

国家名单

价值 名称 兼容API值
kazakhstan Kazakhstan 2
england England 16
canada Canada 36
germany Germany 43
usavirt USA (Virtual) 12
brazil Brazil 73
estonia Estonia 34
france France 78
indonesia Indonesia 6
kyrgyzstan Kyrgyzstan 11
laos Laos 25
lithuania Lithuania 44
netherlands Netherlands 48
poland Poland 15
romania Romania 32
sweden Sweden 46
indiia India 22
malaiziia Malaysia 7
vetnam Vietnam 10
filippiny Philippines 4
turtsiia Turkey 62
moldova Moldova 85
uzbekistan Uzbekistan 40
gruziia Georgia 128
irlandiia Ireland 23
portugaliia Portugal 117
ispaniia Spain 56
chekhiia Czech Republic 63
bangladesh Bangladesh 60
ssha USA 187
ukr Ukraine 1
gonkong Hong Kong 14
tailand Thailand 52
meksika Mexico 54
latviia Latvia 49
pakistan Pakistan 66
gretsiia Greece 129
nikaragua Nicaragua 90
argentina Argentina 39
gaiti Haiti 26
mongoliia Mongolia 72
izrail Israel 13
egipet Egypt 21
gvatemala Guatemala 94
liviia Libya 102
iran Iran 57
iemen Yemen 30
tadzhikistan Tajikistan 143
kitai China 3
shrilanka Sri Lanka 64
siriia Syria 110
livan Lebanon 153
boliviia Bolivia 92
serbiia Serbia 29
kolumbiia Colombia 33
avstriia Austria 50
alzhir Algeria 58
peru Peru 65
gonduras Honduras 88
marokko Morocco 37
venesuela Venezuela 70
nigeriia Nigeria 19
iamaika Jamaica 103
salvador Salvador 101
botsvana Botswana 123
paragvai Paraguay 87
nepal Nepal 81
uganda Uganda 75
irak Iraq 47
iordaniia Jordan 116
mianma Myanmar 5
demkongo Dem.Congo 18
keniia Kenya 8
kambodzha Cambodia 24
belarus Belarus 51
kotdivuar Ivory Coast 27
saudaraviia Saud. Arabia 53
oae UAE 95
khorvatiia Croatia 45
papuanovaiagvineia Papua New Guinea 79
tanzaniia Tanzania 9
gvineia Guinea 68
mali Mali 69
kamerun Cameroon 41
mavritaniia Mauritania 114
serraleone Sierra Leone 115
burkinafaso Burkina Faso 152
daniia Denmark 172
tunis Tunisia 89
dominikanskaiarespublika Dominican Republic 109
iuzhnaiaafrika South Africa 31
ekvador Ecuador 105
liberiia Liberia 135
senegal Senegal 61
afganistan Afghanistan 74
novaiazelandiia New Zealand 67
chad Chad 42
angola Angola 76
gana Ghana 38
iuzhnaiakoreia South Korea 190
sudan Sudan 98
taivan Taiwan 55
zimbabve Zimbabwe 96
turkmenistan Turkmenistan 161
reiunon Reunion 146
kipr Cyprus 77
gaiana Guyana 131
maldivy Maldives 159
mozambik Mozambique 80
gambiia Gambia 28
trinidaditobago Trinidad and Tobago 104
gabon Gabon 154
brunei Brunei 121
butan Bhutan 158
surinam Suriname 142
armeniia Armenia 148
benin Benin 120
mavrikii Mauritius 157
fidzhi Fiji 189
kongo Congo 150
dominika Dominica 126
bermudy Bermuda 195
aruba Aruba 179
chili Chili 151
finliandiia Finland 163
italiia Italy 86
bolgariia Bulgaria 83
vengriia Hungary 84
sloveniia Slovenia 59
khorvatiia Croatia 45
norvegiia Norway 174

服务清单

价值 名称
ai CELEBe
do Leboncoin
dh EBay
sk Skroutz
lq Potato
mh Ashan
wv AIS
ia Socios
bf Keybase
mm Microsoft
qd Taobao
at Perfluence
qf RedBook
dp ProtonMail
mi Zupee
yb Quartet+
wa Whatsapp
uz OffGamers
ou Gabi
he Mewt
jj Aitu
ez GoerliFaucet
ts PayPal
ta Wink
qt MoneyControl
ef Nextdoor
ad Iti
cg Gemgala
nu Stripe
rf Akudo
kj YAPPY
ul Getir
nv Naver
fw 99acres
ud Disney Hotstar
lw MrGreen
io ZdravCity
oy CashFly
qm RosaKhutor
mn RRSA
dt Delivery Club
lt BitClout
ui RuTube
qw Qiwi
fj Potato Chat
tx Bolt
kc Vinted
xd Tokopedia
pp Huya
qj Whoosh
qh Oriflame
jt TurkiyePetrolleri
ok Ok.ru
wk Mobile01
bn Alfagift
wh TanTan
vm OkCupid
ri BillMill
bs TradeUP
tw Twitter
ey Miloan
je Nanovest
hr JKF
kn Verse
yf Citymobil
aj OneAset
bx Dosi
ca SuperS
gr Astropay
rv Kotak811
bp GoFundMe
ni Gojek
fy Mylove
dk Pairs
bk G2G
bb LazyPay
vo Brand20ua
bh Uteka
gz LYKA
ww BIP
ur MyDailyCash
cx Icrypex
sh VkusVill
gv Humta
ve Dream11
kp HQ Trivia
uf Eneba
aa Probo
tk MVideo
iq Icq
ej MrQ
ss Hezzl
sf SneakersnStuff
ce Mosru
dc YikYak
sl SberApteka
dl Lazada
uo CafeBazaar
uh Yubo
pl Perekrestok
dg Mercari
cb Bazos
pu Justdating
gh GyFTR
ev Picpay
qg MoneyPay
bw Signal
cc Quipp
jf Likee
eq Qoo10
dd CloudChat
jc IVI
er Kwork
ip Burger King
bu MonobankIndia
nq Trip
qi 23red
eg ContactSys
cp Uklon
sg OZON
xr Tango
uk Airbnb
ko AdaKami
nf Netflix
vy Meta
dy Zomato
ha My11Circle
tg Telegram
dq IceCasino
rs Lotus
bc GCash
ne Coindcx
mr Fastmail
we DrugVokrug
ry McDonalds
qa MyFishka
pm AOL
la Ssoidnet
ak Douyu
go Google,youtube,Gmail
oi Tinder
dn Paxful
xl Wmaraci
vz Hinge
rd Lenta
wb WeChat
ew Nike
gm Mocospace
wj 1xbet
xe GalaxyChat
sn OLX
ae MyGLO
ch Pocket52
py Monese
hn 1688
qy Zhihu
ck BeReal
kw Foody
ml ApostaGanha
ci RedBus
wc Craigslist
pd IFood
be SberMegaMarket
xy Depop
cf Irancell
wp 163COM
rx Sheerid
su LOCO
ho Cathay
af GalaxyWin
bq Adani
oq Vlife
ru HOP
om Corona
sb Lamoda
ig Instagram
uj ChampionCasino
mu MyMusicTaste
cq Mercado
ti Cryptocom
uu Wildberries
ub Uber
ln Grofers
me Line msg
of Urent
fz KFC
un Humblebundle
ug Fiqsy
kr Eyecon
vn Yaay
qe GG
ds Discord
gg PagSmile
uw Kirana
vs WinzoGame
gt Gett
uy Meliuz
hq Magicbricks
im Imo
bv Metro
po Premium.one
jg Grab
es IQIYI
bo Wise
kb Kufarby
wq Leboncoin1
jh PingPong
tt Ziglu
rr Wolt
ih TeenPattiStarpro
od FWDMAX
iv Inboxlv
xh OVO
ra KeyPay
bz Blizzard
rc Skype
pt Bitaqaty
gu Fora
ma Mail.ru
ji Monobank
op MIRATORG
hk 4Fun
gp Ticketmaster
up Magnolia
dr OpenAI
bd X5ID
gl GlobalTel
gx Hepsiburadacom
ay Ruten
sr Starbucks
pa Gamekit
ct KuhnyaNaRayone
ht Bitso
ft Bookmakers
ka Shopee
mx SoulApp
wt IZI
sw NCsoft
ep Temu
mc Michat
qr MEGA
ee Twilio
le E bike Gewinnspiel
ec RummyCulture
qu Agroinform
oh MapleSEA
fa XadrezFeliz
cm Prom
bt Alfa
ya Yandex
ot Any other
cj Dotz
hh Uplay
gc TradingView
sm YoWin
ki 99app
tu Lyft
de Karusel
pq CDkeys
fm Touchance
lr Okta
ly Olacabs
va SportGully
df Happn
kf Weibo
vc Banqi
fk BLIBLI
xn Familia
th WestStein
fs Şikayet var
rz EasyPay
cn Fiverr
dx Powerkredite
pg NRJ Music Awards
bg MIXMART
mj Zalo
xw Taki
ua BlaBlaCar
pf Pof.com
an Adidas
mk LongHu
lh 24betting
hg Switips
sq KuCoinPlay
lx DewuPoison
gf GoogleVoice
iy FoodHub
nz Foodpanda
ah EscapeFromTarkov
nw Ximalaya
sj HandyPick
et Clubhouse
tl Truecaller
md Banks
co Rediffmail
ga Roposo
oc DealShare
og Okko
rh Ace2Three
rl InDriver
dj LUKOIL-AZS
pr Trendyol
bj Vita Express
rk Fotka
ao UU163
nr Tosla
ph SnappFood
ar Wondermart
ij Revolut
qc Primaries 2020
gd Surveytime
ky SpatenOktoberfest
sp HappyFresh
xj SberMarket
ac DoorDash
ba Expressmoney
kz NimoTV
np Siply
vf Q12 Trivia
tf Noon
iz Global24
jz Kaya
yd 米画师Mihuashi
cl UWIN
fx PGbonus
jr Scooter
px Nifty
nl Myntra
tn LinkedIN
dw Divar
ke Eldorado
ku RoyalWin
el Bisu
bm MarketGuru
nn Giftcloud
lp Algida
eo Sizeer
cw PaddyPower
gw CallApp
wo Parkplus
si Cita Previa
xt Flipkart
wx Apple
qz Faceit
di Loanflix
kx Vivo
nb Faithful
xi InFund
pw SellMonitor
fb Facebook
ex Linode
st Ashan
mt Steam
av Avito
db Ezbuy
wn GameArena
sa AGIBANK
re Coinbase
no Virgo
ls Careem
ql CMTcuzdan
tm Akulaku
rb Tick
ei Taksheel
hc MOMO
qk Bit
gs SamsungShop
lf TikTok/Douyin
vd Betfair
so RummyWealth
wl YouGotaGift
yx JTExpress
vj Stormgain
sv Dostavista
ob Onlinerby
rp Hamrahaval
tc Rambler
vx HeyBox
ab Alibaba
eh Telegram 2.0
jm Mzadqatar
fo MobiKwik
az CityBase
ny Pyro Music
xu RecargaPay
yk SportMaster
zw Quack
lv Megogo
fh Lalamove
ja Weverse
xq MPL
lc Subito
ea JamesDelivery
qn Blued
ib Immowelt
wg Skout
ff AVON
jx Swiggy
au Haraj
uv BinBin
eb Voltz
ju Indomaret
kt KakaoTalk
km Rozetka
yg CourseHero
cd SpotHit
xk DiDi
qo Moneylion
sd Dodopizza
fe CliQQ
ed Gamer
bi 勇仕网络Ys4fun
yz Around
xf LightChat
tj DbrUA
mf Weidian
rg Porbet
xv Wish
mb Yahoo
mg Magnet
gi Hotline
hm Globus
ol KazanExpress
xb RummyOla
vk Vkontakte
hw Alipay/Alibaba
oz Poshmark
tq Swvl
fc PharmEasy
ue Onet
aq Glovo
mq GMNG
my CAIXA
vw CoinField
dm Iwplay
fg IndianOil
xs GroupMe
hx AliExpress
yj EWallet
eu LiveScore
cy RSA
us IRCTC
br Vkusno i Tochka
jb Wing Money
fl RummyLoot
fr Dana
aw Taikang
zh Zoho
zj ROBINHOOD
zi LoveLocal
yp Payzapp
zd Zilch
yo Amasia
zs Bilibili
zm OfferUp
yw Grindr
yy Venmo
zl Airtel
yl Yalla
zn Biedronka
fv Vidio
fu Snapchat
cr TenChat
hi JungleeRummy
nk Gittigidiyor
vv Seosprint
dv NoBroker
hl Band
ll 888casino
hb Twitch
vp Kwai
td ChaingeFinance
xz Paycell
li Baidu
lj Santander
xx Joyride
yq Foxtrot
mo Bumble
ge Paytm
lb Mailru Group
zq IndiaPlays
ik GuruBets
cu 炙热星河
oe Codashop
kh Bukalapak
sy Brahma
vi Viber
os Dhani
uc Tatneft
ym Yula
rm Faberlic
cv WashXpress
pz Lidl
kl Kolesa.kz
gj Carousell
zf OnTaxi
gb YouStar
en Hermes
jl Hopi
hy Ininal
ax CrefisaMais
iu Bykea
fi Dundle
gk AptekaRU
rt Hily
cz Getmega
dz Dominos Pizza
fd Mamba
kg FreeChargeApp
il IQOS
hz Drom
xm Létoile
qq Tencent QQ
tp IndiaGold
am Amazon
qb Payberry
hu Ukrnet
em ZéDelivery
vg ShellBox
tr Paysend
cs AgriDevelop
lk PurePlatfrom
rj Kids' World
wf YandexGo
zu BigC
jq Paysafecard
nm Thisshop
bl BIGO LIVE
sz Pivko24
hj Stoloto
da MTS CashBack
du AUBANK
yn Allegro
zo Kaggle
zv Digikala
yu Xiaomi
yv IPLwin
zg Setel
yi Yemeksepeti
zk Deliveroo
zt Budweiser
zr Papara
zz Dent
zx CommunityGaming
zy Nttgame
ys ZCity
za JDcom
call Receiving a reset call