Опишете обмена
За всяка операция документирайте метода, ресурса, необходимите полета и формата на успешния отговор. Включете грешка при валидация. Разграничете транспортна повреда от отхвърлена заявка: липсата на отговор не доказва, че операцията, променяща състоянието, е неуспешна.
Третирайте идентификационните данни като конфигурация
Дръжте сървърните идентификационни данни извън браузърните пакети и изходните хранилища. Искайте най-малкия полезен набор от разрешения и разделяйте достъпа за разработка от производствения достъп. Записвайте кой притежава всяка интеграция и как достъпът може да бъде отнет. Следвайте документирания от доставчика процес на авторизация.
Планирайте за недостъпни зависимости
Задайте таймаути, спазвайте указанията за ограничение на скоростта и опитвайте отново само когато операцията е безопасно да се повтори. Където е поддържано, ключ за идемпотентност може да идентифицира повтарящи се заявки. Записвайте идентификатор на заявката и кратка категория на неуспеха; избягвайте заглавки за оторизация, сесийни бисквитки и лични данни.