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. Enviar peticiones
  • 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. Enviar peticiones

gRPC

gRPC es un framework de llamada a procedimiento remoto (RPC) eficiente y de alto rendimiento, ampliamente adoptado en los sistemas distribuidos modernos. En arquitecturas de microservicios, gRPC facilita una comunicación eficiente entre servicios con baja latencia y menor consumo de ancho de banda mediante sus capacidades de streaming y la serialización con Protocol Buffers.

Requisitos previos#

Antes de usar gRPC en Apidog, asegúrese de contar con:
Apidog versión 2.3.1 o posterior
Archivos .proto que definan sus servicios y métodos gRPC
Acceso a un endpoint de servidor gRPC

Crear un proyecto gRPC#

Para crear un nuevo proyecto gRPC:
1.
Haga clic en "Nuevo proyecto" en la página de inicio de Apidog
2.
Seleccione "Proyecto gRPC"
imagen.png

Importar archivos Proto#

gRPC sigue un enfoque API-First, que requiere que los servicios, métodos y mensajes se definan mediante archivos .proto antes del desarrollo. Importe su archivo .proto para comenzar a depurar API gRPC en Apidog.

Importación inicial#

Apidog admite tres métodos de importación:
MétodoDescripción
Archivo localCargue un archivo .proto desde su sistema de archivos local
URLImporte desde una URL que aloje el archivo .proto
Reflexión del servidorDescubra servicios automáticamente desde un servidor gRPC
apidog-grpc-03.gif
Estructura de importación
El archivo .proto seleccionado se importa como un Proto, donde:
Servicios se importan como servicios
Métodos RPC se importan como métodos
Dependencias deben añadirse manualmente si el archivo .proto depende de otros archivos
Servicios relacionados de archivos .proto dependientes con el mismo paquete también se importan

Reimportar archivos Proto#

Cuando su archivo .proto cambie, actualícelo en Apidog:
1.
Haga clic con el botón derecho en el Proto en el árbol de directorios
2.
Haga clic en "Reimportar"

Métodos de invocación#

gRPC admite cuatro tipos de métodos al definir API en archivos .proto. Apidog admite los cuatro:
Tipo de métodoDescripción
UnarioUna sola petición, una sola respuesta (similar a HTTP)
Streaming del servidorUna sola petición, múltiples respuestas del servidor
Streaming del clienteMúltiples peticiones del cliente, una sola respuesta
Streaming bidireccionalMúltiples peticiones y respuestas en ambas direcciones

Llamadas unarias#

Las llamadas unarias funcionan de manera similar a las peticiones HTTP:
1.
Introduzca la URL del servidor en la barra de direcciones
2.
Introduzca el contenido del mensaje en formato JSON en la pestaña Mensaje
3.
Haga clic en "Invocar" para iniciar la llamada
También puede configurar información de Metadatos y Autenticación para escenarios de autenticación o escenarios complejos.

Llamadas de streaming#

Las llamadas de streaming funcionan de manera similar a las conexiones WebSocket. Después de iniciar la llamada, puede escribir y enviar mensajes en la pestaña Mensaje.
Apidog proporciona una vista de línea de tiempo que muestra:
Estado de la llamada
Mensajes enviados
Mensajes recibidos (en orden cronológico)
Haga clic en cualquier mensaje para ver sus detalles.

Funciones avanzadas#

Generar valores dinámicos automáticamente#

Apidog reconoce el contenido del archivo .proto, lo que permite generar automáticamente el cuerpo del mensaje:
1.
Haga clic en el botón "Generar automáticamente" para crear la estructura del mensaje
2.
Use la función "Valores dinámicos" para una generación de datos flexible y dinámica
Para obtener instrucciones detalladas, consulte Valores dinámicos.

Uso de variables#

Las variables de Apidog pueden usarse en mensajes gRPC y Metadatos para la inyección dinámica de datos.
Para obtener instrucciones detalladas, consulte Variable de entorno.

Habilitar TLS#

Las API gRPC admiten conexiones seguras mediante TLS (Transport Layer Security).
Para habilitar TLS:
Haga clic en el selector de protocolo antes de la URL para alternar el estado de TLS
Use grpcs:// en la URL para habilitar TLS
Use grpc:// para deshabilitar TLS

Gestionar direcciones de servidor y entornos#

Añadir direcciones de servidor#

Haga clic en el icono de signo más en el lado derecho de la barra de direcciones URL para añadir la dirección actual del servidor a un entorno.

Usar direcciones de servidor del entorno#

1.
Seleccione el entorno y la dirección del servidor en la esquina superior derecha
2.
Elija "Seguir predeterminado" en la barra de direcciones URL para usar una dirección de servidor unificada al depurar todos los métodos

Ver archivos Proto y parámetros de API#

Contenido del archivo Proto#

Haga clic en el Proto en el árbol de directorios izquierdo para ver el contenido sin procesar del archivo .proto.

Parámetros de petición y respuesta#

gRPC usa Protocol Buffers (ProtoBuf) como formato de serialización. A diferencia de los formatos basados en texto (JSON, XML), ProtoBuf es un formato binario que no es adecuado para lectura o escritura humana.
En Apidog, todos los mensajes gRPC se escriben y se muestran en formato JSON para facilitar su uso. Puede ver los parámetros de petición y respuesta en formato JSON en la página de información de la API.

Asignación de tipos de ProtoBuf a JSON#

ProtoBuf 3JSONEjemplo JSON
messageobject{"fooBar": v, "g": null, …}
enumstring"FOO_BAR"
map<K,V>object{"k": v, …}
repeated Varray[v, …]
boolbooleantrue, false
stringstring"Hello World!"
bytesbase64 string"YWJjMTIzIT8kKiYoKSctPUB+"
int32, fixed32, uint32number1, -10, 0
int64, fixed64, uint64string"1", "-10"
float, doublenumber1.1, -10.0, 0, "NaN", "Infinity"

Guardar información de depuración#

Después de completar la depuración, haga clic en el botón "Guardar" para guardar:
URL del servidor
Mensajes
Metadatos
Otra configuración
Esto permite que los miembros del equipo reutilicen su configuración de depuración.
Modified at 2026-06-09 08:52:14
Previous
GraphQL
Next
Usar agentes proxy de petición para la depuración
Built with