REST

“What we want is rest,” said Harris.

“Rest and a complete change,” said George. “The overstrain upon our
brains has produced a general depression throughout the system. Change
of scene, and absence of the necessity for thought, will restore the
mental equilibrium.”

Three Men in a Boat (To Say Nothing of the Dog)

1. Short glossary: https://developer.mozilla.org/en-US/docs/Glossary/REST

2. Responce status codes

   https://www.restapitutorial.com/httpstatuscodes https://developer.mozilla.org/en-US/docs/Web/HTTP/Status

3. Headers https://en.wikipedia.org/wiki/List_of_HTTP_header_fields

4. Test sites that are used in dotnet docs snippets. For example https://github.com/dotnet/docs/blob/main/docs/fundamentals/networking/telemetry/snippets/metrics/Program.cs, etc

   • https://httpbin.org
   • https://github.com/postmanlabs/httpbin
   • https://jsonplaceholder.typicode.com

5. Api guidelines (source https://apistylebook.com)

   • https://github.com/Microsoft/api-guidelines
   • https://microsoft.github.io/code-with-engineering-playbook/documentation/guidance/rest-apis/
   • https://microsoft.github.io/code-with-engineering-playbook/design/design-patterns/rest-api-design-guidance/

   • https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md

   • https://github.com/CiscoDevNet/api-design-guide
   • https://github.com/Haufe-Lexware/api-style-guide/tree/master
   • https://github.com/cloudfoundry/cloud_controller_ng/blob/main/docs/v3_style_guide.md

   • https://github.com/WhiteHouse/api-standards/tree/master

   • https://geemus.gitbooks.io/http-api-design/content/en/

   • https://google.aip.dev/1

   • https://developer.paypal.com/docs/api/invoicing/v2/

   • https://apiguide.readthedocs.io/en/latest/

   • https://restful-api-design.readthedocs.io/en/latest/

   • https://adidas.gitbook.io/api-guidelines

   • https://opensource.zalando.com/restful-api-guidelines/

   • https://developer.atlassian.com/server/framework/atlassian-sdk/atlassian-rest-api-design-guidelines-version-1/
   • https://developer.atlassian.com/platform/marketplace/atlassian-rest-api-policy

6. Api examples

   • Twitter: https://developer.twitter.com/en/docs/api-reference-index
   • Facebook: https://developers.facebook.com/docs/reference/api/
   • LinkedIn: https://developer.linkedin.com/apis
   • Github: https://api.github.com/