Hacker GitHub

← All repos

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

Mentions per year 21 mentions · busiest year 2019 (6)
20082026
AllStoriesComments NewestTopOldest
  1. https://github.com/microsoft/api-guidelines/blob/vNext/Guide...
    comment by hbcondo714 · 2023-08-31 · in Ask HN: Any book recommendations for API design?
  2. …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. 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)
  4. 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?
  5. …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?
  6. …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
  7. …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
  8. 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
  9. 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
  10. 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
  11. …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
  12. …[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
  13. …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?
  14. …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
  15. 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