Misplaced Pages

JSON-WSP

Article snapshot taken from Wikipedia with creative commons attribution-sharealike license. Give it a read and then ask your questions in the chat. We can research this topic together.
Web service protocol
This article has multiple issues. Please help improve it or discuss these issues on the talk page. (Learn how and when to remove these messages)
The topic of this article may not meet Misplaced Pages's general notability guideline. Please help to demonstrate the notability of the topic by citing reliable secondary sources that are independent of the topic and provide significant coverage of it beyond a mere trivial mention. If notability cannot be shown, the article is likely to be merged, redirected, or deleted.
Find sources: "JSON-WSP" – news · newspapers · books · scholar · JSTOR (January 2018) (Learn how and when to remove this message)
This article needs additional citations for verification. Please help improve this article by adding citations to reliable sources. Unsourced material may be challenged and removed.
Find sources: "JSON-WSP" – news · newspapers · books · scholar · JSTOR (January 2018) (Learn how and when to remove this message)
(Learn how and when to remove this message)

JSON-WSP is a web service protocol that uses JSON for service description, requests and responses. It is inspired from JSON-RPC, but the lack of a service description specification with documentation in JSON-RPC sparked the design of JSON-WSP.

The description format has the same purpose for JSON-WSP as WSDL has for SOAP or IDL for CORBA, which is to describe the types and methods used in a given service. It also describes inter-type relations (i.e. nested types) and defines which types are expected as method arguments and which types the user can expect to receive as method return values. Finally the description opens the possibility to add documentation on service, method, parameter and return levels.

Communication between clients and a JSON-WSP server is carried out using HTTP POST requests and responses, with the JSON objects as data with the content-type application/json.

Specifications

JSON-WSP consists of four JSON object specifications:

Specification Description
description Service description specification (like WSDL). This specification describes methods, method parameters, types and return types. It also supports user documentation on service, method and parameter levels.
request Specification for JSON requests. It contains information about which method that is to be invoked and all the arguments for the method call. Arguments in the request must obey the parameter definition of the same method described in the corresponding JSON-WSP description.
response Specification for JSON responses. The response object contains the result of a service method invocation. The return type must obey the defined return type of the same method in the corresponding JSON-WSP description.
fault Specification for JSON fault responses. The fault object contains a fault code and a fault string. The fault information specifies whether the fault occurred on the client or server side. Depending on the server side service framework more detailed information can be extracted, i.e. the filename and line number where the fault occurred.

References

  1. "ECMAScript – 2017 Language Specification" (PDF). Ecma-international.org. Archived from the original (PDF) on 12 April 2015. Retrieved 28 January 2018.
  2. Roy, Fielding; Julian, Reschke (2014). Fielding, R; Reschke, J (eds.). "Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content". Tools.ietf.org. doi:10.17487/RFC7231. S2CID 14399078. Retrieved 28 January 2018.
  3. "RFC 4627". Archived from the original on 2011-07-17. Retrieved 2011-02-14.
Categories: