Postman Collection para API Connect

En lugar de escribir código desde cero, puedes descargar nuestra colección de Postman y hacer requests a la API inmediatamente. La colección incluye:

• ✅ Autenticación OAuth 2.0 automática
• ✅ Ejemplos de requests listos para usar
• ✅ Variables de entorno preconfiguradas
• ✅ Scripts que manejan token expiration

Descargar los archivos

Descarga estos dos archivos desde el repositorio de Quralo:

1. Collection JSON (ejemplos de requests)

Descargar Collection →

Este archivo contiene:

• Requests de ejemplo (Create, Update DiagnosticReport)
• Pre-request script que obtiene el token automáticamente
• Scripts de prueba que extraen IDs y ETags

2. Environment JSON (variables de tu entorno)

Descargar Environment →

Este archivo contiene:

• API_CONNECT_AUTH_URL: URL del servidor de autenticación
• API_CONNECT_CLIENT_ID: Client ID para Client Credentials de OAuth 2.0 con el que se identifica al sistema externo en el servidor de autenticación (placeholder)
• API_CONNECT_CLIENT_SECRET: Contraseña asociada al Client ID para la API a la que se desea acceder (placeholder)
• API_CONNECT_AUDIENCE: Identificador de la API que se desea acceder (placeholder)
• API_CONNECT_URL: URL base de la API
• DIAGNOSTIC_REPORT_ID: ID del DiagnosticReport (para uso automático en Create, Update y Get requests)
• DIAGNOSTIC_REPORT_ETAG: ETag del DiagnosticReport (para uso automático en Update requests)

Cómo Importar en Postman

Paso 1: Descargar Postman

Si no tienes Postman instalado, descárgalo desde postman.com.

Paso 2: Importar la Collection

1. Abre Postman
2. Haz click en Import (esquina superior izquierda)
3. Selecciona Upload Files
4. Selecciona quralo-api-connect.postman_collection.json
5. Haz click en Import

Paso 3: Importar el Environment

1. Haz click en el icono de engranaje ⚙️ (esquina superior derecha)
2. Selecciona Environments
3. Haz click en Import
4. Selecciona quralo-api-connect.postman_environment.json
5. Haz click en Import

Configurar Variables

Después de importar, necesitas reemplazar los placeholders con tus valores reales.

Paso 1: Seleccionar el Environment

1. En la esquina superior derecha, usa el dropdown que dice "Select an environment"
2. Selecciona "Quralo API Connect - Sandbox"

Paso 2: Editar Variables

1. Haz click en el icono de engranaje ⚙️ (esquina superior derecha)
2. Selecciona Environments
3. Haz click en "Quralo API Connect - Sandbox"
4. Reemplaza los valores:

Variable	Valor Actual	Reemplazar con
API_CONNECT_CLIENT_ID	YOUR_SANDBOX_CLIENT_ID	Tu Client ID de Quralo
API_CONNECT_CLIENT_SECRET	YOUR_SANDBOX_CLIENT_SECRET	Tu Client Secret de Quralo

⚠️ Importante:

• Nunca compartas tu Client Secret
• No lo versiones en Git

Paso 3: Guardar Cambios

Haz click en Save después de reemplazar los valores.

Usar la Colección

Flujo de Autorización Automático

El pre-request script obtiene el token automáticamente antes de cada request:

1. Antes de ejecutar un request
   ↓
2. Pre-request script valida si el token sigue válido
   ↓
3. Si expiró (24 horas):
   - POST a {{auth_url}}/oauth/token
   - Obtiene nuevo access_token
   - Almacena token en {{access_token}}
   ↓
4. El request se ejecuta con Authorization: Bearer {{access_token}}

Ejecutar un Request de Ejemplo

1. Abre la collection: Quralo API Connect
2. Selecciona un request, ej: FHIR R4 > DiagnosticReport > Publicar nuevo
3. Haz click en Send
4. Mira la respuesta en el panel inferior

Ver los Logs de Autenticación

Para debuggear si el token se obtiene correctamente:

1. Abre Console (Postman) en la esquina inferior izquierda
2. Verás logs como:

[Auth] Obteniendo nuevo Access Token...
[Auth] ✓ Token obtenido exitosamente
[Auth] Expira en: 7/5/2026, 1:30:45 PM

Si ves errores, revisa:

• ¿El environment está seleccionado?
• ¿Los valores de API_CONNECT_CLIENT_ID y API_CONNECT_CLIENT_SECRET son correctos?

Solución de Problemas

Error: "Please configure your environment"

Causa: No seleccionaste el environment en el dropdown.

Solución:

1. Esquina superior derecha
2. Dropdown "Select an environment"
3. Selecciona "Quralo API Connect - Sandbox"

Error 401: "invalid_client"

Causa: Client ID o Client Secret incorrecto.

Solución:

1. Verifica que reemplazaste los placeholders correctamente
2. Copia exactamente los valores que Quralo te proporcionó
3. No hay espacios al inicio o final

Error: "Cannot read property 'value' of undefined"

Causa: La variable de environment no existe.

Solución:

1. Verifica que importaste el environment JSON correctamente
2. Intenta descargar e importar de nuevo

El token nunca se obtiene

Causa: Pre-request script no se ejecuta.

Solución:

1. Abre la Console (esquina inferior izquierda)
2. Mira si ves logs de [Auth]
3. Si no ves logs, el script no se ejecutó
4. Verifica que el request tenga configurado correctamente el pre-request script

Próximos Pasos

• Flujo OAuth - Entender cómo funciona OAuth 2.0
• Entornos - Diferencias entre Sandbox y Producción
• FHIR R4 - DiagnosticReport - Documentación de recursos

Soporte

¿Problemas con Postman o autenticación? Contáctanos en soporte@quralo.com