Saltar a contenido

Primeros pasos

1. Registre su organización

Complete el formulario de alta de proveedor para obtener sus credenciales:

  • API Key
  • API Secret

Mail: El alta se gestiona vía soporte técnico: soporte@asystir.com

Ambas credenciales se requieren en todas las solicitudes API.

2. Configure un entorno seguro

Requisitos mínimos:

Protocolo Estado
HTTPS / TLS 1.2+ Obligatorio
Certificado de servidor válido Requerido
Gestión segura de credenciales Recomendado

Jamás exponga X-API-Secret en código del lado del cliente.

3. Haga su primera llamada a la API

Vamos a validar a un paciente mediante su DNI:

curl -X POST "https://api.asystir.com/v1/persona/verificar" \
  -H "X-API-Key: TU_API_KEY" \
  -H "X-API-Secret: TU_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"documento": "32123456"}'

Una respuesta exitosa se verá así:

{
  "success": true,
  "data": {
    "nombre": "Juan",
    "apellido": "Pérez",
    "edad": 41,
    "domicilio": "Av. Siempre Viva 742",
    "documento": "32123456"
  }
}

¡Felicitaciones! Ya está integrando con Asystir.

Autenticación

En todos los endpoints deberá incluir los siguientes encabezados:

Header Descripción
X-API-Key Identificador de su organización
X-API-Secret Clave secreta privada
Content-Type: application/json Requerido para métodos con cuerpo JSON

Consulte la guía completa: Autenticación (/docs/autenticacion)

¿Qué puedo hacer con la API?

Funcionalidades principales:

Categoría Servicios
Identidad sanitaria Verificar Persona, Verificar Profesional
Receta electrónica Generar CUIR, Registrar Receta, Listar Recetas
Medicamentos Buscar en vademécum oficial
Auditoría & Seguridad Trazabilidad del registro y consulta

Cada endpoint incluye ejemplos prácticos en:

  • curl
  • JavaScript (Fetch)
  • Visual Basic .NET

Ver sección: Referencias de API (/docs/api-overview)

Sandbox & Testing

Antes de acceder al entorno productivo, los integradores deben utilizar el ambiente de sandbox:

https://sandbox.api.asystir.com/v1/

Ventajas:

  • Pruebas ilimitadas sin impacto real
  • Datos de prueba disponibles
  • Validación de reglas anticipada

Escalabilidad y Límites

Tipo de límite Valor inicial Observaciones
Solicitudes por minuto 300 RPM Expansible bajo contrato
Tamaño máximo de request 1 MB Campos JSON
Retención de logs 1 año Para auditorías regulatorias

En caso de exceder límites: 429 Too Many Requests

Seguridad y cumplimiento

  • Protección anti-spoofing para REFEPS y SISA
  • Auditoría ministerial habilitada
  • Encriptación en tránsito (TLS 1.2+)
  • Idempotencia en operaciones críticas
  • Trazabilidad por id_transaccion

Cumplimiento normativo:

Norma / Ley Alcance
Ley 27.553 Receta electrónica
Resolución 696/2020 Identificación digital en salud
Buenas Prácticas de Seguridad en Salud (ARG) Estándares de confidencialidad

¿Necesita ayuda?

Equipo de soporte técnico para integradores:

Si desea una capacitación técnica para su equipo de desarrollo, contáctenos.

Próximos pasos

  • Ir a Introducción a la Autenticación
  • Probar Verificar Persona
  • Implementar Generar CUIR → Registrar Receta
  • Publicar en producción

Asystir evoluciona constantemente para acompañar al sistema de salud argentino en su modernización. Estamos para potenciar sus soluciones y acelerar su desarrollo.

Bienvenido a Asystir.