HTTP интерфейс lnp_mnp

Выполняет LNP/MNP запрос и возвращает результат.

Аргументы

аргумент обязательный описание
_login да совпадает с логином пользователя/компании к личному кабинету
_password да совпадает с паролем пользователя/компании к личному кабинету
number да номер в формате E.164
request_id нет назначаемый клиентом ID запроса, будет возвращен клиенту в ответе

Возвращаемые данные

Сервер возвращает ответ в формате JSON API.
В ответе может присутствовать одно из:

errors и data не присутствуют в 1 ответе одновременно.
Каждый ответ содержит либо errors, либо data.

data может содержать следующие атрибуты:
атрибут обязательный описание
id да назначенный сервером ID запроса
type да "lnp_mnp"
number да запрошенный номер
status да ок - успешно получили информацию, за запрос списались деньги
error - не получили информацию, за запрос не списались деньги
lrn нет пусто - запрашиваемый E.164 номер не портирован,
не пусто - запрашиваемый E.164 номер портирован, возвращен номер для маршрутизации и биллинга
request_id да, если клиент передал request_id в запросе переданный клиентом аргумент
errors может содержать следующие атрибуты:
атрибут обязательный описание
code да Короткий код ошибки.
Может использоваться клиентом для условной обработки ошибки.
Не зависит от локали клиента.
detail да Детали ошибки.
Может использоваться клиентом для отображения в содержимом диалогового окна ошибки.
Может быть выдано сервером в локали клиента.
title да Заголовок ошибки.
Может использоваться клиентом для отображения в заголовке диалогового окна ошибки.
Может быть выдано сервером в локали клиента.

Примеры.

Запрос 1 номера

запрос GET "https://имя.вашего.сервера/api/lnp_mnp?number=79183035536&request_id=1&_login=LOGIN&_password=PASSWORD"
ответ
{
    "data" : {
        "attributes" : {
            "lrn" : "79800000000",
            "number" : "79183035536",
            "status" : "ok" 
        },
        "id" : "1561370632513",
        "meta" : {
            "request_id" : "1" 
        },
        "type" : "lnp_mnp" 
    }
}

Запрос 2 номеров

запрос GET "https://имя.вашего.сервера/api/lnp_mnp?number=79183035536&request_id=1&number=79183035537&request_id=2&_login=LOGIN&_password=PASSWORD"
ответ
{
    "data" : [
        {
            "attributes" : {
                "lrn" : "79800000000",
                "number" : "79183035536",
                "status" : "ok" 
            },
            "id" : "1561371433517",
            "meta" : {
                "request_id" : "1" 
            },
            "type" : "lnp_mnp" 
        },
        {
            "attributes" : {
                "lrn" : "",
                "number" : "79183035537",
                "status" : "ok" 
            },
            "id" : "1561371433518",
            "meta" : {
                "request_id" : "2" 
            },
            "type" : "lnp_mnp" 
        }
    ]
}

Ошибка

запрос GET "https://имя.вашего.сервера/api/lnp_mnp?number=79183035536&request_id=1&_login=LOGIN&_password=PASSWORD"
ответ
{
    "errors" : [
        {
            "code" : "authentication",
            "detail" : "Please check your login and password",
            "title" : "Authentication error" 
        }
    ]
}

English translation