OpenAPI

يُقدَّم دون استيثاق على /openapi.json، لأن مولّد العملاء يحتاجه ليعرف كيف يستوثق، واشتراط مفتاح لمعرفة ذلك كان سيصير دورة مفرغة.

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

مخططات الطلب مشتقة من نفس zod الذي يتحقق منها، فلا يمكن للمستند أن يصف حقلًا يرفضه الخادم. والمواصفة المكتوبة يدويًا هي وصف ثانٍ للـ API ينحرف بصمت، وشكل الإخفاق هو عميل مُولَّد يرسل شيئًا يرفضه الخادم، وهو ما يبدو كخطأ في العميل.