microsoft/api-guidelines
View on GitHub ↗ ★ 23,340
Microsoft REST API Guidelines
21 mentions on Hacker News by 21 people: 6 stories, 15 comments · first 2016-07-19 · latest 2023-08-31
20082026
-
https://github.com/microsoft/api-guidelines/blob/vNext/Guide...
comment by hbcondo714 · 2023-08-31 · in Ask HN: Any book recommendations for API design? -
…to what comes in body is mostly convention and there are no standards. Here is an example for rest: https://github.com/Microsoft/api-guidelines/blob/master/Guid... JSON-RPC is a bit more concrete: https://www.jsonrpc.org/specification#error…
comment by fleetfox · 2021-12-08 · in Ask HN: Standards for API Error Responses? -
▲ 3
Microsoft REST API Guidelinesstory by rrampage · 2021-02-28 · 0 comments
-
I’ve also found the Microsoft API guidelines helpful (especially for error handling). https://github.com/microsoft/api-guidelines/blob/vNext/Guide...
comment by struct · 2021-02-22 · in Best practices for REST API design (2020) -
https://github.com/microsoft/api-guidelines REST API guidelines from Microsoft
comment by ayush--s · 2020-09-05 · in Ask HN: Suggestions for books about API design? -
…although they don't cover funky important details like how to properly do REST operations/actions. https://github.com/microsoft/api-guidelines This is short one based on RedHat VM engineer experience: https://restful-api-design.readthedocs.…
comment by majkinetor · 2020-09-05 · in Ask HN: Suggestions for books about API design? -
…to look at standards like OData, JSON:API,or even just for example [Microsoft REST API guidelines]( https://github.com/microsoft/api-guidelines ). REST by itself is a pretty general description of a type of architecture that isn't even…
comment by treve · 2020-07-08 · in A REST View of GraphQL -
▲ 4
Microsoft REST API Guidelinesstory by muhammedkilic · 2020-02-19 · 0 comments
-
…to get right but with this you can pretty much copy and paste their guidelines for your project. 0: https://github.com/Microsoft/api-guidelines/blob/master/Guid...
comment by laurent123456 · 2019-11-22 · in Microsoft REST API Guidelines -
What do other folks here think of how MS handles query params, specifically stuff like filtering? https://github.com/Microsoft/api-guidelines/blob/master/Guid... When working with the Graph API for 365 I thought it was really weird how you…
comment by jmuguy · 2019-11-22 · in Microsoft REST API Guidelines -
▲ 419
Microsoft REST API Guidelinesstory by excerionsforte · 2019-11-22 · 161 comments
-
Here are some links that are useful: 1. https://github.com/Microsoft/api-guidelines/blob/master/Guid... 2. https://cloud.google.com/apis/design/ 3. https://mattgemmell.com/api-design/ 4. Video from Jim Webber -…
comment by the_arun · 2019-05-18 · in Standards.REST: A Collection of HTTP/REST API Standards and Specs -
If you wish to see everything in one single doc page. https://github.com/Microsoft/api-guidelines/blob/vNext/Guide...
comment by ameyv · 2019-04-09 · in REST Introduction -
▲ 4
Microsoft/api-guidelines – Microsoft REST API Guidelinesstory by pestkranker · 2019-01-03 · 0 comments
-
…without the model metadata piece pretty easily - but that metadata piece adds a lot of value. [1] https://github.com/Microsoft/api-guidelines/blob/vNext/Guide... - see sections on sorting, filtering etc.
comment by sixdimensional · 2018-08-24 · in Why use GraphQL, good and bad reasons -
…[1] here, which is also a well written document and can be helpful to anyone designing an API. [1]: https://github.com/Microsoft/api-guidelines/blob/master/Guid...
comment by andreygrehov · 2017-02-22 · in API Design Guide -
▲ 15
Microsoft REST API Guidestory by aligajani · 2016-09-29 · 2 comments
-
…API with WCF - https://msdn.microsoft.com/en-us/library/dd203052.aspx 2. Restful API using WebAPI - https://github.com/Microsoft/api-guidelines/blob/master/Guid... 3. API via dll - https://www.amazon.com/Framework-Design-Guidelines-Conventi…
comment by mandeepj · 2016-08-10 · in Ask HN: What are good reads for designing APIs? -
…collection, you would not use Client-driven paging, but only rely on Server-driven paging [1] https://github.com/Microsoft/api-guidelines/blob/master/Guid...
comment by vmarsy · 2016-07-19 · in Microsoft REST API Guidelines -
Funny that Microsoft uses OData as an example of a bad URL: https://github.com/Microsoft/api-guidelines/blob/master/Guid... Whilst continuing to praise OData as "the best way to REST" - http://www.odata.org
comment by mythz · 2016-07-19 · in Microsoft REST API Guidelines -
▲ 339
Microsoft REST API Guidelinesstory by alpb · 2016-07-19 · 142 comments