Um contrato de API nomeia a operação, identifica o recurso e define o que quem chama recebe. Uma leitura não deveria criar um pedido como efeito colateral. Um endpoint de criação precisa de uma resposta e de um comportamento de falha definidos para que quem chama consiga se recuperar quando uma resposta se perde. Em escritas que admitem nova tentativa, uma chave de idempotência identifica uma única operação pretendida ao longo de requisições repetidas. O servidor deve armazenar ou impor essa identidade junto com o resultado da operação.
A paginação precisa de uma ordem estável. A paginação por offset pode pular ou repetir linhas quando linhas anteriores são inseridas ou removidas. Um cursor que usa uma chave de ordenação e um critério de desempate único consegue continuar a partir de um limite conhecido. Os exercícios verificam a estrutura do endpoint e o comportamento fundamentado, não a sintaxe de um fornecedor. Informe os campos de que quem chama precisa e explique o que acontece diante de um timeout, uma escrita duplicada ou timestamps iguais.
Defina operações que admitem nova tentativa e limites de página estáveis.