Descriviu l'intercanvi
Per a cada operació, documenta el mètode, el recurs, els camps requerits i la forma d'una resposta exitosa. Inclou un error de validació. Distingiu una fallada de transport d'una sol·licitud rebutjada: la manca de resposta no prova que una operació que canvia l'estat hagi fallat.
Tracta les credencials com a configuració
Mantingueu les credencials del servidor fora dels paquets del navegador i dels repositoris de codi font. Sol·liciteu el conjunt de permisos útil més petit i separeu l'accés de desenvolupament de l'accés a producció. Registreu qui posseeix cada integració i com es pot revocar l’accés. Seguiu el flux d’autorització documentat pel proveïdor.
Planifiqueu per dependències no disponibles
Estableix temps límit, respecta les indicacions sobre límit de taxa i torna a intentar només quan sigui segur repetir una operació. On sigui compatible, una clau d'idempotència pot identificar les sol·licituds repetides. Registra un identificador de sol·licitud i una categoria concisa de fallades; evita capçaleres d'autorització, galetes de sessió i dades personals.