├── CONTRIBUTING.md ├── CONTRIBUTORS.md ├── LICENSE.md ├── README.md ├── SUMMARY.md ├── artifacts ├── README.md ├── describe-stability.md ├── provide-executable-examples.md ├── provide-human-readable-docs.md └── provide-machine-readable-json-schema.md ├── book.json ├── cover.jpg ├── cover_small.jpg ├── foundations ├── README.md ├── divide-large-responses-across-requests-with-ranges.md ├── provide-request-ids-for-introspection.md ├── require-secure-connections.md ├── require-versioning-in-the-accepts-header.md ├── separate-concerns.md └── support-etags-for-caching.md ├── requests ├── README.md ├── accept-serialized-json-in-request-bodies.md ├── downcase-paths-and-attributes.md ├── minimize-path-nesting.md ├── provide-full-resources-where-available.md ├── return-appropriate-status-codes.md ├── support-non-id-dereferencing-for-convenience.md └── use-consistent-path-formats.md └── responses ├── README.md ├── generate-structured-errors.md ├── keep-json-minified-in-all-responses.md ├── nest-foreign-key-relations.md ├── provide-resource-uuids.md ├── provide-standard-timestamps.md ├── show-rate-limit-status.md └── use-utc-times-formatted-in-iso8601.md /CONTRIBUTING.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/CONTRIBUTING.md -------------------------------------------------------------------------------- /CONTRIBUTORS.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/CONTRIBUTORS.md -------------------------------------------------------------------------------- /LICENSE.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/LICENSE.md -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/README.md -------------------------------------------------------------------------------- /SUMMARY.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/SUMMARY.md -------------------------------------------------------------------------------- /artifacts/README.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/artifacts/README.md -------------------------------------------------------------------------------- /artifacts/describe-stability.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/artifacts/describe-stability.md -------------------------------------------------------------------------------- /artifacts/provide-executable-examples.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/artifacts/provide-executable-examples.md -------------------------------------------------------------------------------- /artifacts/provide-human-readable-docs.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/artifacts/provide-human-readable-docs.md -------------------------------------------------------------------------------- /artifacts/provide-machine-readable-json-schema.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/artifacts/provide-machine-readable-json-schema.md -------------------------------------------------------------------------------- /book.json: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/book.json -------------------------------------------------------------------------------- /cover.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/cover.jpg -------------------------------------------------------------------------------- /cover_small.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/cover_small.jpg -------------------------------------------------------------------------------- /foundations/README.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/foundations/README.md -------------------------------------------------------------------------------- /foundations/divide-large-responses-across-requests-with-ranges.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/foundations/divide-large-responses-across-requests-with-ranges.md -------------------------------------------------------------------------------- /foundations/provide-request-ids-for-introspection.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/foundations/provide-request-ids-for-introspection.md -------------------------------------------------------------------------------- /foundations/require-secure-connections.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/foundations/require-secure-connections.md -------------------------------------------------------------------------------- /foundations/require-versioning-in-the-accepts-header.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/foundations/require-versioning-in-the-accepts-header.md -------------------------------------------------------------------------------- /foundations/separate-concerns.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/foundations/separate-concerns.md -------------------------------------------------------------------------------- /foundations/support-etags-for-caching.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/foundations/support-etags-for-caching.md -------------------------------------------------------------------------------- /requests/README.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/requests/README.md -------------------------------------------------------------------------------- /requests/accept-serialized-json-in-request-bodies.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/requests/accept-serialized-json-in-request-bodies.md -------------------------------------------------------------------------------- /requests/downcase-paths-and-attributes.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/requests/downcase-paths-and-attributes.md -------------------------------------------------------------------------------- /requests/minimize-path-nesting.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/requests/minimize-path-nesting.md -------------------------------------------------------------------------------- /requests/provide-full-resources-where-available.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/requests/provide-full-resources-where-available.md -------------------------------------------------------------------------------- /requests/return-appropriate-status-codes.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/requests/return-appropriate-status-codes.md -------------------------------------------------------------------------------- /requests/support-non-id-dereferencing-for-convenience.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/requests/support-non-id-dereferencing-for-convenience.md -------------------------------------------------------------------------------- /requests/use-consistent-path-formats.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/requests/use-consistent-path-formats.md -------------------------------------------------------------------------------- /responses/README.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/responses/README.md -------------------------------------------------------------------------------- /responses/generate-structured-errors.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/responses/generate-structured-errors.md -------------------------------------------------------------------------------- /responses/keep-json-minified-in-all-responses.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/responses/keep-json-minified-in-all-responses.md -------------------------------------------------------------------------------- /responses/nest-foreign-key-relations.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/responses/nest-foreign-key-relations.md -------------------------------------------------------------------------------- /responses/provide-resource-uuids.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/responses/provide-resource-uuids.md -------------------------------------------------------------------------------- /responses/provide-standard-timestamps.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/responses/provide-standard-timestamps.md -------------------------------------------------------------------------------- /responses/show-rate-limit-status.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/responses/show-rate-limit-status.md -------------------------------------------------------------------------------- /responses/use-utc-times-formatted-in-iso8601.md: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kcyeu/http-api-design/HEAD/responses/use-utc-times-formatted-in-iso8601.md --------------------------------------------------------------------------------