Preguntas frecuentes

¿Por qué el cuerpo de la solicitud/respuesta aparece vacío aunque haya un objeto de esquema?

Comprueba que tu objeto de esquema defina un tipo. Si no lo hace, mostraremos el texto <type> en la tabla. properties por sí solo no basta para indicar que el esquema es un objeto.

Por ejemplo:

¿Cómo reordeno las operaciones?

Las operaciones (por ejemplo, GET /version , POST /reference) se ordenan según el orden que tienen en la propia definición de OpenAPI. Usamos tags para agrupar las operaciones, pero no modificamos el orden. Por ejemplo:

Puedes reordenar las operaciones en tu definición de OpenAPI como necesites para crear el recorrido adecuado para tus lectores.

Para reordenar, abre la referencia en nuestro API Editor y edita el orden de las rutas, operaciones o etiquetas directamente en la vista Source; la referencia se vuelve a renderizar en ese orden al guardar.