Document Avram API with OpenAPI, request and response format to be defined

The API to query PICA/MARC/MAB fields needs to be refactored anyway (#23). Parameters could be:

schema: Schema URL/URI
path: field and optional subfield

However endpoints for selected schemas (e.g. MARC21 bibliographic) are more convenient. The endpoint should tell which schema its results come from, e.g.:

{
  "http://format.gbv.de/pica/zdb-address/schema.json": {
    "format": "http://format.gbv.de/pica/zdb-address",
    "fields": { ... }
  },
  "http://example.org/another-schema.json": {
    "format": "uri:of:the:format:defined:by:this:schema",
    "fields": { ... }
  }
}

[
  { 
    "source": "http://format.gbv.de/pica/zdb-address/schema.json",
    "format": "http://format.gbv.de/pica/zdb-address",
    "fields": { ... }
  },
  {
    "source": "http://example.org/another-schema.json",
    "format": "uri:of:the:format:defined:by:this:schema",
    "fields": { ... }
  }
]

gbv / format.gbv.de

Document Avram API with OpenAPI, request and response format to be defined #29