API
OpenAPI
A referência legível por máquina.
O documento
Servido sem autenticação em /openapi.json, porque um gerador de clientes precisa dele para saber como se autenticar, e exigir uma chave para aprender isso seria um círculo.
curl -s https://api.openemail.uk/openapi.json -o openemail.jsonopenapi-generator generate -i openemail.json -g python -o ./clientOs esquemas de pedido derivam do mesmo zod que os valida, por isso o documento não pode descrever um campo que o servidor recusaria. Uma especificação escrita à mão é uma segunda descrição da API que se desatualiza em silêncio, e o modo de falha é um cliente gerado a enviar algo que o servidor recusa, o que parece um bug do cliente.