API documentation
Services developed with this library automatically also exposes the documentation of the routes and decorators that are implemented. The documentation is specified using the OpenAPI 2.0 standard and exhibited through Swagger.
Once the service is started, its documentation can be accessed at
route http://localhost:3000/documentation
.
The specification of the request scheme and responses to a route must conform to the format accepted by Fastify.
Example
const customService = require('@mia-platform/custom-plugin-lib')()
const schema = {
body: {
type: 'object',
properties: {
someKey: { type: 'string' },
someOtherKey: { type: 'number' }
}
},
querystring: {
name: { type: 'string' },
excitement: { type: 'integer' }
},
params: {
type: 'object',
properties: {
par1: { type: 'string' },
par2: { type: 'number' }
}
},
headers: {
type: 'object',
properties: {
'x-foo': { type: 'string' }
},
required: ['x-foo']
}
}
module.exports = customService(async function exampleService(service) {
service.addRawCustomPlugin('GET', '/endpoint', function handler(request,reply) { ... }, schema)
})