JSON-WSP

JSON-WSP — это протокол веб-службы , который использует JSON для описания службы, запросов и ответов. ^[1] Он основан на JSON-RPC , но отсутствие спецификации описания сервиса с документацией в формате JSON-RPC послужило толчком к разработке JSON-WSP.

Формат описания имеет ту же цель для JSON-WSP, что и WSDL для SOAP или IDL для CORBA , то есть описывает типы и методы, используемые в данной службе. Он также описывает отношения между типами (т. е. вложенные типы) и определяет, какие типы ожидаются в качестве аргументов метода, а какие типы пользователь может ожидать в качестве возвращаемых значений метода. Наконец, описание открывает возможность добавлять документацию по уровням сервиса, метода, параметра и возврата.

Связь между клиентами и сервером JSON-WSP осуществляется с помощью HTTP POST. ^[2] запросы и ответы с объектами JSON в качестве данных с типом контента application/json. ^[3]

Технические характеристики

JSON-WSP состоит из четырех спецификаций объектов JSON:

Спецификация	Описание
описание	Спецификация описания службы (например, WSDL ). Эта спецификация описывает методы, параметры метода, типы и типы возвращаемых значений. Он также поддерживает пользовательскую документацию на уровне сервисов, методов и параметров.
запрос	Спецификация для запросов JSON. Он содержит информацию о том, какой метод следует вызвать, и все аргументы для вызова метода. Аргументы в запросе должны подчиняться определению параметра того же метода, описанному в соответствующем описании JSON-WSP.
ответ	Спецификация ответов JSON. Объект ответа содержит результат вызова метода службы. Тип возвращаемого значения должен соответствовать типу возвращаемого значения того же метода, указанному в соответствующем описании JSON-WSP.
вина	Спецификация ответов на ошибки JSON. Объект неисправности содержит код неисправности и строку неисправности. Информация об ошибке указывает, произошла ли ошибка на стороне клиента или сервера. В зависимости от структуры службы на стороне сервера можно извлечь более подробную информацию, например, имя файла и номер строки, в которой произошла ошибка.

Ссылки

^ «ECMAScript – Спецификация языка 2017» (PDF) . Ecma-international.org . Архивировано из оригинала (PDF) 12 апреля 2015 года . Проверено 28 января 2018 г.
^ Рой, Филдинг; Джулиан, Решке (2014). Филдинг, Р; Решке, Дж. (ред.). «Протокол передачи гипертекста (HTTP/1.1): семантика и контент» . Tools.ietf.org . дои : 10.17487/RFC7231 . S2CID 14399078 . Проверено 28 января 2018 г.
^ «РФК 4627» . Архивировано из оригинала 17 июля 2011 г. Проверено 14 февраля 2011 г.

дополнительная информация https://en.wikipedia.org/w/index.php?oldid=757972316

[1] «ECMAScript – Спецификация языка 2017» (PDF) . Ecma-international.org . Архивировано из оригинала (PDF) 12 апреля 2015 года . Проверено 28 января 2018 г.

[2] Рой, Филдинг; Джулиан, Решке (2014). Филдинг, Р; Решке, Дж. (ред.). «Протокол передачи гипертекста (HTTP/1.1): семантика и контент» . Tools.ietf.org . дои : 10.17487/RFC7231 . S2CID 14399078 . Проверено 28 января 2018 г.

[3] «РФК 4627» . Архивировано из оригинала 17 июля 2011 г. Проверено 14 февраля 2011 г.

[1]

[2]

[3]