Opíšte výmenu
Pre každú operáciu zdokumentujte metódu, zdroj, požadované polia a štruktúru úspešnej odpovede. Zahrňte validačnú chybu. Rozlišujte medzi zlyhaním prenosu a odmietnutou požiadavkou: chýbajúca odpoveď nepreukazuje, že operácia meníca stav zlyhala.
Zaobchádzajte s povereniami ako s konfiguráciou
Uchovávajte poverenia servera mimo balíkov prehliadača a zdrojových úložísk. Požiadajte o najmenší užitočný súbor oprávnení a oddelujte prístup pri vývoji od prístupu do produkcie. Zaznamenajte, kto vlastní každú integráciu a ako možno prístup odvolať. Dodržujte dokumentovaný autorizačný tok poskytovateľa.
Plánujte pre nedostupné závislosti
Nastavte časové limity, dodržiavajte pokyny pre obmedzenie rýchlosti a opakujte iba vtedy, keď je operácia bezpečné zopakovať. Kde je podporované, môže kľúč idempotencie identifikovať opakované požiadavky. Zaznamenajte identifikátor požiadavky a stručnú kategóriu chyby; vyhnite sa hlavičkám autorizácie, session cookies a osobným údajom.