Explorar definiciones API y generar código de solicitud

Pega la definición, elige un endpoint e introduce parámetros de ejemplo. Revisa el código antes de ejecutarlo en tu propio cliente API.

Se ejecuta localmente en tu navegador
Definición de API

Pega un documento OpenAPI 3.x o Swagger 2.0 en JSON o YAML. Esta herramienta no sube ni descarga nada.

Operaciones disponibles
Analiza una definición para explorar sus endpoints.
Generador de solicitudes

Elige un endpoint arriba para crear sus campos de ruta, consulta, cabecera y cuerpo.

Select an endpoint to generate a cURL command.
Select an endpoint to generate Fetch code.

Explora una especificación de API sin enviarla a ningún sitio

OpenAPI Explorer lee JSON o YAML local, muestra endpoints y campos obligatorios, y crea fragmentos de solicitud que puedes ajustar antes de usarlos en tu cliente de API. No envía solicitudes, tokens ni especificaciones a otro servicio.

Cómo construir una petición a partir de una definición

Pega una definición OpenAPI 3.x o Swagger 2.0 para listar todas las operaciones que declara, rellenar los parámetros que documenta y copiar un fragmento cURL o Fetch del endpoint que elijas.

La definición, la URL del servidor y el token Bearer permanecen en el navegador. El documento se analiza localmente y esta página no envía ninguna petición a tu API.

  1. Pega la definición en el editor en JSON o YAML, o pulsa Load example para partir de un ejemplo.
  2. Pulsa Analyze definition. La lista de operaciones muestra cada método y su ruta; si el documento no tiene marcador de versión o no tiene operaciones en paths, la línea de estado lo indica.
  3. Elige una operación para construir su formulario de parámetros a partir de la definición: campos de ruta, query y cabecera, además de un cuerpo de petición cuando la definición lo describe.
  4. Rellena los campos obligatorios. Todos los parámetros documentados deben estar presentes antes de generar código, y la línea de estado nombra el primero que falte.
  5. Pulsa Generate request code y luego Copy cURL o Copy Fetch. Define antes la URL del servidor o un token Bearer si el endpoint los necesita.

Qué hace y qué no hace el generador

Qué definiciones se aceptan

Se leen OpenAPI 3.x y Swagger 2.0, en JSON o YAML, y el marcador de versión determina cómo se interpretan servidores, parámetros y cuerpos de petición. Un documento sin ninguno de los dos marcadores se rechaza con un mensaje que indica el campo raíz que falta.

Las filas de operación se construyen a partir del objeto paths: una fila por método, etiquetada con la ruta y el resumen de la operación, o con "No summary provided" cuando la definición lo omite.

Los fragmentos generados son un punto de partida

VoriTools redacta la petición a partir de la definición y nunca la ejecuta. Esta página no envía nada a tu API, así que un token que escribas solo sirve para completar el texto del fragmento.

El fragmento incluye los parámetros y cabeceras que documenta la definición. Todo lo que no describa — reintentos, firma, paginación, flujos OAuth — hay que añadirlo en tu propio cliente.

Preguntas frecuentes

¿Esta herramienta llama a mi API?

No. Lee la definición y escribe código de petición; la petición nunca se ejecuta aquí, así que desde esta página no llega tráfico a tu API.

¿Qué formatos de definición son compatibles?

OpenAPI 3.x y Swagger 2.0, escritos en JSON o YAML. El marcador de versión en la raíz del documento determina cómo se interpreta cada campo.

Herramientas recientes: