API
OpenAPI
Mašīnlasāmā uzziņa.
Dokuments
Tiek pasniegts bez autentifikācijas adresē /openapi.json, jo klienta ģeneratoram tas ir vajadzīgs, lai uzzinātu, kā autentificēties, un prasīt atslēgu, lai to uzzinātu, būtu aplis.
curl -s https://api.openemail.uk/openapi.json -o openemail.jsonopenapi-generator generate -i openemail.json -g python -o ./clientPieprasījumu shēmas ir atvasinātas no tā paša zod, kas tos validē, tāpēc dokuments nevar aprakstīt lauku, ko serveris noraidītu. Ar roku rakstīta specifikācija ir otrs API apraksts, kas klusi noveco, un kļūmes veids ir ģenerēts klients, kurš sūta ko tādu, ko serveris atsaka, un tas izskatās pēc klienta kļūdas.