GET`https://onlinesim.io/api/getFreeList`

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

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

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

С параметром country: возвращает список доступных бесплатных номеров этой страны, сообщений, полученных первым номером из этого списка и списком запрещенных сервисов.

С параметрами country и number: возвращает список SMS-сообщений, полученных этим номером и списком запрещенных сервисов.

Вы можете использовать данный запрос для получения номера и последующего приема SMS-сообщений на него, например, для теста.

Параметры

query8

Название	Тип	Описание
`country`	`string`	Код страны (согласно списку стран)
`number`	`string`	Бесплатный номер телефона, без кода страны, входящие SMS которого необходимо отобразить
`page`	`integer` ≥ 1	Номер страницы SMS (по умолчанию — 1) По умолчанию:`1`
`count`	`integer` ≥ 10, ≤ 500	Количество SMS на страницу. Значения меньше 10 приводятся к 10, больше 500 — к 500. По умолчанию — 10 По умолчанию:`10`
`locale`	`string`	Язык контента. По умолчанию совпадает со значением `lang`
`as_country_text`	`string`	Если `yes`, значение `country` в запросе трактуется как slug страны из конфига (например, `moldova`), а не как числовой код Перечисление:`yes`
`with_content`	`string`	Если `yes`, ответ содержит SEO-контент страницы (поле `content`); иначе `content` равен `null` Перечисление:`yes`
`lang`	`string`	Язык ответа: `fr` - французский, `de` - немецкий, `ru` - русский, `en` - английский, `zh` - китайский. Обратите внимание, что перевод производится лишь для строковых значений полей, например, названий сервисов или стран. Сами названия полей, ошибки выполнения запросов и общепринятые значения (например, значения полей true/false для булевых параметров) остаются на английском языке Перечисление:`frderuenzh`По умолчанию:`ru`

Ответы

200

Успешный ответ на запрос getFreeList: сервер возвращает информацию о бесплатных номерах и полученных ими сообщениях или выбрасывает исключение

Content-Typeapplication/json

Схема

schemaoneOf

Успешный ответ, ошибка OAuth scope или общая ошибка

Одно из

[0]object

[1]object

[2]object

Примеры

Successful responseexample_lines

Возвращает список бесплатных номеров и полученных ими SMS-сообщений

{
  "response": 1,
  "countries": [
    {
      "country": 7,
      "country_text": "Россия",
      "country_original": "russia"
    }
  ],
  "numbers": {
    "9915584911": {
      "country": 7,
      "country_original": "russia",
      "data_humans": "6 дней назад",
      "full_number": "+79915584911",
      "is_archive": false
    }
  },
  "messages": {
    "current_page": 1,
    "data": [
      {
        "text": "74957982601 received from onlinesim.io",
        "in_number": "***2601",
        "my_number": 9915584911,
        "created_at": "2022-07-24 15:32:14",
        "data_humans": "1 минуту назад"
      }
    ],
    "per_page": 10,
    "total": 6100,
    "last_page": 610,
    "number": "9915584911",
    "country": 7
  },
  "ignore": "<p>…</p>",
  "content": null
}

Примеры кода

Генерация примеров...