OpenAPI

Servi sans authentification sur /openapi.json, parce qu'un générateur de client en a besoin pour savoir comment s'authentifier, et qu'exiger une clé pour l'apprendre serait un cercle vicieux.

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

Les schémas de requête sont dérivés du même zod qui les valide, si bien que le document ne peut pas décrire un champ que le serveur rejetterait. Une spécification écrite à la main est une seconde description de l'API qui dérive en silence, et le mode de défaillance est un client généré qui envoie quelque chose que le serveur refuse, ce qui ressemble à un bug du client.