Formalize OGRDB API with OpenAPI V3 spec

airr-knowledge / issues

Issues and project management for the AKC

0 stars 0 forks source link

Formalize OGRDB API with OpenAPI V3 spec #36

Open schristley opened 3 months ago

schristley commented 3 months ago

AKC will primarily interact with OGRDB through a defined OpenAPI V3 spec.

[ ] OpenAPI V3 spec file in GitHub repository, versioned and tagged.
[ ] Request and response schemas linked to AIRR and/or CDM.
[ ] Review and suggest any enhancements.

schristley commented 3 months ago

Hi @williamdlees , issue to track OGRDB API work. We should create one for VDJbase at some point, but might need more clarity on the data and its schema first.

schristley commented 3 months ago

Using pydantic to validate the outgoing response object sounds like a reasonable solution. There is a difference with how OpenAPI V2 and V3 defines request parameters, but it's not necessary for your flask middleware to use V3, you can "fake it" just by manually making sure the V3 spec and your flask code are in sync. Because your endpoints and request parameters are fairly simple, that manually sync'ing shouldn't be onerous.