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. Envío de peticiones
  • 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. Envío de peticiones

¿Cómo enviar una petición gRPC en Apidog?

gRPC es un framework de llamada a procedimiento remoto (RPC) eficiente, rápido y fiable, ampliamente utilizado en diversos escenarios. En la arquitectura de microservicios, Apidog facilita una comunicación eficiente entre servicios. Para escenarios que implican una transferencia considerable de datos, Apidog utiliza capacidades de streaming para reducir la latencia de red y el consumo de ancho de banda.
La funcionalidad de depuración de API gRPC se encuentra actualmente en fase de pruebas Beta. La versión de Apidog debe ser igual o superior a 2.3.0 para utilizar la función de depuración de API gRPC.

Crear un nuevo proyecto gRPC#

Haga clic en el botón "Nuevo proyecto" en la página de inicio de Apidog y seleccione "Proyecto gRPC (Beta)".

Importar Proto#

gRPC sigue un enfoque API-First, lo que significa que, antes del desarrollo, los servicios, métodos y mensajes deben definirse mediante archivos .proto. Por lo tanto, antes de depurar API gRPC con Apidog, debe importar el archivo .proto que sirve como definición de la API.

Importación inicial#

Actualmente, hay dos formas de importar archivos .proto:
Archivo local
URL que aloja el archivo .proto
El archivo .proto seleccionado se importará como un Proto, donde el servicio se importará como un servicio, y rpc se importará como métodos.
Si el archivo .proto elegido depende de otros archivos .proto, debe añadir manualmente el directorio de dependencias.
Los servicios de otros archivos .proto de los que depende el archivo .proto seleccionado también se importarán en el mismo Proto si su paquete pertenece al mismo paquete que el archivo .proto seleccionado.

Reimportar#

Si el archivo .proto importado sufre cambios, puede reimportarse en Apidog: haga clic con el botón derecho en Proto y, a continuación, haga clic en el botón "Reimportar".

Métodos de invocación#

Al definir métodos gRPC mediante archivos .proto, Apidog admite cuatro tipos:
Unary: llamada unidireccional
Server Streaming: streaming del lado del servidor
Client Streaming: streaming del lado del cliente
Bidirectional Streaming: streaming bidireccional
Apidog admite los cuatro tipos de métodos.

Llamada Unary#

Las llamadas Unary son similares a las peticiones HTTP. Introduzca la URL en la barra de direcciones, introduzca el contenido del mensaje en formato JSON en la pestaña Message, haga clic en el botón "Invocar" y se iniciará la llamada Unary.
Además, puede completar manualmente la información de Metadata y Auth para cumplir con requisitos de autenticación u otros escenarios complejos.

Llamada de streaming#

Las llamadas de streaming son similares a las conexiones WebSocket. Después de iniciar la llamada, puede escribir y enviar mensajes en la pestaña Message. El streaming del servidor, el streaming del cliente y el streaming bidireccional pertenecen a los tipos de llamadas de streaming.
Apidog proporciona una vista de línea de tiempo que muestra de forma centralizada el estado de la llamada, los mensajes enviados y los mensajes recibidos en orden cronológico. Al hacer clic en un mensaje, puede ver fácilmente sus detalles.

Uso avanzado#

Generar automáticamente valores dinámicos#

Apidog puede reconocer el contenido de los archivos .proto, lo que le permite hacer clic en el botón "Generar automáticamente" para generar el cuerpo del mensaje. Para obtener datos dinámicos más flexibles, puede configurar y generar expresiones mediante la función "Valores dinámicos".
Consulte "Valores dinámicos" para obtener instrucciones más detalladas.

Usar variables#

Puede usar variables de Apidog en mensajes gRPC y Metadata. Consulte la documentación "Tipos de variables de entorno" para obtener instrucciones detalladas.

Habilitar TLS#

Las API gRPC admiten el establecimiento de conexiones seguras mediante TLS.
Con Apidog, puede hacer clic en el selector de protocolo situado delante de la URL para cambiar rápidamente el estado de TLS.
Además, Apidog es compatible con el uso de grpcs:// en la URL para habilitar TLS en la conexión. Por el contrario, grpc:// indica que TLS no está habilitado.

Gestionar direcciones de servidor y entornos#

Haga clic en el icono de signo más situado en el lado derecho de la barra de direcciones URL para añadir la dirección del servidor que se está utilizando actualmente a un entorno.
A continuación, seleccione el entorno y la dirección del servidor en la esquina superior derecha, y elija "Seguir predeterminado" en la barra de direcciones URL para utilizar una dirección de servidor unificada al depurar todos los métodos.

Ver archivos Proto y parámetros de API#

Ver el contenido del archivo Proto#

En Apidog, al hacer clic en Proto en el árbol de directorios de la izquierda, puede ver el contenido sin procesar del archivo .proto.

Ver parámetros de petición y respuesta#

gRPC utiliza ProtoBuf como formato de serialización, lo que significa que cada mensaje se transmite en formato ProtoBuf al enviar o recibir mensajes. A diferencia de otros formatos de serialización basados en texto (JSON, XML), ProtoBuf es un formato binario que no es adecuado para la escritura y lectura humana. Por lo tanto, al llamar a API gRPC en Apidog, todos los mensajes se escriben y se muestran en formato JSON.
Puede ver los parámetros de petición y respuesta representados en formato JSON en la página de información de la API.
ProtoBuf y JSON tienen una relación de correspondencia para los tipos de datos, como se muestra en la siguiente tabla:
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 la URL del servidor, los mensajes, Metadata, etc., en el método actual para que otros miembros del equipo puedan depurar.
Modified at 2026-06-09 08:52:14
Previous
¿Cómo enviar una petición GraphQL en Apidog?
Next
¿Cómo enviar una petición SOAP/WebService en Apidog?
Built with