JSON-WSP

JSON-WSP to protokół usługi internetowej , który wykorzystuje JSON do opisu usługi, żądań i odpowiedzi. Jest inspirowany JSON-RPC , ale brak specyfikacji opisu usługi z dokumentacją w JSON-RPC zainspirował projekt JSON-WSP.

Format opisu ma ten sam cel dla JSON-WSP, co WSDL dla SOAP lub IDL dla CORBA , czyli opisanie typów i metod używanych w danej usłudze. Opisuje również relacje między typami (tj. typy zagnieżdżone) i definiuje, które typy są oczekiwane jako argumenty metody i jakich typów użytkownik może oczekiwać jako wartości zwracanych przez metodę. Wreszcie opis otwiera możliwość dodania dokumentacji dotyczącej poziomów usług, metod, parametrów i zwrotów.

Komunikacja pomiędzy klientami a serwerem JSON-WSP odbywa się za pomocą żądań i odpowiedzi HTTP POST , z obiektami JSON jako danymi z typem content application/json.

Specyfikacje

JSON-WSP składa się z czterech specyfikacji obiektów JSON:

Specyfikacja	Opis
opis	Specyfikacja opisu usługi (jak WSDL ). Ta specyfikacja opisuje metody, parametry metod, typy i zwracane typy. Obsługuje również dokumentację użytkownika dotyczącą poziomów usług, metod i parametrów.
wniosek	Specyfikacja żądań JSON. Zawiera informacje o tym, która metoda ma zostać wywołana oraz wszystkie argumenty wywołania metody. Argumenty w żądaniu muszą być zgodne z definicją parametru tej samej metody opisanej w odpowiednim opisie JSON-WSP.
odpowiedź	Specyfikacja odpowiedzi JSON. Obiekt odpowiedzi zawiera wynik wywołania metody usługi. Zwracany typ musi być zgodny ze zdefiniowanym typem zwracanym tej samej metody w odpowiednim opisie JSON-WSP.
wada	Specyfikacja odpowiedzi na błędy JSON. Obiekt błędu zawiera kod błędu i łańcuch błędu. Informacje o błędzie określają, czy błąd wystąpił po stronie klienta, czy serwera. W zależności od struktury usługi po stronie serwera można uzyskać bardziej szczegółowe informacje, tj. nazwę pliku i numer wiersza, w którym wystąpił błąd.

lepsze informacje https://en.wikipedia.org/w/index.php?oldid=757972316