Собственный API Give-SMS

Здесь представлено описание схемы работы нашего API. API позволит вам интегрировать ваши программные решения с нашим сервисом, что позволит вам ускорить процесс верификации аккаунтов и избавит от ручной “волокиты”.

Получение баланса пользователя

GET или POST запрос на url:
https://give-sms.com/api/v1/?method=getbalance&userkey=testapikey
Параметры:
method = getbalance
userkey = ВАШ_APIKEY
Ответ:
При успешном выполнении запроса, возвращается json со “status” 200.
Ключ “balance” из объекта “data” характеризует ваш текущий баланс:
{
   "status": 200,
   "data": {
      "balance": 100,00
   }
}
Коды ошибок (status):
500 - ошибка при обработке запроса
401 - не указан или не верен API KEY пользователя
404 - неправильно задан параметр method

Получение списка сервисов и количества доступных номеров

Если вам необходимо получить список сервисов с их текущим количеством в системе, то вам стоит воспользоваться данным методом.

GET или POST запрос на url:
https://give-sms.com/api/v1/?method=getcount&userkey=testapikey&country=ru
Параметры:
method = getcount
userkey = ВАШ_APIKEY
country = ru Страна. Необязательный параметр. По умолчанию ru (Россия). Полный список возможных значений стран можно найти в разделе  "Список стран"
Ответ:
При успешном выполнении запроса, возвращается json со “status” 200. В результате запроса мы получили объект, который имеет два ключа: “status” и “data”. Ключ “status” представлен значением, которое характеризует результат запроса. Значение “200” ключа “status” говорит о том, что запрос успешен. Ключ “data” вмещает в себя объект с ключами-операторами. Каждый ключ-оператор имеет значение в виде объекта, который характеризирует сервисы.
Каждый объект сервиса имеет два ключа: “count” - текущее кол-во, “price” - цена.
Вы можете задасться вопросом: “Почему постороена иерархия объектов? (или что-то подобное)”
Возращается именно такой объект потому что, данная структура позволит вам легко добраться до нужной вам информации.
Например, вы пишите на PHP и хотите узнать кол-во номеров под ВК с любым оператором. Вы можете легко это сделать так (после того как декодировали json): $decoded_json[‘ANY’][‘vk’][‘count’].
Коды всех сервисов можно найти в разделе “Список сервисов”.
{
   "status": 200,
   "data": {
   // любой оператор
      "ANY": {
         "vk": {
            "count": 0,
            "price": "5"
         },
         "ok": {
            "count": 0,
            "price": "5"
         },
         "wapp": {
            "count": 1,
            "price": "2"
         },
         "vbr": {
            "count": 10,
            "price": "2"
         }
      }
      ...
      // Только Теле2
      "TELE2": {
         ...
      },
      // Только Билайн
      "BEELINE": {
         ...
      },
      // Только Мегафон
      "MEGAFON": {
         ...
      },
      // Только МТС
      "MTS": {
         ...
      }
   }
}
Если возникла ошибка при выполнении запроса, то возвращается json со “status” 500. Проблема вызвана ошибкой при работе с БД.
Если получили такую ошибку при данном запросе, просим сразу обратиться к администрации проекта Give-SMS:
{
   "status": 500,
   "data": {
      "msg": "Не удалось сформировать кол-во сервисов"
   }
}
Коды ошибок (status):
500 - ошибка при обработке запроса
401 - не указан или не верен API KEY пользователя
404 - неправильно задан параметр method

Получение номера телефона

Основной частью всего проекта является выдача номеров телефонов для активации. Перед тем, как получить номер телефона вам стоит проверить: достаточно ли у вас денег на балансе и имеются ли в системе свободные номера.
Небольшое отступление и информация.
В момент выдачи номера телефона, мы создаем виртуальный заказ, который позволит вам получить смс с выданного номера в течении 15 минут. На время жизни заказа, мы переводит часть вашего баланса в резерв, это вынужденная необходимость для избежания ошибочных списаний при многопоточной работе с API, а так же, чтобы пользователи не “бросали” заказ не получив смс.

GET или POST запрос на url:
https://give-sms.com/api/v1/?method=getnumber&service=vk&userkey=testapikey&country=ru
Параметры:
method = getnumber
service = vk Сервис. Обязательный параметр. Полный список значений сервисов можно найти в разделе "Список сервисов".
userkey = ВАШ_APIKEY
country = ruСтрана. Необязательный параметр. По умолчанию ru (Россия). Полный список возможных значений стран можно найти в разделе "Список стран"
Ответ:
При успешно выполнении запроса будет получен json с ключом “status” равным 200.
Ключ “data” будет иметь объект с ключами “order_id” - номер заказа для последующей работы с номером телефона, и ключ “phone”, содержащий номер телефона для получения смс сообщения с кодом верификации.
Номер телефона выдаётся в международном формате с кодом страны без знака +. Учитывайте это.
{
   "status": 200,
   "data": {
      "order_id": "377253343",
      "phone": "79969817867",
      "start_time": "2023-02-23T13:11:57.373Z"
   }
}
Может оказаться, что временно закончились номера телефонов для заказываемого сервиса, тогда “status” будет равен 500:
{
   "status": 500,
   "data": {
      "msg": "По данному запросу номер телефона не найден.",
      "advice": "Попробуйте получить номер, позже, после того как появятся номера"
   }
}
Коды ошибок (status):
401 - не указан API KEY пользователя
404 - неправильно задан параметр method
500 - нет свободных номеров
502 - сервис не существует
503 - оператора не существует
504 - недостаточно средств
505 - страны не существует
506 - вы временно заблокированы до следующего дня
507 - ведутся технические работы

Получение кода из смс

Финальным этапом активации является получение кода и полного смс для подтверждения номера телефона аккаунта.
Алгоритм получения смс специфичен:
1. Отправляете запрос на получение смс, где в ключ order_id подставляете значение полученное из запроса на получение номера getnumber.
2. Если “status” равен 200, то смс получено.
3. Если “status” равен 400, то смс еще не пришло или не найдено, тогда через 5 секунд повторите с шага 1.
4. Если “status” равен 500, то это значит, что истекло время заказа.

Что делать если истекло время заказа, а смс не получено?
Это может быть вызвано рядом причин:
- смс не отправлено заказываемым сервисом
- шаблон поиска смс не актуален
- ошибка при работе нашего оборудования
- Вы случайно ошиблись с вводом номера телефона
В любом случае, денежные средства с Вас не спишутся, если смс не было получено.
Если вы уверены, что ошибка возникла по нашей вине. Мы с радостью будем готовы помочь Вам в техподдержке.

GET или POST запрос на url:
https://give-sms.com/api/v1/?method=getcode&order_id=377253343&userkey=testapikey
Параметры:
method = getcode
order_id = 377253343 Номер заказа полученный из запроса на получение номера. Обязательное значение.
userkey = ВАШ_APIKEY
Ответ:
При успешно выполнении запроса будет получен json с ключом “status” равным 200.
Ключ “data” будет содержать объект с подробностями смс:
code - код, который система нашла смс. Код может быть null, т.к. не удалось определить код
fullSms - полное смс, которая пришла
phone - номер телефона, на который пришла смс в международном формате без знака +
receivedDate - дата получения смс в формате ISO
sender - отправитель, обозначенный в смс. Может быть пустым.
id - идентификатор смс сообщения для метода wrongcode (доп. смс как параметр “last_id”)
phonePass - пароль от личного кабинета оператора связи. Может быть пустым.
{
   "status": 200,
   "data": {
      "code": "753455",
      "fullSms": "753455",
      "phone": "79969817867",
      "receivedDate": "2023-02-23T13:18:57.373Z",
      "sender": "",
      "id": "377253343",
      "phonePass": ""
   }
}
Вы можете получить json и со “status” 400, это не ошибка, а естественный ответ системы, когда ваша смс еще не пришла.
Для продолжения работы, вам просто необходимо повторить запрос на получение кода через 5 секунд.
Повторять необходимо, либо пока вы не получите смс, либо пока не возникнет ошибка, о том, что истекло время жизни заказа (ошибка 500):
{
   "status": 400,
   "data": {
      "msg": "Смс еще не найдено",
      "advice": "Скорее всего смс еще не пришло, повторите запрос через 10 секунд"
   }
}
Коды ошибок (status):
500 - истекло время жизни заказа
502 - внутренняя ошибка, попробуйте сделать запрос ещё раз
504 - недостаточно средств
505 - заказ не найден в системе
506 - не указан параметр order_id
401 - не указан API KEY пользователя
404 - неправильно задан параметр method

Повторное получение кода

В рамках нашего проекта вы платите не за каждый код, а за, своего рода, временную аренду номера телефона для определенного сервиса. На практике, у вас 15 минут, в течении которых вы можете получать все смс, которые приходят на выданный номер телефона для заказанного сервиса.
Где такой функционал может вам пригодиться? Например, вы регистрируйте кошелек Qiwi. И вам необходимо получить смс для отключения функции безопасности в Qiwi. Для этого вы получаете первое смс, регистрируйте кошелек, отключаете функцию безопасности в Qiwi кошельке, отправляете к нам данный запрос wrongcode, и мы вам абсолютно бесплатно выдаем второе смс, которое пришло на номер телефона от Qiwi. Количество дополнительных смс, которые вы можете получить в рамках заказа не ограничено.
ВНИМАНИЕ!
У нас вы можете получить дополнительные коды только в течении времени жизни заказа, т.е. в течении 15 минут, с момента получения номера телефона.

GET или POST запрос на url:
https://give-sms.com/api/v1/?method=wrongcode&order_id=377253343&userkey=testapikey&last_id=377253343
Параметры:
method = wrongcode
order_id = 377253343 Номер заказа полученный из запроса на получение номера. Обязательное значение.
userkey = ВАШ_APIKEY
last_id = 377253343 Идентификатор последнего смс, который вы получили методом getcode или предыдущим запросом wrongcode. Почти всегда совпадает со значением order_id, но может и отличаться, будьте внимательны. Обязательное значение. 
Ответ:
При успешно выполнении запроса будет получен json с ключом “status” равным 200.
Ключ “data” будет содержать объект с подробностями смс:
code - код, который система нашла смс. Код может быть null, т.к. не удалось определить код
fullSms - полное смс, которая пришла
phone - номер телефона, на который пришла смс в международном формате без знака +
receivedDate - дата получения смс в формате ISO
sender - отправитель, обозначенный в смс. Может быть пустым.
id - идентификатор смс сообщения для метода wrongcode (доп. смс как параметр “last_id”)
phonePass - пароль от личного кабинета оператора связи. Может быть пустым.
{
   "status": 200,
   "data": {
      "code": "753455",
      "fullSms": "753455",
      "phone": "79969817867",
      "receivedDate": "2023-02-23T13:18:57.373Z",
      "sender": "",
      "id": "377253343",
      "phonePass": ""
   }
}
Вы можете получить json и со “status” 400, это не ошибка, а естественный ответ системы, когда ваша смс еще не пришла.
Для продолжения работы, вам просто необходимо повторить запрос на получение кода через 5 секунд.
Повторять необходимо, либо пока вы не получите смс, либо пока не возникнет ошибка, о том, что истекло время жизни заказа (ошибка 500):
{
   "status": 400,
   "data": {
      "msg": "Смс еще не найдено",
      "advice": "Скорее всего смс еще не пришло, повторите запрос через 10 секунд"
   }
}
Коды ошибок (status):
500 - истекло время жизни заказа
501 - не правильно указан параметр method
502 - внутренняя ошибка, попробуйте сделать запрос ещё раз
504 - вы ещё не получили первое смс из метода getcode.
505 - заказ не найден в системе
506 - не указан параметр order_id
401 - не указан API KEY пользователя
404 - неправильно задан параметр method

Отмена заказа номера

Если в процессе работы вы получили номер телефона, но, по известным только вам причинам, хотите отказаться от заказа, то вам необходимо произвести процесс отказа от номера телефона, используя данный метод refusenumber.

GET или POST запрос на url:
https://give-sms.com/api/v1/?method=refusenumber&order_id=377253343&userkey=testapikey
Параметры:
method = refusenumber
order_id = 377253343 Номер заказа полученный из запроса на получение номера. Обязательное значение.
userkey = ВАШ_APIKEY
Ответ:
При успешно выполнении запроса будет получен json с ключом “status” равным 200:
{
   "status": 200,
   "data": {
      "msg": "Заказ номера телефона отменен"
   }
}
Если вы получили иное сообщение, ориентируйтесь по кодам ошибок указанным ниже.

Коды ошибок (status):
500 - истекло время жизни заказа
502 - внутренняя ошибка, попробуйте сделать запрос ещё раз
506 - не указан параметр order_id
401 - не указан API KEY пользователя
404 - неправильно задан параметр method

Бан номера телефона

Если в процессе регистрации аккаунта оказалось, что выданный вам номер телефона не подходит для регистрации, то советуем вам воспользоваться данным методом bannumber, для того, чтобы забанить номер телефона.

GET или POST запрос на url:
https://give-sms.com/api/v1/?method=bannumber&order_id=377253343&userkey=testapikey
Параметры:
method = bannumber
order_id = 377253343 Номер заказа полученный из запроса на получение номера. Обязательное значение.
userkey = ВАШ_APIKEY
Ответ:
При успешно выполнении запроса будет получен json с ключом “status” равным 200:
{
   "status": 200,
   "data": {
      "msg": "Номер телефона забанен"
   }
}
Если вы получили иное сообщение, ориентируйтесь по кодам ошибок указанным ниже.

Коды ошибок (status):
500 - истекло время жизни заказа
502 - внутренняя ошибка, попробуйте сделать запрос ещё раз
506 - не указан параметр order_id
401 - не указан API KEY пользователя
404 - неправильно задан параметр method
Совместимое API с другими сервисами активации

Если Вы решили работать в режиме совместимости с другим сервисом активаций и не переписывать своё ПО, Вы можете использовать наше совместимое API. Но делать это мы Вам крайне не рекомендуем, т.к. оно не обновляется и не поддерживается должным образом.
Первым делом, чтобы начать использовать наше совместимое API Вам необходимо прописать в файле host в Windows который находится по следующему адресу
C:\Windows\System32\drivers\etc\
и добавьте в него следующую строку:
5.253.63.28 domain.com (название домена другого сервиса активаций)

Если Вы не хотите прописывать что-то в файл host, в таком случае в Вашем ПО следует изменить домен с домена другого сервиса активаций на give-sms.com. И адрес Ваших запросов должен принять следующий вид:
https://give-sms.com/stubs/handler_api.php
Все запросы Вы можете отправлять либо POST, либо GET.
Обращаем Ваше внимание, что переадресации вызовов пока нет! И скорей всего в этой версии API не будет!
В остальном все наше совместимое абсолютно идентично! Поэтому мы решили просто скопировать инструкцию, дабы не плодить и не вводить в заблуждение своих пользователей.

Запрос количества доступных номеров (getNumbersStatus)

GET или POST запрос на url:
https://give-sms.com/stubs/handler_api.php?action=getNumbersStatus&api_key=testapikey&country=0
Параметры:
action = getNumbersStatus
api_key = ВАШ_APIKEY
country = 0 Страна. Необязательный параметр. По умолчанию 0 (Россия). Полный список возможных значений стран можно найти в разделе "Список стран"
Ответ:
При успешной выполнении запроса вы получите 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)

GET или POST запрос на url:
https://give-sms.com/stubs/handler_api.php?action=getBalance&api_key=testapikey
Параметры:
action = getBalance
api_key = ВАШ_APIKEY
Ответ:
При успешной выполнении запроса вы получите ТЕКСТ данного вида:
ACCESS_BALANCE:100 // где 100 - ваш текущий баланс в рублях
Возможные ошибки:
BAD_KEY - Неверный API-ключ
ERROR_SQL - ошибка SQL-сервера

Заказ номера (getNumber)

GET или POST запрос на url:
https://give-sms.com/stubs/handler_api.php?action=getNumber&service=vk&country=0&api_key=testapikey
Параметры:
action = getNumber
service = vk Сервис. Обязательный параметр. Полный список значений сервисов можно найти в разделе "Список сервисов".
country = 0 Страна. Необязательный параметр. По умолчанию 0 (Россия). Полный список возможных значений стран можно найти в разделе  "Список стран"
api_key = ВАШ_APIKEY
Ответ:
При успешной выполнении запроса вы получите ТЕКСТ данного вида, где $id - id операции, $number - номер телефона:
ACCESS_NUMBER:$id:$number
Иные ответы:
NO_NUMBERS - нет номеров
NO_BALANCE - закончился баланс
Возможные ошибки:
BAD_ACTION - некорректное действие
BAD_SERVICE - некорректное наименование сервиса
WRONG_SERVICE - такого сервиса нет в системе
BAD_KEY - Неверный API-ключ
ERROR_SQL - ошибка SQL-сервера
YOU_TEMPORARY_BANNED - вы забанены до следующего дня

Изменение статуса активации (setStatus)

GET или POST запрос на url:
https://give-sms.com/stubs/handler_api.php?action=setStatus&status=1&id=1234567&api_key=testapikey
Параметры:
action = setStatus
status = КОД СТАТУСА Возможные коды статусов указаны ниже
id = ID ОПЕРАЦИИ Идентификатор заказа полученный из запроса getNumber
api_key = ВАШ_APIKEY
Возможные статусы:
1 сообщить о готовности номера (смс на номер отправлено)
3 запросить еще один код (бесплатно)
6 завершить активацию Если был статус 'код получен' - помечает успешно и завершает, если был 'подготовка' - удаляет и помечает ошибка, если был статус 'ожидает повтора' - переводит активацию в ожидание смс
8 сообщить о том, что номер использован и отменить активацию

Ответ:
При успешной выполнении запроса вы получите ТЕКСТ, в зависимости от статуса:
ACCESS_READY - готовность номера подтверждена
ACCESS_RETRY_GET - ожидание нового смс
ACCESS_ACTIVATION - сервис успешно активирован
ACCESS_CANCEL - активация отменена
Возможные ошибки:
BAD_ACTION - некорректное действие
NO_ACTIVATION - id активации не существует
BAD_STATUS - некорректный статус
BAD_KEY - Неверный API-ключ
ERROR_SQL - ошибка SQL-сервера

Получить состояние активации (getStatus)

GET или POST запрос на url:
http://give-sms.com/stubs/handler_api.php?action=getStatus&id=1234567&api_key=testapikey
Параметры:
action = getStatus
id = ID ОПЕРАЦИИ Идентификатор заказа полученный из запроса getNumber
api_key = ВАШ_APIKEY
Ответ:
При успешной выполнении запроса вы получите ТЕКСТ, в зависимости от статуса:
STATUS_WAIT_CODE - ожидание смс
STATUS_WAIT_RETRY:'прошлый, не подошедший код' - ожидание уточнения кода
STATUS_WAIT_RESEND - ожидание повторной отправки смс (софт должен нажать повторно выслать смс и выполнить изменение статуса на 6)
STATUS_CANCEL - активация отменена
STATUS_OK: 'код активации' - код получен
Возможные ошибки:
BAD_ACTION - некорректное действие
NO_ACTIVATION - id активации не существует
NO_BALANCE - недостаточно баланса
BAD_KEY - Неверный API-ключ
ERROR_SQL - ошибка SQL-сервера

Получить все цены на сервисы (getPrices)

GET или POST запрос на url:
https://give-sms.com/stubs/handler_api.php?action=getPrices&api_key=testapikey&service=SERVICE&country=0
Параметры:
action = getPrices
service = vk Сервис. Необязательный параметр. Полный список значений сервисов можно найти в разделе "Список сервисов".
api_key = ВАШ_APIKEY
country = 0 Страна. Обязательный параметр. По умолчанию 0 (Россия). Полный список возможных значений стран можно найти в разделе "Список стран"
Ответ:
При успешной выполнении запроса вы получите 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
    }
  }
}
Иерархия принимает следующий вид - { "Страна": { "Сервис": { "Цена": Количество}}}
API аренды номера телефона на продолжительный период

Здесь представлена инструкция по работе с API для аренды номера телефона. API позволит вам интегрировать ваши программные решения с нашим сервисом.
Если у Вас останутся вопросы, Вы всегда можете воспользоваться службой поддержки.

Сервер API может принимать запросы POST или GET
Запросы отправляются на следующий адрес -  https://give-sms.com/api/v2/rent/

Получение количества доступных номеров, сервисов и цен для аренды

GET или POST запрос на url:
https://give-sms.com/api/v2/rent/?userkey=testapikey&method=getcountprices&country=ru
Параметры:
method = getcountprices
userkey = ВАШ_APIKEY
country = ru Страна. Обязательный параметр. По умолчанию ru (Россия). Полный список возможных значений стран можно найти в разделе "Список стран"
Ответ:
При успешно выполнении запроса будет получен json с ключом “status” равным 200.
Ключ “data” будет содержать объект с объектами сервисов:
vk (пример) - объект, с ключом из кодового названия сервиса и содержащий количество доступных номеров для аренды и цены на аренду за определенное время
count - количество доступных номеров
price - объект, содержащий цены за определенный промежуток времени
1day - цена за один день аренды (24 часа)
2day - цена за два дня аренды (48 часов)
3day - цена за три дня аренды (72 часа)
4day - цена за четыре дня аренды (96 часов)
5day - цена за пять дней аренды (120 часов)
6day - цена за шесть дней аренды (144 часа)
7day - цена за семь дней аренды (168 часов)
{
   "status": 200,
   "data": {
      "vk":{
         "count":"233",
         "price":{
             "1day":"101.9",
             "2day":"144.7",
             "3day":"182.4",
             "4day":"215",
             "5day":"241.5",
             "6day":"251.7",
             "7day":"275.1"
         }
      },
      "wa":{
         "count":"182",
         "price":{
            "1day":"250.5",
            "2day":"355.7",
            "3day":"448.4",
            "4day":"528.6",
            "5day":"593.7",
            "6day":"618.7",
            "7day":"676.4"
         }
      },
      "vi":{
         "count":"316",
         "price":{
            "1day":"17.7",
            "2day":"25.1",
            "3day":"31.7",
            "4day":"37.3",
            "5day":"41.9",
            "6day":"43.7",
            "7day":"47.8"
         }
      }
      ...
   }
}

Получение номера телефона для аренды

Обязательно проверьте номер после заказа аренды в течение 20 минут, путём отправки на него сообщения от выбранного сервиса. Если СМС не приходит в течении 15 минут, вы можете отменить заказ. Деньги будут возвращены за него в полном объеме. По истечении 20 минут, денежные средства не возвращаются. Будьте пожалуйста внимательнее.

GET или POST запрос на url:
https://give-sms.com/api/v2/rent/?userkey=testapikey&method=getnumber&type=day&period=1&service=ig&country=ru
Параметры:
method = getnumber
userkey = ВАШ_APIKEY
type = day Обязательный параметр. Тип периода: day (дни) или week(недели).
period = 1 Количество дней или недель. Обязательный параметр. Значение 1  и тип периода day означает, что мы хотим арендовать номер телефона на 1 день. 
service = ig Сервис. Обязательный параметр. Полный список значений сервисов можно найти в разделе "Список сервисов".
country = ru Страна. Обязательный параметр. По умолчанию ru (Россия). Полный список возможных значений стран можно найти в разделе "Список стран"
Ответ:
При успешно выполнении запроса будет получен json с ключом “status” равным 200.
Ключ “data” будет иметь объект с ключами “order_id” - номер заказа для последующей работы с номером телефона, и ключ “phone”, содержащий номер телефона для получения смс сообщений с кодами верификации.
Номер телефона выдаётся в международном формате с кодом страны без знака +. Учитывайте это.

Для удобства выведены интервалы времени в UNIX метке и обычном 24-значном формате:
end_time_timestamp - метка времени UNIX до окончания срока аренды
end_time - дата и время окончания аренды номера телефона
start_timestamp - дата и время начала аренды номера в метке времени UNIX  
{
   "status":200,
   "data":{
      "order_id":14763471,
      "phone":"79510405923",
      "end_time_timestamp":1702981048,
      "end_time":"2023-12-19 13:17:29",
      "start_timestamp":1702881048
   }
}
Коды ошибок (status):
401 - не указан API KEY пользователя
404 - неправильно задан параметр method
500 - нет свободных номеров для аренды
502 - сервис не существует
503 - внутренняя ошибка, попробуйте заказать номер позже
504 - недостаточно средств
505 - страны не существует
506 - не правильно указан период или тип периода
507 - ведутся технические работы

Получение всех СМС на арендованном номере

GET или POST запрос на url:
https://give-sms.com/api/v2/rent/?userkey=testapikey&method=getcode&rentid=888
Параметры:
method = getcode
userkey = ВАШ_APIKEY
rentid= 888 Обязательный параметр. ID заказа полученный из запроса на получения номера для аренды. Также данный параметр можно узнать из запроса на получение всех действующих заказов.
Ответ:
При успешно выполнении запроса будет получен json с ключом “status” равным 200.
Ключ “data” будет иметь объект с ключом “sms_list” который будет содержать все СМС которые были получены на данном номере телефона.
{
   "status":200,
   "data":{
      "msg":"Список всех СМС",
      "sms_list":[
         {
            "date":"2023-12-14 17:11:51",
            "text":"Код для регистрации в Rambler&Co: 435345"
         },
         {
            "date":"2023-12-15 15:36:56",
            "text":"Код для регистрации в Rambler&Co: 520455"
         }
      ]
   }
}
Вы можете получить json и с “status” 400, это не ошибка, а естественный ответ системы, когда смс на номере ещё не были получены.
Для продолжения работы, вам просто необходимо повторить запрос на получение кода через 15-30 секунд.
{
   "status":400,
   "data":{
      "msg":"На данном номере еще не было получено СМС",
      "advice":"На данном номере еще не было получено СМС"
   }
}
Коды ошибок (status):
401 - не указан API KEY пользователя
404 - неправильно задан параметр method
501 - аренда была отменена или время заказа аренды истекло
502 - аренда завершена
503 - заказ не найден

Продление заказа аренды

GET или POST запрос на url:
https://give-sms.com/api/v2/rent/?userkey=testapikey&method=prolong&type=day&period=1&rentid=888
Параметры:
method = prolong
userkey = ВАШ_APIKEY
type = day Обязательный параметр. Тип периода: day (дни) или week(недели).
period = 1 Количество дней или недель. Обязательный параметр. Значение 1  и тип периода day означает, что мы хотим арендовать номер телефона на 1 день. 
rentid= 888 Обязательный параметр. ID заказа полученный из запроса на получения номера для аренды. Также данный параметр можно узнать из запроса на получение всех действующих заказов.
Ответ:
При успешно выполнении запроса будет получен json с ключом “status” равным 200. Который означает, что продление номера успешно завершено.
{
   "status":200,
   "data":{
      "phone":"79510405923",
      "msg":"Вы продлили аренду номера"
   }
}
Коды ошибок (status):
401 - не указан API KEY пользователя
404 - неправильно задан параметр method
502 - не указан ID аренды или такого заказа нет в системе
504 - не правильно указан период или тип периода
505 - недостаточно средств для продления аренды
506 - на заданное время невозможно продлить аренду.
507 - внутренняя ошибка, попробуйте отправить запрос ещё раз

Отмена заказа аренды

GET или POST запрос на url:
https://give-sms.com/api/v2/rent/?userkey=testapikey&method=refuse&rentid=888
Параметры:
method = refuse
userkey = ВАШ_APIKEY
rentid= 888 Обязательный параметр. ID заказа полученный из запроса на получения номера для аренды. Также данный параметр можно узнать из запроса на получение всех действующих заказов.
Ответ:
При успешно выполнении запроса будет получен json с ключом “status” равным 200. Который означает, что аренда номера успешно выполнена. Денежные средства за аренду возвращены на баланс пользователя.
{
   "status":200,
   "data":{
      "msg":"Аренда отменена",
      "advice":"Ваш заказ аренды номера телефона отменен. Деньги возвращены."
   }
}
Коды ошибок (status):
400 - аренду данного номера нельзя отменить, т.к. прошло более 20 минут или уже было получено СМС
401 - не указан API KEY пользователя
404 - неправильно задан параметр method
500 - не указан ID аренды
501 - аренда уже отменена
502 - аренда завершена
503 - заказ не найден

Удаление заказа аренды

GET или POST запрос на url:
https://give-sms.com/api/v2/rent/?userkey=testapikey&method=delete&rentid=888
Параметры:
method = delete
userkey = ВАШ_APIKEY
rentid= 888 Обязательный параметр. ID заказа полученный из запроса на получения номера для аренды. Также данный параметр можно узнать из запроса на получение всех действующих заказов.
Ответ:
При успешно выполнении запроса будет получен json с ключом “status” равным 200. Который означает, что заказ аренды номера успешно удалена из системы.
{
   "status":200,
   "data":{
      "msg":"Заказ удалён",
      "advice":"Заказ аренды номера удалён из системы"
   }
}
Коды ошибок (status):
401 - не указан API KEY пользователя
404 - неправильно задан параметр method
500 - не указан ID аренды

Получение всех заказов аренды

GET или POST запрос на url:
https://give-sms.com/api/v2/rent/?userkey=testapikey&method=getorders
Параметры:
method = getorders
userkey = ВАШ_APIKEY
Ответ:
При успешно выполнении запроса будет получен json с массивом всех заказанных номеров для аренды, включая те номера, аренда которых была отменена или завершена.
Расшифровка ключа status:
status = 0 Время аренды номера истекло
status = 1 Аренда активна
status = 2 Аренда отменена пользователем

Расшифровка ключа date_at:
date_at = 2023-10-10 07:15:07 Дата и время до которого аренда номера была заказана
[
   {
      "id":"512",
      "phone":"79222222222",
      "status":"0",
      "date_at":"2023-09-29 09:56:38"
   },
   {
      "id":"559",
      "phone":"79222222222",
      "status":"1",
      "date_at":"2023-10-10 07:15:07"
   },
   {
      "id":"886",
      "phone":"79222222222",
      "status":"2",
      "date_at":"2023-12-19 13:00:58"
    }
]
Если арендованных номеров нет, Вы получите пустой массив:
[]

Список стран

Значение Наименование Значение совместимого API
ru Россия 0
ukr Украина 1
kazakhstan Казахстан 2
england Англия 16
canada Канада 36
germany Германия 43
usavirt США (Виртуальные) 12
brazil Бразилия 73
estonia Эстония 34
france Франция
 78
indonesia Индонезия 6
kyrgyzstan Кыргызстан 11
laos Лаос 25
lithuania Литва 44
netherlands Нидерланды 48
poland Польша 15
romania Румыния 32
sweden Швеция 46
indiia Индия 22
malaiziia Малайзия 7
vetnam Вьетнам 10
filippiny Филиппины 4
turtsiia Турция 62
moldova Молдова 85
uzbekistan Узбекистан 40
gruziia Грузия 128
irlandiia Ирландия 23
portugaliia Португалия 117
ispaniia Испания 56
chekhiia Чехия 63
bangladesh Бангладеш 60
ssha США 187
gonkong Гонконг 14
tailand Таиланд 52
meksika Мексика 54
latviia Латвия 49
pakistan Пакистан 66
gretsiia Греция 129
nikaragua Никарагуа 90
argentina Аргентина 39
gaiti Гаити 26
mongoliia Монголия 72
izrail Израиль 13
egipet Египет 21
gvatemala Гватемала 94
liviia Ливия 102
iran Иран 57
iemen Йемен 30
tadzhikistan Таджикистан 143
kitai Китай 3
shrilanka Шри-Ланка 64
siriia Сирия 110
livan Ливан 153
boliviia Боливия 92
serbiia Сербия 29
kolumbiia Колумбия 33
avstriia Австрия 50
alzhir Алжир 58
peru Перу 65
gonduras Гондурас 88
marokko Марокко 37
venesuela Венесуэла 70
nigeriia Нигерия 19
iamaika Ямайка 103
salvador Сальвадор 101
botsvana Ботсвана 123
paragvai Парагвай 87
nepal Непал 81
uganda Уганда 75
irak Ирак 47
iordaniia Иордания 116
mianma Мьянма 5
demkongo Дем.конго 18
keniia Кения 8
kambodzha Камбоджа 24
belarus Беларусь 51
kotdivuar Кот Д'ивуар 27
saudaraviia Сауд. Аравия 53
oae ОАЭ 95
khorvatiia Хорватия 45
papuanovaiagvineia Папуа-Новая Гвинея 79
tanzaniia Танзания 9
gvineia Гвинея 68
mali Мали 69
kamerun Камерун 41
mavritaniia Мавритания 114
serraleone Сьерра-Леоне 115
burkinafaso Буркина-Фасо 152
daniia Дания 172
tunis Тунис 89
dominikanskaiarespublika Доминиканская Республика 109
iuzhnaiaafrika Южная Африка 31
ekvador Эквадор 105
liberiia Либерия 135
senegal Сенегал 61
afganistan Афганистан 74
novaiazelandiia Новая Зеландия 67
chad Чад 42
angola Ангола 76
gana Гана 38
iuzhnaiakoreia Южная Корея 190
sudan Судан 98
taivan Тайвань 55
zimbabve Зимбабве 96
turkmenistan Туркменистан 161
reiunon Реюньон 146
kipr Кипр 77
gaiana Гайана 131
maldivy Мальдивы 159
mozambik Мозамбик 80
gambiia Гамбия 28
trinidaditobago Тринидад И Тобаго 104
gabon Габон 154
brunei Бруней 121
butan Бутан 158
surinam Суринам 142
armeniia Армения 148
benin Бенин 120
mavrikii Маврикий 157
fidzhi Фиджи 189
kongo Конго 150
dominika Доминика 126
bermudy Бермуды 195
aruba Аруба 179
chili Чили 151
finliandiia Финляндия 163
italiia Италия 86
bolgariia Болгария 83
vengriia Венгрия 84
sloveniia Словения 59
khorvatiia Хорватия 45
norvegiia Норвегия 174

Список сервисов

Значение Наименование
ai CELEBe
do Leboncoin
dh EBay
sk Skroutz
lq Potato
mh Ашан
wv AIS
ia Socios
bf Keybase
mm Microsoft
qd Taobao
at Perfluence
qf RedBook
dp ProtonMail
mi Zupee
yb Квартплата+
wa Whatsapp
uz OffGamers
ou Gabi
he Mewt
jj Aitu
ez GoerliFaucet
ts PayPal
ta Wink
qt MoneyСontrol
ef Nextdoor
ad Iti
cg Gemgala
nu Stripe
rf Akudo
kj YAPPY
ul Getir
nv Naver
fw 99acres
ud Disney Hotstar
lw MrGreen
io ЗдравСити
oy CashFly
qm RosaKhutor
mn RRSA
dt Delivery Club
lt BitClout
ui RuTube
qw Киви
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 ВкусВилл
gv Humta
ve Dream11
kp HQ Trivia
uf Eneba
aa Probo
tk МВидео
iq Icq
ej MrQ
ss Hezzl
sf SneakersnStuff
ce Mosru
dc YikYak
sl СберАптека
dl Lazada
uo CafeBazaar
uh Yubo
pl Перекресток
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 ДругВокруг
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 1хbet
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 СберМегаМаркет
xy Depop
cf Irancell
wp 163СOM
rx Sheerid
su LOCO
ho Cathay
af GalaxyWin
bq Adani
oq Vlife
ru HOP
om Corona
sb Lamoda
ig Instagram
uj СhampionСasino
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 КухняНаРайоне
ht Bitso
ft Букмекерские
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 Яндекс
ot Любой другой
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 Банки
co Rediffmail
ga Roposo
oc DealShare
og Okko
rh Ace2Three
rl InDriver
dj LUKOIL-AZS
pr Trendyol
bj Вита экспресс
rk Fotka
ao UU163
nr Tosla
ph SnappFood
ar Wondermart
ij Revolut
qc Праймериз 2020
gd Surveytime
ky SpatenOktoberfest
sp HappyFresh
xj СберМаркет
ac DoorDash
ba Expressmoney
kz NimoTV
np Siply
vf Q12 Trivia
tf Noon
iz Global24
jz Kaya
yd 米画师Mihuashi
cl UWIN
fx PGbonus
jr Самокат
px Nifty
nl Myntra
tn LinkedIN
dw Divar
ke Эльдорадо
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 Верный
xi InFund
pw SellMonitor
fb Facebook
ex Linode
st Ашан
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 СпортМастер
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 Около
xf LightChat
tj DbrUA
mf Weidian
rg Porbet
xv Wish
mb Yahoo
mg Магнит
gi Hotline
hm Globus
ol KazanExpress
xb RummyOla
vk Вконтакте
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 РСА
us IRCTC
br Вкусно и Точка
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 Фокстрот
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 Юла
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 Лэтуаль
qq Tencent QQ
tp IndiaGold
am Amazon
qb Payberry
hu Ukrnet
em ZéDelivery
vg ShellBox
tr Paysend
cs AgriDevelop
lk PurePlatfrom
rj Детский мир
wf YandexGo
zu BigC
jq Paysafecard
nm Thisshop
bl BIGO LIVE
sz Pivko24
hj Столото
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 Приём звонка-сброса
Есть вопросы? Напишите нам