Для начала - унифицировать формат вывода. Можно остановиться только на json, или просто указывать формат вывода в параметрах - json/txt/html/xml. Для json - нужно будет описать и зафиксировать документацией поля возвращаемого объекта. Нужны ли другие форматы вывода - смотри по месту. txt может быть удобен для тестирования и отладки АПИ.
Если предполагается продолжительное существование проекта - нужно добавить в json поле - "версия" АПИ