Distributed Computing with Go

Revisiting the API definition

Let's have another look at the API definition for Concierge, and discuss what the definition conveys regarding the expected behavior by the API and application:

# openapi/concierge.yamlopenapi: 3.0.0 servers: - url: /api info: title: Goophr Concierge API version: '1.0' description: > API responsible for responding to user input and communicating with Goophr Librarian. paths: /feeder: post: description: | Register new document to be indexed. responses: '200': description: | Request was successfully completed. content: application/json: schema: $ref: '#/components/schemas/response' '400': description: > Request was not processed because payload was incomplete or incorrect. content: application/json: schema: $ref: ...