Best practices в проекте API

Язык по умолчанию

Английский — язык ответа API по умолчанию. Все эндпоинты принимают GET параметр запроса lang. В случае если он не указан, ответ отдается на английском языке, как если бы был указан параметр lang=en.

Многие сущности, такие как категории болезней и аннотации Gene Ontology, парсятся изначально на английском, затем для них добавляется перевод. Важно вернуть название сущности в случае, если перевод отсутствует. Для этого там, где в моделях ответа используется плейсхолдер @LANG@, используйте SQL функцию coalesce, чтобы вернуть первое непустое значение:

'term': 'COALESCE(gene_ontology.name_@LANG@,gene_ontology.name_en)',