Discussions

Ask a Question
Back to All

API Conventions for /api-specification

GET /api-specification returns a collection instead of single api and there is no GET /api-specification/{id} call. I would expect an /api-specifications endpoint to exist and return a collection

Would ReadMe be open to adopting the following?

GET /api-specifications

POST /api-specification

GET /api-specification/{id}

DELETE/api-specification/{id}

PUT /api-specification/{id}

Ref Google's api design guide https://cloud.google.com/apis/design/