Skip to content
This repository has been archived by the owner on Jul 4, 2023. It is now read-only.

Latest commit

 

History

History
59 lines (42 loc) · 1.59 KB

readme.md

File metadata and controls

59 lines (42 loc) · 1.59 KB

Orizuru OpenAPI schema generator

Build Status NSP Status

Orizuru OpenAPI generator is a module that can generate an OpenAPI document from a map of service name to Avro schemas. Each schema represents an input event that is exposed as a POST path, within the OpenAPI definition.

Currently OpenAPI version 2.0 documents are generated.

Install

$ npm install @financialforcedev/orizuru-openapi

Usage

const
	openapiGenerator = require('@financialforcedev/orizuru-openapi').generator;

schemaMap = {
  'question': require('./question')
};
 
app.get('/openapi/v2', openapiGenerator.generateV2({
	info: {
		version: '1.0.0',
		title: 'Test',
		description: 'My description'
	}, 
	host: 'localhost:3000', 
	basePath: '/api', 
	schemes: ['http']
}, schemaMap));

Response schema

The Orizuru project is aimed at asynchronous use cases, so the response schema is always a simple id string.

schema: {
	type: 'object',
	required: ['id'],
		properties: {
		id: {
			type: 'string'
		}
	}
}

API Docs

Click to view JSDoc API documentation.