Luna SaludReferencia de la APILuna Salud

Obtener un formulario completado de un paciente

GET/patient-form

Recupera los campos de un formulario completado en su orden de presentación, como datos estructurados: la etiqueta y la respuesta de cada campo, más las opciones y el estado marcado de los campos de selección, y las mediciones registradas en los campos de signos vitales. Los campos de firma solo indican si se firmaron; nunca se devuelve la imagen de la firma. Los campos de dibujo (diagramas corporal y facial, bocetos y columna) se listan sin valor. Limitado a tu organización.

Ejemplos de código

Node.js

const fetch = require('node-fetch');

async function llamarApi() {
  const claveApi = 'YOUR_API_KEY';
  const id = 'su-id';

const queryString = new URLSearchParams({
    id: id
  }).toString();

  const url = `https://account.lunahealth.app/api/patient-form` + (queryString ? `?${queryString}` : '');
  try {
    const response = await fetch(url, {
      method: 'GET',
      headers: {
        'Authorization': `Bearer ${claveApi}`,
        'Content-Type': 'application/json'
      }
    });
    
    if (!response.ok) {
      throw new Error(`API error: ${response.status}`);
    }
    
    const data = await response.json();
    console.log(data);
    return data;
  } catch (error) {
    console.error('Error al llamar a la API:', error);
    throw error;
  }
}

llamarApi();

Python

import requests

def llamarApi():
    claveApi = 'YOUR_API_KEY'
    
    url = 'https://account.lunahealth.app/api/patient-form'
    
    headers = {
        'Authorization': f'Bearer {claveApi}',
        'Content-Type': 'application/json'
    }
    
    params = {
    'id': 'su-id'
    }
    
    try:
        response = requests.get(
            url,
            headers=headers,
            params=params
        )
        response.raise_for_status()
        
        data = response.json()
        print(data)
        return data
    except requests.exceptions.RequestException as e:
        print(f'Error al llamar a la API: {e}')
        raise

llamarApi()

Parámetros

NombreUbicaciónTipoRequeridoDescripción
idquerystringSíIdentificador único

Respuestas

EstadoDescripción
200Respuesta exitosa
400Datos de entrada no válidos
401Autorización no proporcionada
403Acceso insuficiente
404No encontrado
500Error interno del servidor

200 — Respuesta exitosa

Campos de la respuesta

NombreTipoRequeridoDescripción
idstringSí—
namestringSí—
descriptionstringnullSí—
completed_atstringnullSí—
updated_atstringSí—
patient_idstringSí—
fieldsarray<object>Sí—

Ejemplo de respuesta

{
  "id": "string",
  "name": "string",
  "description": null,
  "completed_at": null,
  "updated_at": "string",
  "patient_id": "string",
  "fields": [
    {
      "id": "string",
      "order": 0,
      "type": "CHIEF_COMPLAINT",
      "label": null,
      "value": null,
      "options": [
        "string"
      ],
      "checked": [
        {
          "option": "string",
          "checked": true,
          "notes": null
        }
      ],
      "signed": null,
      "vitals": [
        {
          "name": "string",
          "value": 0,
          "unit": null,
          "custom": true
        }
      ]
    }
  ]
}

400 — Datos de entrada no válidos

Campos de la respuesta

NombreTipoRequeridoDescripción
messagestringSíThe error message
codestringSíThe error code
issuesarray<object>NoAn array of issues that were responsible for the error

Ejemplo de respuesta

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

401 — Autorización no proporcionada

Campos de la respuesta

NombreTipoRequeridoDescripción
messagestringSíThe error message
codestringSíThe error code
issuesarray<object>NoAn array of issues that were responsible for the error

Ejemplo de respuesta

{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}

403 — Acceso insuficiente

Campos de la respuesta

NombreTipoRequeridoDescripción
messagestringSíThe error message
codestringSíThe error code
issuesarray<object>NoAn array of issues that were responsible for the error

Ejemplo de respuesta

{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}

404 — No encontrado

Campos de la respuesta

NombreTipoRequeridoDescripción
messagestringSíThe error message
codestringSíThe error code
issuesarray<object>NoAn array of issues that were responsible for the error

Ejemplo de respuesta

{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}

500 — Error interno del servidor

Campos de la respuesta

NombreTipoRequeridoDescripción
messagestringSíThe error message
codestringSíThe error code
issuesarray<object>NoAn array of issues that were responsible for the error

Ejemplo de respuesta

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}