h1. HTTP интерфейс lnp_mnp Выполняет [[LNP/MNP запрос]] и возвращает результат. {{>toc}} h2. Аргументы |*аргумент*|*обязательный*|*описание*| |_login|да|совпадает с логином пользователя/компании к личному кабинету| |_password|да|совпадает с паролем пользователя/компании к личному кабинету| |number|да|номер в формате E.164| |request_id|нет|назначаемый клиентом ID запроса, будет возвращен клиенту в ответе| h2. Возвращаемые данные Сервер возвращает ответ в формате "JSON API":https://jsonapi.org/format/. В ответе может присутствовать одно из: * *errors*. Массив ошибок, возникших при обработке запроса. * *data*. JSON объект, содержащий результаты запроса, если запрос от клиента содержит 1 номер. Массив JSON объектов, если запрос от клиента содержит несколько номеров. *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|да|Заголовок ошибки. Может использоваться клиентом для отображения в заголовке диалогового окна ошибки. Может быть выдано сервером в локали клиента.| h2. Примеры. h3. Запрос 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" } }| h3. Запрос 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" } ] }| h3. Ошибка |*запрос*|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" } ] }| [[HTTP API lnp_mnp|English translation]]