OpenAPI

Se sirve sin autenticación en /openapi.json, porque un generador de clientes lo necesita para saber cómo autenticarse, y exigir una clave para averiguarlo sería un círculo vicioso.

curl -s https://api.openemail.uk/openapi.json -o openemail.jsonopenapi-generator generate -i openemail.json -g python -o ./client

Los esquemas de solicitud se derivan del mismo zod que los valida, así que el documento no puede describir un campo que el servidor rechazaría. Una especificación escrita a mano es una segunda descripción de la API que diverge en silencio, y el modo de fallo es un cliente generado que envía algo que el servidor rechaza, lo que parece un error del cliente.