Un contrato de API nombra la operación, identifica el recurso e indica qué recibe quien llama. Una lectura no debería crear un pedido como efecto secundario. Un endpoint de creación necesita una respuesta y un comportamiento ante fallos definidos para que quien llama pueda recuperarse cuando se pierde una respuesta. En las escrituras reintentables, una clave de idempotencia identifica una operación prevista a lo largo de peticiones repetidas. El servidor tiene que guardar o hacer cumplir esa identidad junto con el resultado de la operación.
La paginación necesita un orden estable. La paginación por desplazamiento (offset) puede saltarse o repetir filas cuando se insertan o eliminan filas anteriores. Un cursor que usa una clave de orden y un desempate único puede continuar desde un límite conocido. Los ejercicios comprueban la estructura del endpoint y un comportamiento razonado, no la sintaxis de un proveedor. Escribe los campos que necesita quien llama y explica qué pasa ante un tiempo de espera agotado, una escritura duplicada o marcas de tiempo iguales.
Define operaciones reintentables y límites de página estables.