АПИ для получения этикеток операторами подвижной радиосвязи (ППРФ №1300 от 29.08.2025)

Версия: v.0.0.5 (2025-09-09)

Метод GetTag

Получение этикетки осуществляется HTTP POST запросом на адрес [http://x.x.x.x:8041/GetTag]

Запрос должен иметь следующие параметры:

  • "phone" - [число][обязательный] - абонентский номер, для которого запрашивается этикетка
  • "ext" - [0,1][опциональный] - запрос расширенной информации. При значении [1] ответ будет содержать все данные, указанные ниже. При значении [0] или отсутсвии параметра в ответе будет передаваться усеченный набор данных.
  • "pub_key" - [строка][опциональный] - публичный ключ для шифрования ответа (JSONа). В этой версии параметр игнорируется.

Запрос возвращает один из следующих результатов:

HTTP Status code: 200(Ok)

В теле ответа JSON следующей структуры (для варианта без шифрования, вариант с шифрованием будет описан в следующих версиях):

{
 "data": "ew0KCSJwaG9uZSI6IDc0OTUxMTE4MTExLA0KCSJ0dGwiOiDQktGA0LXQvNGPINCw0LrRgtGD0LDQu9GM0L3QvtGB0YLQuCDQvtGC0LLQtdGC0LAgKNC80LjQvdGD0YIpLCANCgkidGFnX2N5ciI6ICLQotC10LrRgdGCINGN0YLQuNC60LXRgtC60LgiLA0KCSJ0YWdfbGF0IjogIlRleHQgZXRpa2V0a2kiLA0KCSJjYXRfbnVtIjogSUQg0LrQsNGC0LXQs9GA0LjQuCDQsNCx0L7QvdC10L3RgtCwICgwIC0g0YTQuNC30LjRh9C10YHQutC+0LUg0LvQuNGG0L4uID4wIC0gaWQg0LrQsNGC0LXQs9C+0YDQuNC4INC/0L4g0YHQv9GA0LDQstC+0YfQvdC40LrRgyDQmtC+0LvRhdC+0LfQsCwg0LLRi9GH0LjRgdC70LXQvdC90L7QtSDQuNC3INCe0JrQktCt0JQg0LDQsdC+0L3QtdC90YLQsCksIA0KCSJjYXRfY3lyIjogItCd0LDQt9Cy0LDQvdC40LUg0LrQsNGC0LXQs9C+0YDQuNC4IiwNCgkiY2F0X2xhdCI6ICJOYXp2YW5pZSBrYXRlZ29yaWkiLA0KCSJtYXNzX2NhbGwiOiDQmtC+0LvQuNGH0LXRgdGC0LLQviDRg9C90LjQutCw0LvRjNC90YvRhSDQsNCx0L7QvdC10L3RgtC+0LIg0JEg0LfQsCDQv9C+0YHQu9C10LTQvdC40LUgNyDQtNC90LXQuSwNCn0"
 "sig": "6ed88729a4c6879d162eb4084009e3218536ff96f542cefaf5e7c33c42628119"
}

Где:

data - json закодированный в BASE64 и соответствующий следующей структуре:
{
  "phone": 74951118111,
  "ttl": Время актуальности ответа (минут), 
  "tag_cyr": "Текст этикетки",
  "tag_lat": "Text etiketki",
  "cat_num": ID категрии абонента (0 - физическое лицо. > 0 - id категории по справочнику Колхоза, вычисленное из ОКВЭД абонента), 
  "mass_call": Количество уникальных абонентов Б за последние 7 дней,
}

sig - подпись, вычисленная для строки "data", по ГОСТ Р 34.10-2012 256 бит (функция хэширования ГОСТ Р 34.11-2012 256 бит). Открытый ключ для проверки подписи будет опубликован позднее.

307 (Out of service)

Необходимо повторить запрос к резервному сервису

403 (Forbidden)

Получение этикетки запрещено, на УВр на найден активный вызов абонента.

404 (Not Found)

Этикетка не найдена в базе данных.