interagent/http-api-design
HTTP API design guide extracted from work on the Heroku Platform API
NOASSERTION
Issues
- 4
uuid in doubt
#102 opened by hujun8610 - 11
- 1
Dead link in about section
#104 opened by holly-hacker - 5
- 15
Explain why to version in accept header
#8 opened by justincy - 2
- 1
Json with PLSQL ( PLJSON)
#94 opened by flgarcia - 21
- 1
Test Framework
#91 opened by martindale - 5
- 3
Create a website (Gitpage)
#62 opened by weblancaster - 2
consider just having gh-pages version?
#32 opened by geemus - 8
Pagination using Range cannot be consistent
#87 opened by KellerFuchs - 42
- 15
Paginating/ranging over non-unique fields
#81 opened by bjeanes - 8
Consider compatibility with jsonapi.org?
#75 opened by ms-ati - 20
? semantic hinting
#33 opened by geemus - 10
Better example for the Resource Names
#39 opened by keithamus - 12
Why use UUID?
#79 opened by rafaelrabeloit - 4
Why have version in headers and not URLs?
#47 opened by sujaymansingh - 4
Explain every paragraph
#53 opened by ksimka - 0
detail expansions
#72 opened by geemus - 7
- 9
include more examples for main points
#70 opened by geemus - 12
Why no 204?
#15 opened by rikvanmechelen - 1
Consider adding language specific resources for implementing these principles
#68 opened by gooddadmike - 5
- 2
Using 409 Conflict for uniqueness checks
#61 opened by schatekar - 5
I'm curious to know the reasoning for going with JSON Schemas instead of Swagger
#59 opened by c4milo - 1
How are you modeling authentication operation?
#60 opened by schatekar - 9
Dealing With "ChoiceFields"
#57 opened by cooncesean - 7
- 3
Paginated search results
#52 opened by glenscott - 4
minimize path-nesting
#49 opened by geemus - 10
- 5
note down differences in PUT, POST and PATCH
#35 opened by rstacruz - 10
Shouldn't JSON properties be camelCase?
#18 opened by aronwoost - 11
Thoughts on authentication
#25 opened by rudolphfroger - 5
Suggest error codes
#34 opened by rstacruz - 4
- 4
the guide in Github Pages?
#26 opened by karlcoelho - 6
expand request-limiting guide to allow programmatic behavior response to rate limiting
#19 opened by jamesmanning - 3
- 7
- 0
- 1
Nest Foreign Key Relations
#12 opened by nateklaiber - 6
- 2