Importar referencias
Para cargar una nueva referencia o para sobrescribir una existente, puede hacerlo mediante nuestra API o a través del editor de la siguiente manera:
En la navegación superior del editor, abra el menú de secciones.
Haga clic en + New API reference.
Elija Upload OpenAPI definition.
Elija un archivo JSON o YAML válido de OpenAPI 2/3 (Swagger).
Espere hasta que la validación y el análisis hayan finalizado.
Al finalizar el análisis, se le notificará que la referencia se ha creado. Si el análisis o la validación fallan, aparecerá un error.
Si carga una referencia con el mismo título, su referencia se sobrescribirá y se actualizará. Su referencia anterior dejará de estar disponible.
Mejores prácticas para las referencias de API
Asegúrese de que cada operación tenga un ID de operación único. Los IDs de operación se utilizan en DeveloperHub para enlazar a los endpoints.
Fallo de validación
Le notificaremos los errores de validación detallados, si existen. Para corregirlos de forma interactiva, abra la referencia en nuestro API Editor. El panel de problemas de la parte inferior enumera cada error y, al hacer clic, salta a la línea problemática.
Limitaciones
El tamaño máximo de carga permitido es de 8MB.
Need help? Visit our community forums or contact us.