Apidog Docs
🇪🇸 Español
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇪🇸 Español
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇪🇸 Español
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. Publicar documentación de API
  • Back to home
  • Centro de soporte
  • Centro de soporte de Apidog
  • Importar/exportar
    • ¿Cómo importar datos de API en Apidog?
    • ¿Cómo importar cURL en Apidog?
    • ¿Cómo migrar entornos de Postman a Apidog?
    • ¿Cómo agrupar endpoints automáticamente al importar Swagger/OpenAPI?
  • Envío de peticiones
    • ¿Admite Apidog Socket.IO?
    • ¿Por qué el signo "+" en el valor del parámetro se decodifica como un espacio?
    • ¿Cómo enviar una petición en Apidog?
    • ¿Cómo enviar una petición GraphQL en Apidog?
    • ¿Cómo enviar una petición gRPC en Apidog?
    • ¿Cómo enviar una petición SOAP/WebService en Apidog?
    • ¿Cómo enviar una petición WebSocket en Apidog?
    • ¿Admite Apidog scripts previos a la petición/scripts de prueba y aserciones en las API WebSocket?
    • ¿Cómo enviar una petición SSE en Apidog?
    • ¿Cómo añadir encabezados predeterminados a nivel de carpeta?
    • ¿Admite Apidog scripts de pre-petición/prueba y aserciones en las API gRPC?
    • Error del resolvedor DNS ELANREFUSED.DNS
    • ¿Por qué recibo un error "socket hang up" al enviar una petición?
    • Corrección de errores de petición
      • Corrección del error read ECONNRESET
      • Corrección del error ECONNREFUSED
      • Corrección del error ETIMEDOUT
      • Solución del error ENOTFOUND: Couldn't resolve host
      • Corrección de ENOTFOUND: error getaddrinfo ENOTFOUND www
      • Solución del error connect EHOSTUNREACH
  • Diseño de APIs
    • ¿Cómo uso variables en la ruta?
    • ¿Puedo usar un componente de respuesta como respuesta predeterminada?
    • ¿Cómo comprobar quién ha modificado un endpoint?
    • ¿Cómo puedo eliminar carpetas de endpoints de forma masiva en Apidog?
    • ¿Cómo puedo agregar o eliminar prefijos de forma masiva en la ruta de los endpoints?
    • ¿Cómo mover el nivel de una propiedad en el Editor de esquemas?
    • Si una propiedad de cadena tiene varios valores enumerados y se utiliza en varias ubicaciones, ¿cómo se puede referenciar este enum de forma coherente en todas ellas?
    • ¿Cómo obtener el ID de la carpeta de recursos de Apidog?
    • ¿Cómo obtengo el ID de la carpeta de recursos de Apidog?
    • ¿Cómo uso variables en una ruta de URL?
    • ¿Qué debo hacer si un endpoint, documento o escenario de prueba se elimina accidentalmente?
    • ¿Apidog admite código de petición para endpoints personalizados?
    • ¿Cómo agrupar automáticamente endpoints al importar Swagger/OpenAPI en Apidog?
    • ¿Cómo genero datos de matriz no duplicados en respuestas mock?
    • ¿Por qué no se admite la entrada "#" en la ruta?
  • Depuración de APIs
    • ¿Cómo se integra Apidog con sistemas de gestión de claves de terceros?
    • ¿Por qué la misma petición funciona correctamente en otras herramientas (como Postman) pero no en Apidog?
    • ¿Cómo obtener valores de variables desde una base de datos en Apidog?
    • ¿Cómo migrar entornos desde otras herramientas a Apidog?
    • ¿Cómo realizar aserciones usando scripts en Apidog?
    • JSONPath solo puede extraer arrays. ¿Cómo puede extraer un solo elemento de ellos en Apidog?
    • ¿Cómo configurar operaciones de base de datos en Apidog cuando diferentes entornos tienen distintas credenciales de cuenta de base de datos?
    • ¿Cómo obtener la URL base del servicio en un script personalizado?
    • ¿Por qué Apidog informa un error que supera la longitud máxima de cadena de Node.js cuando la respuesta de la API es demasiado grande?
    • ¿Cuál es el límite de tamaño para la impresión en consola? ¿Por qué aparece un error al imprimir archivos grandes?
    • ¿Cómo resolver errores de conexión a la base de datos DB2 en Windows?
    • ¿Por qué aparece el error NJS-045 al conectarme a una base de datos Oracle en Apidog?
    • ¿Cómo generar valores dinámicos en scripts personalizados de Apidog?
    • ¿Por qué la petición del cliente al mismo endpoint se realiza correctamente, pero se produce un error al depurar en el lado web: "No se puede solicitar la dirección"?
    • ¿Por qué Apidog informa un error cuando la respuesta es demasiado grande?
    • ¿Cómo utilizo el endpoint de registro de Apidog?
    • Al definir la respuesta de un endpoint, ¿se permite que el endpoint no tenga contenido de respuesta?
    • ¿Cómo obtengo la baseURL del servicio en un script personalizado?
    • ¿Cómo puedo ver el paquete original en Apidog?
    • ¿Por qué veo el error "Invalid URI xxx" al realizar una petición?
    • ¿Cómo realizo una petición asíncrona en un script de Apidog?
    • ¿Por qué veo el mensaje "Couldn't resolve host" al enviar una petición?
    • ¿Cuál es el límite de tamaño de impresión de la consola? ¿Por qué aparece un error cuando imprimo un archivo grande?
    • ¿Cómo puedo cargar un archivo en una petición de endpoint?
    • ¿Qué hacer si Apidog se bloquea o los datos de respuesta no se muestran?
    • URI de redirección oficial utilizada por Apidog para OAuth2.0
  • Datos de API mock
    • ¿Cómo hacer mock de APIs automáticamente?
    • ¿Qué puede hacer el mock de Apidog?
    • ¿Cómo simular datos fijos de API en Apidog?
    • ¿Cómo simular datos condicionales en Apidog?
    • ¿Cómo habilitar el mock en la nube en Apidog?
    • ¿Cómo habilitar un mock autoalojado en Apidog?
    • ¿Apidog admite mocks de API WebSocket?
    • ¿Por qué el navegador no devuelve contenido al solicitar el endpoint mock?
  • Pruebas automatizadas
    • ¿Por qué los escenarios de prueba se ejecutan sin problemas en mi cliente local, pero se producen errores al ejecutarlos en Apidog CLI o runner?
    • ¿Cómo crear un escenario de prueba en Apidog?
    • ¿Cómo pasar datos entre pasos de prueba?
    • ¿Por qué no puedo referenciar correctamente los datos del paso previo?
    • ¿Cómo usar el bucle foreach en Apidog?
    • ¿Cuáles son las diferencias entre sincronizar datos desde endpoints/casos de endpoint?
    • ¿Cómo utilizar datos de prueba en Apidog?
    • ¿Cómo recuperar datos de prueba en scripts en Apidog?
    • ¿Cómo ejecutar escenarios de prueba por lotes en Apidog?
    • ¿Cómo programar tareas de prueba en Apidog?
    • ¿Cómo ejecutar una prueba de rendimiento en Apidog?
    • ¿Cómo puedo ver las peticiones y respuestas reales en las pruebas de rendimiento?
    • ¿Cómo puedo exportar informes de pruebas de rendimiento en Apidog?
    • ¿Cómo utilizar los resultados de consultas de base de datos como parámetros para realizar peticiones de API en bucle?
    • Capturar y validar webhooks de Stripe en ApiDog durante CI/CD
    • ¿Cómo resolver el error "Error: unable to verify the first certificate on runner"?
    • Error «Not Found» en el contenedor Docker de General Runner.
    • ¿Cómo configurar el host del servidor para el General Runner en la versión web de Apidog?
    • ¿Por qué el escenario de prueba programado terminó con 0 peticiones?
    • ¿Qué debo hacer si no se puede encontrar el parámetro de carga de archivo en Runner o CLI?
    • ¿Cómo usar Runner para ejecutar un escenario de prueba con un paso de carga de archivo?
    • ¿Cómo resuelvo el error "Error: unable to verify the first certificate on runner"?
    • ¿Cómo accedo y busco en los registros del runner para identificar el problema cuando surge un problema con un runner?
    • ¿Qué debo hacer si el parámetro del endpoint es un archivo de carga y no se puede encontrar en Runner o CLI?
    • ¿Por qué los pasos de prueba no se sincronizan automáticamente cuando cambia el caso de uso de la API?
    • ¿Por qué el uso de varios signos de dólar en un documento Markdown provoca que parte del contenido no se muestre correctamente?
    • ¿El Runner autoalojado genera un informe de prueba en el servidor después de ejecutar una tarea?
    • ¿Puedo añadir pre/postprocesadores unificados a las peticiones en un escenario de prueba?
    • ¿Cómo puedo mantener valores dinámicos coherentes durante una única ejecución de prueba automatizada?
  • Publicar documentación de API
    • ¿Cómo ocultar todos los logotipos de Apidog en los documentos publicados?
    • Cuando se actualiza la especificación de la API, ¿cambiará la documentación de la API?
    • ¿Cómo compartir APIs con colaboradores en Apidog?
    • ¿Cómo personalizar el dominio de la documentación de Apidog?
    • ¿Cómo crear documentación multiversión en Apidog?
    • Alcance de uso compartido para sitios de documentación publicados en Apidog
    • Alcance de uso compartido para la lista Share Doc en Apidog
    • ¿Por qué los Share Docs publicados no muestran el hostname?
    • ¿Cómo pueden los usuarios de la documentación modificar la URL base en documentos compartidos?
    • ¿Puedo duplicar un documento de Apidog publicado para usarlo en mi propio proyecto?
    • ¿Cómo compartir encabezados (por ejemplo, token) en la documentación en línea de Apidog?
    • ¿Por qué mi miembro del equipo no puede encontrar la documentación publicada?
    • ¿Cómo soluciono la expiración de un certificado SSL o un error 526 de Cloudflare en mi dominio personalizado?
    • SMTP personalizado configurado correctamente, pero los usuarios en la lista de permitidos no reciben correos electrónicos con OTP
  • Markdown
    • ¿Cómo usar tarjetas para enlazar a varias páginas o endpoints dentro de Apidog?
    • ¿Por qué algunos contenidos no se muestran correctamente al usar varios símbolos $ en documentos Markdown?
    • ¿Cómo usar imágenes con fondo transparente en Apidog Markdown?
    • ¿Cómo establecer el ancho de columna de una tabla Markdown?
    • ¿Cómo puede insertar APIs internas, documentos, esquemas de datos o carpetas en un documento Markdown?
    • ¿Cómo agrego un enlace a un documento o endpoint dentro de un proyecto en un componente de tarjeta de Apidog?
  • Ramas
    • ¿Cómo acceder a la rama de sprint?
  • Administración
    • ¿Cómo instalar el cliente de Apidog de forma silenciosa?
    • ¿Por qué veo un error de «Sin permiso» a pesar de tener acceso de administrador?
    • ¿Cómo puedo comprobar el número de versión del runner?
    • ¿Apidog es compatible con Windows 7?
    • ¿Por qué Apidog muestra el error "Cannot locate program entry point DiscardVirtualMemory in dynamic link library KERNEL32.dll" después de la instalación?
    • Cambios de suscripción y reembolsos
    • Las peticiones web funcionan, pero la aplicación muestra "read ECONNRESET": ¿por qué?
    • ¿Por qué no puedo abrir Apidog después de una actualización del sistema Windows?
    • Por qué Apidog no se abre después de una actualización del sistema Windows
  • Facturación
    • ¿Puedo configurar una cuenta de facturación separada para mi equipo en Apidog?
    • Problemas de acceso del equipo y facturación en Apidog
    • Los miembros invitados del equipo no pueden acceder a Apidog.
    • Transferir un equipo personal de pago a una organización
  • On-premises
    • Gestión de usuarios y acceso en la versión autohospedada (Enterprise) de Apidog
  • Web y cliente
    • Descarga e instalación de la versión de escritorio para Linux
  1. Publicar documentación de API

¿Cómo compartir APIs con colaboradores en Apidog?

En el desarrollo, la comunicación y la colaboración de APIs, la documentación de API es lógicamente el estándar, pero en la práctica existe el problema de compartir archivos en formatos Word o PDF. Por este motivo, se recomienda el documento en línea para mejorar la eficiencia de la comunicación entre equipos.

Crear un uso compartido rápido#

Cambie al módulo Share Docs en el lado izquierdo.
Haga clic en "New" para crear un nuevo uso compartido rápido. Un proyecto admite varios usos compartidos rápidos diferentes, que pueden distribuirse a distintos colaboradores. Todos los miembros del equipo pueden ver todos los usos compartidos rápidos creados por todos.
En la ventana emergente New Share, puede personalizar las siguientes opciones:
Título: El nombre de este uso compartido, visible únicamente dentro del equipo de Apidog, utilizado para identificación interna y no visible en la documentación compartida.
Entornos: Elija los entornos disponibles en el documento en línea. De forma predeterminada, no se selecciona ningún entorno. Puede seleccionar varios entornos. Los entornos seleccionados serán visibles para los lectores en la documentación y pueden utilizarse para enviar peticiones al usar "Try it out".
Si selecciona el entorno de mock en la nube al crear la documentación, equivale a habilitar un entorno de sandbox simple para los lectores de la documentación.
Contenido del documento: El documento tiene dos componentes opcionales: URL base y muestras de peticiones. Puede elegir si desea mostrarlos en el documento.
URL base: Esta es la URL base configurada en el entorno. Si se selecciona, cada interfaz del documento mostrará la URL completa; si no se selecciona, la URL del documento comenzará con "/".
Muestras de peticiones: Si se debe mostrar código de ejemplo para llamar peticiones. Consulte Muestras de peticiones para obtener más detalles.
Permitir exportar datos: Si se debe permitir a los lectores exportar datos en formato OAS/Markdown/HTML/Apidog.
Alcance para compartir: Elija qué endpoints de API y Markdown incluir en este uso compartido. Puede seleccionar por directorio o filtrar y excluir por etiqueta.
Seguridad: Puede configurar si se requiere una contraseña para acceder a este documento, así como la fecha de expiración de este documento. Si no se selecciona una fecha de expiración, nunca expira.
Mostrar campos de API: Puede configurar si estos campos se muestran en el documento. Incluye: propietarios, hora de actualización, OperationId, enlace original, autorización requerida.
Idioma: La configuración de idioma aquí afectará al texto fijo funcional del documento, como "Query Params", "Request samples", etc., pero no afectará al texto escrito en el contenido de la documentación de API.
Configuración avanzada: Aquí puede configurar Ocultar el botón 'Try it out' y Ocultar 'Powered by Apidog'.

Compartir carpeta completa#

El uso compartido rápido admite "compartir carpeta completa". Esto es adecuado para escenarios en los que, después de compartir el enlace, usted puede haber añadido o eliminado documentos en la carpeta y desea que los colaboradores puedan ver estos cambios de forma sincronizada.
En "Alcance para compartir", cuando selecciona "Selección manual", puede ver "compartir carpeta completa". Si se habilita, los colaboradores siempre verán todos los documentos de la carpeta, sin que usted tenga que modificar manualmente el alcance de uso compartido después de añadir documentos.

Muestras de peticiones#

Puede elegir si desea mostrar este módulo al crear el uso compartido.
Puede personalizar las muestras de peticiones. Así es como se hace:
1.
En Configuración del proyecto - Configuración de funciones - Configuración de funciones de endpoint - Campos de endpoint, habilite el campo Muestras de peticiones.
2.
Luego, en Endpoint - Editar, aparecerá un módulo de Muestras de peticiones al final.
3.
Puede hacer clic en Añadir muestra de petición aquí para añadir muestras en los lenguajes que necesite. Luego aparecerán en la documentación.
image.png

Compartir el enlace#

Una vez completada la configuración, copie el enlace para compartirlo con los miembros del equipo.
Visite el enlace para Ver la documentación de API.
Modified at 2026-06-09 08:52:14
Previous
Cuando se actualiza la especificación de la API, ¿cambiará la documentación de la API?
Next
¿Cómo personalizar el dominio de la documentación de Apidog?
Built with