OpenAPI

Servírováno bez autentizace na /openapi.json, protože generátor klienta ho potřebuje k tomu, aby věděl, jak se autentizovat, a vyžadovat klíč k tomu, aby se to dozvěděl, by byl kruh.

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

Schémata požadavků se odvozují z téhož zodu, který je validuje, takže dokument nemůže popsat pole, které by server odmítl. Ručně psaná specifikace je druhý popis API, který se tiše rozchází, a projeví se to tak, že vygenerovaný klient posílá něco, co server odmítá – a vypadá to jako chyba klienta.