Visión general de la API
La API de Asystir proporciona un conjunto de servicios certificados para integrar fácilmente la Receta Electrónica bajo la Ley 27.553 en aplicaciones médicas, plataformas móviles y sistemas de gestión hospitalaria.
Nuestra plataforma opera como intermediario autorizado entre los desarrolladores y la infraestructura del Ministerio de Salud, simplificando la complejidad normativa y proporcionando herramientas técnicas modernas.
Disponibilidad del Servicio
| Entorno | URL Base | Propósito |
|---|---|---|
sandbox |
https://sandbox.api.asystir.com/v1/ |
Pruebas y QA |
production |
https://api.asystir.com/v1/ |
Operación real |
Formato de Mensajes
- Todas las solicitudes usan
HTTPS - Formato del cuerpo: JSON
- Codificación: UTF-8
- Las respuestas incluyen campos normalizados:
{
"success": true,
"data": {},
"error": null
}
Seguridad
Todas las llamadas requieren:
| Header | Ejemplo | Descripción |
|---|---|---|
X-API-Key |
abcd1234... |
Token provisto a clientes registrados |
X-API-Secret |
1a2b3c... |
Clave segura vinculada al cliente |
No se debe almacenar ni exponer credenciales en aplicaciones cliente (JS de navegador, apps desempaquetadas, repositorios públicos).
Límites de Consumo (Rate Limits)
| Nivel | Solicitudes por minuto | Orientación |
|---|---|---|
| Standard | 120 RPM | Apps pequeñas / validaciones |
| Enterprise | 600 RPM | Integradores de gran escala |
Excesos devolverán HTTP 429 (Too Many Requests).
Códigos de Estado Comunes
| Código | Descripción |
|---|---|
200 OK |
Operación correcta |
400 Bad Request |
Parámetros inválidos o faltantes |
401 Unauthorized |
Credenciales incorrectas |
403 Forbidden |
Token caducado o permisos insuficientes |
404 Not Found |
No existe la entidad consultada |
500 Internal Server Error |
Error inesperado |
Endpoints Disponibles
| Endpoint | Función |
|---|---|
POST /persona/verificar |
Consulta datos de identidad del paciente |
POST /profesional/verificar |
Consulta matriculación y REFEPS |
POST /cuir/generar |
Genera un identificador oficial CUIR |
GET /medicamentos/buscar |
Consulta en el vademécum oficial |
POST /recetas/registrar |
Registra una Receta Electrónica |
GET /recetas/listar |
Filtra recetas según parámetros |
Cada endpoint tiene documentación individual detallada con parámetros, validaciones y ejemplos.
Si querés realizar interoperabilidad avanzada (PAMI, CIE-10, actualización automática de catálogos), solicitálo al equipo comercial.