Jika anda masih tidak menggunakan bahasa definisi untuk spesifikasi API yang boleh dibaca mesin, seperti OpenAPI (dahulunya dikenali sebagai Swagger), anda pasti perlu mempertimbangkan untuk berbuat demikian. Lagipun, API ialah bahasa untuk mesin bercakap antara satu sama lain.
Adakah Swagger idea yang bagus?
Swagger membuat kesan pertama yang sangat baik Selain itu, ramai orang berpendapat bahawa kemungkinan untuk menjana kod daripada dokumentasi adalah idea yang baik dan Swagger menyediakannya juga. Oleh itu, hakikat bahawa kesombongan membuat kesan pertama yang hebat, menjadikan batasan dan kekangannya kurang jelas.
Apakah tujuan menggunakan Swagger?
Swagger membolehkan anda menerangkan struktur API anda supaya mesin boleh membacanya. Keupayaan API untuk menerangkan strukturnya sendiri ialah punca semua kehebatan dalam Swagger.
Adakah Swagger masih digunakan?
Hari ini, ramai pengguna masih menggunakan istilah " Swagger" untuk merujuk kepada format OpenAPI 2.0 Specification dan "Swagger spec" untuk merujuk kepada dokumen penerangan API dalam format ini. RepreZen API Studio menggunakan istilah ini dalam beberapa bahagian UI, tetapi merujuk kepada OpenAPI 3.0 dan versi yang lebih baru sebagai "OpenAPI. "
Adakah kesombongan hanya untuk REST API?
Spesifikasi OpenAPI (dahulunya Spesifikasi Swagger) ialah format perihalan API untuk REST API. Fail OpenAPI membolehkan anda menerangkan keseluruhan API anda, termasuk: Titik akhir yang tersedia (/pengguna) dan operasi pada setiap titik akhir (GET /pengguna, POST /pengguna)
