Saltar para a documentação
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.

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

Os 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.