api правильные заголовки для публичного и частного использования

Question

Хорошо, я создал свой личный сервер API, установил правильные коды ответов, управление содержимым и кэшем (например, 404 Not Found, application / json, no-cache, must-revalidate) Что еще можно установить (в заголовках) для достижения«идеальный» API?

Этот API является общедоступным, но в будущем планируется создание частного API для зарегистрированного пользователя.Есть ли какие-либо "настройки" заголовка для этого вида API (например, Unauthorized, WWW-Authenticate и т. Д.)

Answer 1

Вы можете добавить параметр для подавления HTTP-кодов.В Twitter есть параметр suppress_response_codes.Цитата из dev.twitter.com

suppress_response_codes: Если этот параметр присутствует, все ответы будут возвращены с кодом состояния 200 OK - даже ошибки.Этот параметр существует для поддержки приложений Flash и JavaScript, работающих в браузерах, которые перехватывают все не-200 ответов.Если он используется, то тогда задача клиента - определять состояния ошибок путем анализа тела ответа.Используйте с осторожностью, так как эти сообщения об ошибках могут измениться

Вот некоторые ресурсы для хорошего дизайна API RESTful.

1. Дизайн API Restful
2. Служба RESTful
3. Дизайн мобильного API - не ограничиваясь REST
4. Создание API REST с PHP