Opišite razmjenu
Za svaku operaciju dokumentujte metod, resurs, obavezna polja i strukturu uspješnog odgovora. Uključite i grešku pri provjeri ispravnosti. Razlikujte grešku u prenosu od odbijenog zahtjeva: izostanak odgovora ne dokazuje da operacija koja mijenja stanje nije uspjela.
Tretirajte pristupne podatke kao konfiguraciju
Držite serverske pristupne podatke van paketa za pregledač i repozitorijuma izvornog koda. Zatražite najmanji koristan skup dozvola i odvojite razvojni pristup od produkcionog. Zabilježite ko je odgovoran za svaku integraciju i kako se pristup može opozvati. Slijedite dokumentovani tok autorizacije pružaoca usluge.
Planirajte slučaj nedostupnih zavisnosti
Postavite vremenska ograničenja, poštujte smjernice o ograničenju učestalosti zahtjeva i ponavljajte operaciju samo kada je to bezbjedno. Kada je podržan, ključ idempotentnosti može prepoznati ponovljene zahtjeve. U dnevnik zabilježite identifikator zahtjeva i sažetu kategoriju greške; izostavite zaglavlja za autorizaciju, kolačiće sesije i sadržaj s ličnim podacima.