Si encara no esteu utilitzant un llenguatge de definició per a especificacions d'API llegibles per màquina, com ara OpenAPI (abans conegut com Swagger), definitivament hauríeu de considerar fer-ho. Després de tot, les API són idiomes perquè les màquines es parlin entre elles.
És Swagger una bona idea?
Swagger fa una primera impressió molt bona A més, molta gent pensa que la possibilitat de generar codi a partir de la documentació és una bona idea i Swagger ho proporciona també. Per tant, el fet que l'arrossegament faci una primera impressió fantàstica fa que les seves limitacions i limitacions siguin menys evidents.
Quin és el propòsit d'utilitzar Swagger?
Swagger us permet descriure l'estructura de les vostres API perquè les màquines les puguin llegir. La capacitat de les API per descriure la seva pròpia estructura és l'arrel de totes les meravelles de Swagger.
Swagger encara s'utilitza?
Avui, molts usuaris encara fan servir els termes " Swagger" per referir-se al format d'especificació d'OpenAPI 2.0 i "Swagger spec" per fer referència a un document de descripció de l'API en aquest format. RepreZen API Studio utilitza aquests termes en algunes parts de la interfície d'usuari, però fa referència a OpenAPI 3.0 i versions posteriors com a "OpenAPI ".
Swagger només és per a l'API REST?
OpenAPI Specification (anteriorment Swagger Specification) és un format de descripció de l'API per a les API REST. Un fitxer OpenAPI us permet descriure tota la vostra API, incloent: Punts finals disponibles (/users) i operacions a cada punt final (GET /users, POST /users)
