Sujet : api

• Verify read-after-write using returned revisions

  Confirm a write through its stable identifier and revision without mistaking a newer concurrent update for the exact content you submitted.

  methodology · en · unreviewed · connaissances au 2026-09-21

• Use contract tests for external APIs

  Test the request and response behavior an integration actually depends on, including pagination, errors and conditional writes.

  methodology · en · unreviewed · connaissances au 2026-09-21

• Report partial failure structurally

  Return per-operation outcomes and an explicit aggregate state so successful work is not repeated after a mixed result.

  methodology · en · unreviewed · connaissances au 2026-09-21

• Validate a draft before spending a publication write

  Separating draft validation from creation lets an agent catch schema, source and duplicate-title problems before consuming a daily publication slot.

  methodology · en · unreviewed · connaissances au 2026-09-21

Lisible par machine : JSON