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
  • Centro de aprendizaje de Apidog
  • Primeros pasos
    • Introducción a Apidog
    • Conceptos básicos en Apidog
    • Navegación por Apidog
    • Inicio rápido
      • Descripción general
      • Crear un Endpoint
      • Realizar una petición
      • Añadir una aserción
      • Creación de escenarios de prueba
      • Compartir documentación de API
      • Explore Más
    • Migración a Apidog
      • Descripción general
      • Importación manual
      • Importación programada (Vincular fuentes de datos)
      • Opciones de importación
      • Exportar datos
      • Importar desde
        • Importar desde Postman
        • Importar especificación OpenAPI
        • Importar cURL
        • Importar archivos Markdown
        • Importar desde Insomnia
        • Importar desde apiDoc
        • Importar archivo .har
        • Importar WSDL
  • Datos de API mock
    • Descripción general
    • Smart Mock
    • Mock personalizado
    • Secuencia de prioridad de mock
    • Scripts de mock
    • Mock en la nube
    • Mock de Runner autoalojado
    • Idioma de mock (locales)
  • Cuenta y preferencias
    • Configuración de la cuenta
    • Generación de un token de acceso OpenAPI
    • Notificación
    • Configuración de idioma
    • Teclas de acceso rápido
    • Configuración del proxy de red
    • Copia de seguridad de los datos
    • Actualizar Apidog
    • Eliminar cuenta
    • Funciones experimentales
  • Enviar peticiones
    • Descripción general
    • Depuración de SSE
    • Cliente MCP
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP o WebService
    • GraphQL
    • gRPC
    • Usar agentes proxy de petición para la depuración
    • Crear peticiones
      • Historial de peticiones
      • Conceptos básicos de las peticiones
      • Parámetros y cuerpo
      • Encabezados de petición
      • Configuración de peticiones
      • Depurar peticiones
      • Guardar peticiones como endpoints
      • HTTP/2
    • Autenticación y autorización
      • Descripción general
      • Certificados de CA y de cliente
      • Tipos de autorización
      • Autenticación Digest
      • OAuth 1.0
      • OAuth 2.0
      • Autenticación Hawk
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • Respuesta y cookies
      • Visualización de respuestas de API
      • Gestión de cookies
      • Descripción general
  • Desarrollar y depurar APIs
    • Descripción general
    • Generación de peticiones
    • Envío de peticiones
    • Casos de depuración
    • Casos de prueba
    • Valores dinámicos
    • Validación de respuestas
    • Diseño primero vs. petición primero
    • Generación de código
    • Entornos y variables
      • Descripción general
      • Uso de variables
      • Gestión de entornos
    • Secretos de la bóveda
      • Descripción general
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • Módulos de valores dinámicos
      • Aerolínea
      • Animal
      • Color
      • Comercio
      • Empresa
      • Base de datos
      • Tipo de dato
      • Fecha
      • Finanzas
      • Comida
      • Git
      • Hacker
      • Helpers
      • Imagen
      • Internet
      • Ubicación
      • Lorem
      • Música
      • Número
      • Persona
      • Teléfono
      • Ciencia
      • String
      • Sistema
      • Vehículo
      • Word
    • Preprocesadores y postprocesadores
      • Descripción general
      • Aserción
      • Extraer variable
      • Esperar
      • Seguridad
      • Operaciones de base de datos
        • Descripción general
        • MySQL
        • MongoDB
        • Redis
        • Cliente Oracle
      • Uso de scripts
        • Descripción general
        • Scripts de preprocesador
        • Scripts de posprocesador
        • Scripts públicos
        • Referencia de scripts de Postman
        • Llamar a otros lenguajes de programación
        • Uso de bibliotecas JS
        • Visualización de respuestas
        • Ejemplos de scripts
          • Scripts de aserción
          • Uso de variables
          • Modificación de peticiones
          • Otros ejemplos
    • Depuración de APIs
      • Depurador de agentes de IA
      • Depurador A2A
  • Diseñar APIs
    • Descripción general
    • Crear un nuevo proyecto de API
    • Conceptos básicos de endpoints
    • Directrices de diseño de API
    • Módulo
    • Configurar múltiples ejemplos de cuerpo de petición
    • Componentes
    • Campos comunes
    • Parámetros globales
    • Historial de cambios del endpoint
    • Comentarios
    • Gestión de endpoints por lotes
    • API de protocolo personalizado
    • Modo Spec-first (Beta)
    • Esquemas de seguridad
      • Descripción general
      • Crear un esquema de seguridad
      • Usar el esquema de seguridad
      • Esquema de seguridad en la documentación en línea
    • Funciones avanzadas
      • Campos personalizados de endpoint
      • Escenarios de prueba asociados
      • Estado del endpoint
      • Apariencia de las listas de parámetros
      • Identificación única de endpoints
    • Schemas
      • Descripción general
      • Crear un nuevo esquema
      • Crear un esquema
      • Generar esquemas a partir de JSON, etc.
      • oneOf, allOf, anyOf
      • Uso de Discriminator
  • Pruebas de API
    • Descripción general
    • Escenarios de prueba
      • Crear un escenario de prueba
      • Pasar datos entre peticiones
      • Condiciones de control de flujo
      • Sincronizar datos desde endpoints y casos de endpoint
      • Importar endpoints y casos de endpoint desde otros proyectos
      • Exportar escenarios de prueba
    • Informes de prueba
      • Informes de prueba
    • Ejecutar escenarios de prueba
      • Ejecutar un escenario de prueba
      • Ejecutar escenarios de prueba por lotes
      • Pruebas basadas en datos
      • Datos de prueba compartidos
      • Tareas programadas
      • Gestionar el entorno de ejecución de API de otros proyectos
    • Suite de pruebas
      • Descripción general
      • Crear una suite de pruebas
      • Orquestar suite de pruebas
      • Ejecutar conjuntos de pruebas localmente
      • Ejecutar suites de prueba mediante CLI
      • Tareas programadas
    • Probar APIs
      • Pruebas de integración
      • Pruebas de rendimiento
      • Pruebas de extremo a extremo
      • Pruebas de regresión
      • Pruebas de contrato
    • Apidog CLI
      • Descripción general
      • Instalación y ejecución de Apidog CLI
      • Opciones de Apidog CLI
    • CI/CD
      • Descripción general
      • Integrar con Github Actions
      • Integrar con Gitlab
      • Integrar con Jenkins
      • Activar prueba mediante commit de Git
  • Publicar documentación de API
    • Descripción general
    • Tecnologías de API compatibles
    • Uso compartido rápido
    • Visualización de la documentación de API
    • Documentación de Markdown
    • Publicación de sitios de documentación
    • Página de inicio de sesión personalizada
    • Diseños personalizados
    • CSS, JavaScript, HTML personalizados
    • Dominio personalizado
    • Funciones de IA
    • Configuración de SEO
    • Configuración avanzada
      • Búsqueda en la documentación
      • Proxy CORS
      • Integración de Google Analytics
      • Configuración del árbol de carpetas
      • Configuración de visibilidad
      • Incrustación de valores en las URL de documentación
    • Versiones de API
      • Descripción general
      • Crear versiones de API
      • Publicación de versiones de API
      • Compartir endpoints con versiones de API
  • Ramas
    • Descripción general
    • Crear una rama de sprint
    • Prueba de APIs en una rama
    • Diseño de API en una rama
    • Fusionar ramas de sprint
    • Gestión de ramas de sprint
    • AI Branch (Beta)
  • Funciones de IA
    • Descripción general
    • Habilitación de funciones de IA
    • Generación de casos de prueba
    • Modificación de esquemas con IA
    • Comprobación de cumplimiento del endpoint
    • Comprobación de integridad de la documentación de API
    • Nomenclatura de campos con IA
    • Preguntas frecuentes
  • Servidor MCP de Apidog
    • Descripción general
    • Conectar un proyecto de Apidog a la IA
    • Conectar documentación publicada a la IA
    • Conectar archivos OpenAPI a la IA
  • Mejores prácticas
    • Gestión de firmas de API
    • Acceso a APIs protegidas con OAuth 2.0
    • Flujo de trabajo de colaboración
    • Gestión del estado de autenticación
  • Espacio sin conexión
    • Descripción general
  • Administración
    • Gestión de proyectos
      • Gestión de proyectos
      • Configuración de notificaciones
      • Gestión de miembros del proyecto
      • Recursos del proyecto
        • Conexión a la base de datos
        • Conexión con Git
    • Gestión de equipos
      • Gestión de equipos
      • Gestión de miembros del equipo
      • Actividades del equipo
      • Roles y permisos del equipo
      • Recursos del equipo
        • General Runner
        • Variables de equipo
        • Agente proxy de peticiones
      • Colaboraciones en tiempo real
        • Colaboración en equipo
    • Lista de verificación de incorporación
      • Conceptos básicos
      • Guía de incorporación
    • Gestión de la organización
      • Gestión de la organización
      • Rol y permisos de la organización
      • Gestión de planes
        • Administradores de facturación en organizaciones
      • Inicio de sesión único (SSO)
        • Descripción general de SSO
        • Configuración de Microsoft Entra ID
        • Configuración de Okta
        • Configuración de SSO para una organización
        • Gestión de cuentas de usuario
        • Asignar grupos a equipos
      • Aprovisionamiento SCIM
        • Introducción al aprovisionamiento SCIM
        • Microsoft Entra ID
        • Okta
      • Recursos de la organización
        • Runner autohospedado
  • Facturación
    • Descripción general
    • Créditos
    • Actualizar su plan
    • Métodos de pago alternativos
    • Gestión de suscripciones
    • Trasladar equipos de pago a organizaciones
  • Complementos
    • API Hub
    • Plugin Apidog Intellij IDEA
    • Extensión del navegador
      • Chrome
      • Microsoft Edge
    • Proxy de peticiones
      • Proxy de peticiones en la web
      • Proxy de petición en documentos compartidos
      • Proxy de peticiones en el cliente
  • Datos y seguridad
    • Almacenamiento y seguridad de datos
    • Privacidad y seguridad de los datos del usuario
    • Enrutamiento de peticiones y seguridad de datos
  • Referencias
    • Enfoque de diseño de API primero
    • Extensiones de la especificación OpenAPI de Apidog
    • JSONPath
    • XPath
    • Expresiones regulares
    • JSON Schema
    • Formato de archivo CSV
    • Instalación del entorno Java
    • Entorno de implementación de Runner
    • Sintaxis Markdown de Apidog
    • Extensiones Swagger de Apidog
      • Descripción general
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Extensiones JSON Schema de Apidog
      • Descripción general
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • Apidog Europa
    • Apidog Europe
  • Centro de soporte
  1. Publicar documentación de API

CSS, JavaScript, HTML personalizados

Al publicar su documentación de API, puede añadir HTML, CSS y JavaScript globales personalizados para personalizar los estilos de la página y ampliar la funcionalidad.
Esta función es útil para:
Integrar servicios de terceros (por ejemplo, chatbots, asistentes de IA)
Modificar estilos predeterminados (por ejemplo, fuente, color, fondo)
Añadir elementos interactivos (por ejemplo, botones, ventanas emergentes, comentarios rápidos)
Al utilizar esta función de forma adecuada, su documentación puede reflejar mejor la identidad de su marca y mejorar la experiencia del usuario.

CSS#

Con CSS personalizado, puede cambiar fuentes, ocultar elementos, ajustar márgenes, modificar colores y mucho más.
Dado que la estructura de la documentación puede cambiar en futuras actualizaciones, recomendamos seguir estos dos principios para garantizar que sus estilos sigan siendo eficaces:
1.
Use variables CSS reservadas
2.
Use nombres de clases CSS reservados

Use variables CSS reservadas#

Apidog proporciona un conjunto de variables CSS con el prefijo --g- para controlar estilos básicos de la página, como la fuente, el color y el fondo. Estas variables se adaptan bien tanto al modo claro como al modo oscuro, lo que hace que sus estilos sean más estables y fáciles de mantener.
Referencia de variables comunes
Ejemplo: Cambiar el color del texto principal

Use nombres de clases CSS reservados#

Para aplicar estilos a áreas específicas, use los nombres de clases reservados de Apidog con el prefijo .g-, que son relativamente estables y tienen menos probabilidades de romperse debido a cambios en el DOM.
Referencia de clases CSS comunes
Ejemplo: Ocultar la barra lateral izquierda

Inspección de la estructura de la página y los nombres de clases#

Además de las variables CSS reservadas y los nombres de clases mencionados anteriormente, también puede usar las herramientas de desarrollador del navegador para encontrar el nombre de clase correspondiente al elemento de la página que desea modificar y, a continuación, escribir CSS para ajustar el estilo.
Se recomienda usar primero nombres de clases que comiencen con .g-. Estos están reservados por la plataforma, tienen una estructura relativamente estable y no suelen fallar. Para otros nombres de clases estructurales, úselos con precaución para evitar fallos de estilo después de actualizaciones del producto.
Puede abrir el sitio de documentación publicado en el navegador y usar las herramientas de desarrollador (modo de desarrollador/consola) para ver la estructura de la página y los nombres de clases de estilo:
Mac: Command + Option + Iorfn + F12
Windows: Ctrl + Shift + Iorfn + F12orF12
Después de abrirlas, haga clic en el "Selector de elementos" (el icono del ratón) y, a continuación, haga clic en cualquier área de la página para ver las etiquetas HTML y los nombres de clases correspondientes a esa área.
También puede usar la función de búsqueda (Cmd/Ctrl + F) para localizar un nombre de clase.
imagen.png

JavaScript#

JavaScript personalizado se usa para integrar servicios de terceros, como asistentes de IA o widgets de soporte. Nota: el campo de JavaScript personalizado de Apidog no admite etiquetas <script> ni <style>. Debe convertirlas en JavaScript puro. Por ejemplo:
❌ Original(no compatible)
✅ Convertido a JavaScript puro
Si desea integrar un script o estilo de terceros, pero no tiene claro cómo reescribirlo en formato JS puro, puede copiar el prompt siguiente y pegarlo en una herramienta de IA (como Claude) para que la IA le ayude a convertirlo automáticamente:
I'm using Apidog's "Custom JavaScript" feature, which only allows pure JavaScript (no <script> or <style> tags).

Please convert the following code to pure JavaScript. Here are the requirements:
1. Rewrite the <script> tag to document.createElement('script') dynamic creation method;
2. Inject the <style> content into the newly created style tag and insert the head;
3. Please use standard methods (such as createElement, appendChild) for all DOM operations, and do not use document.write;
4. If the original code uses `window.addEventListener('DOMContentLoaded', ...)` or `window.addEventListener('load', ...)` only to wait for the page before running code, remove the event listener and run the code directly. Apidog executes custom JavaScript after the documentation page has been rendered, so the browser's `load` event may already have passed by that time; code registered inside a `load` listener may not be executed;
5. The final generated JavaScript should be able to run directly in the browser without any explanation.

Original code:
---
(paste your code here)
---
Por seguridad, JavaScript personalizado solo funciona al acceder a la documentación mediante dominio personalizado.
Si accede a ella a través de la dirección de documentación predeterminada proporcionada por Apidog (por ejemplo, una dirección que comienza con https://xxx.apidog.io/), el JS personalizado no se cargará ni se ejecutará.
Asegúrese de que el código en sí sea fiable para evitar afectar la carga normal o destruir la estructura de la página.
JavaScript personalizado se ejecuta después de que la página de documentación se haya renderizado. Dado que el evento load del navegador puede haber pasado ya en ese momento, es posible que el código colocado dentro de window.addEventListener('load', ...) no se ejecute. En la mayoría de los casos, ejecute su código directamente en su lugar:

Ejemplo: cuadro expandible/contraíble#

Haga clic en el botón siguiente para expandir/contraer el cuadro de diálogo iframe
Script para "Hacer clic en el botón para expandir/contraer el cuadro de diálogo iframe"
Cómo usarlo:
1
Pegue el código en el área "Custom JavaScript" de Apidog.
2
Visite los sitios de documentación mediante su dominio personalizado
3
Aparece un botón en la esquina inferior derecha; haga clic para abrir el iframe de chat.
4
Sustituya iframe.src por su servicio de IA, por ejemplo:
CSS y JavaScript personalizados

Ejemplo: integración del widget de Chatbase#

Script para "Integrar el widget de chat de Chatbase"
Cómo usarlo:
1
Cree una aplicación de Chatbase, obtenga el código de inserción y conviértalo a JS puro usando el prompt anterior.
imagen.png
Pegue el código convertido en la sección Custom JS de Apidog.
2
Visite los sitios de documentación mediante su dominio personalizado.
3
Aparecerá un botón en la esquina inferior derecha. Haga clic en él para abrir una ventana de diálogo.
CSS y JavaScript personalizados

HTML#

La función HTML está actualmente en desarrollo. Manténgase atento a su lanzamiento.

Preguntas frecuentes#

¿El JS personalizado no funciona?
Asegúrese de visitar la documentación mediante un dominio personalizado. JavaScript personalizado solo se ejecuta cuando se usa un dominio personalizado vinculado.
¿Debo usar 'load' o 'DOMContentLoaded' en JavaScript personalizado?
Modified at 2026-06-09 08:52:14
Previous
Diseños personalizados
Next
Dominio personalizado
Built with