Bỏ qua tới phần tài liệu
API

OpenAPI

Tài liệu tham chiếu mà máy có thể đọc.

Tài liệu

Được phục vụ không cần xác thực tại /openapi.json, vì trình tạo client cần nó để biết cách xác thực, và yêu cầu khóa để biết điều đó sẽ là một vòng luẩn quẩn.

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

Các schema yêu cầu được sinh ra từ chính zod dùng để xác thực chúng, nên tài liệu không thể mô tả một trường mà máy chủ sẽ từ chối. Một đặc tả viết tay là bản mô tả thứ hai của API và âm thầm lệch đi, và hậu quả là một client được sinh ra gửi thứ mà máy chủ từ chối, trông như lỗi của client.