Definim sistemul sursă, destinația, entitatea, identificatorul, direcția, frecvența și rezultatul. Contractul include câmpuri, tipuri, validări, versiune, erori și limite. Alegem sincron, asincron, polling sau webhook după proces și capacitatea furnizorilor. Stabilim cheia de idempotency, ordinea evenimentelor, retry-ul, dead-letter-ul și reconcilierea. Credențialele au proprietar, scope minim, rotație și mediu separat.
Maparea explică sensul fiecărui câmp și transformarea permisă. Statusurile nu sunt echivalate după etichetă dacă procesele diferă. Documentăm exemple reprezentative, valorile lipsă, fusurile orare, monedele, codificarea și regulile de actualizare. Mesajele de eroare și notificările ajută operatorul să distingă o validare, o indisponibilitate și o problemă de autorizare. Manualul de operare include reluarea sigură și verificarea efectului.
Title, H1, introducerea, secțiunile, exemplele, dovezile și legăturile interne trebuie să confirme aceeași intenție. Eliminăm afirmațiile pe care nu le putem susține și marcăm limitele informațiilor externe. Conținutul este scris pentru evaluare și acțiune, fără umplere, pagini doorway sau repetarea mecanică a aceleiași oferte pe variante de cuvinte.