Volver al glosario
API / Developer

OpenAPI

También conocido como: Swagger, OAS

Definición

OpenAPI (antes Swagger) es el estándar abierto para describir APIs REST en formato YAML/JSON. Permite generar documentación interactiva, SDKs y mock servers automáticamente.

Contexto LATAM

Una OpenAPI spec describe cada endpoint, parámetros, schemas de request/response, autenticación y ejemplos. Es el lenguaje compartido entre devs frontend, backend y herramientas de testing.

Ejemplo concreto

Con la spec OpenAPI de finO$, generas un SDK en Go usando openapi-generator: `openapi-generator-cli generate -i finos-openapi.yaml -g go -o ./finos-go-sdk`.

¿Cómo lo maneja finO$?

finO$ publica su OpenAPI spec en /api/openapi.yaml. Pull requests bienvenidos en el repo finos-ai/openapi en GitHub.

Términos relacionados

¿Necesitas convertir estados de cuenta bancarios a JSON estructurado?