Luna Health API / Referencia de la API / Obtener horarios disponibles Obtener horarios disponibles GET /availability
Lista los horarios disponibles para un profesional de salud y un servicio en un día, según la disponibilidad configurada del profesional, las citas existentes, el tiempo bloqueado y la anticipación mínima de reserva de su organización. Cada horario dura lo que dura el servicio. Las horas están en ISO 8601 con el desfase UTC de la clínica. Envíe el start_time de un horario a POST /appointments para agendarlo.
Ejemplos de código Node.js const fetch = require('node-fetch');
async function llamarApi() {
const claveApi = 'YOUR_API_KEY';
const staffId = 'su-staffId';
const serviceId = 'su-serviceId';
const date = 'su-date';
const locationId = 'su-locationId';
const queryString = new URLSearchParams({
staffId: staffId,
serviceId: serviceId,
date: date,
locationId: locationId
}).toString();
const url = `https://account.lunahealth.app/api/availability` + (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/availability'
headers = {
'Authorization': f'Bearer {claveApi}',
'Content-Type': 'application/json'
}
params = {
'staffId': 'su-staffId',
'serviceId': 'su-serviceId',
'date': 'su-date',
'locationId': 'su-locationId'
}
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 Nombre Ubicación Tipo Requerido Descripción staffIdquery string Sí ID del profesional de salud serviceIdquery string Sí ID del servicio datequery string Sí Día en formato YYYY-MM-DD, en la zona horaria del profesional de salud locationIdquery string No ID de la sucursal
Respuestas Estado Descripción 200Respuesta exitosa 400Datos de entrada no válidos 401Autorización no proporcionada 403Acceso insuficiente 404No encontrado 500Error interno del servidor
200 — Respuesta exitosaCampos de la respuesta Nombre Tipo Requerido Descripción datestring Sí — timezonestring Sí — slotsarray<object> Sí —
Ejemplo de respuesta {
"date": "string",
"timezone": "string",
"slots": [
{
"start_time": "string",
"end_time": "string"
}
]
}400 — Datos de entrada no válidosCampos de la respuesta Nombre Tipo Requerido Descripción messagestring Sí The error message codestring Sí The error code issuesarray<object> No An array of issues that were responsible for the error
Ejemplo de respuesta {
"code": "BAD_REQUEST",
"message": "Invalid input data",
"issues": []
}401 — Autorización no proporcionadaCampos de la respuesta Nombre Tipo Requerido Descripción messagestring Sí The error message codestring Sí The error code issuesarray<object> No An array of issues that were responsible for the error
Ejemplo de respuesta {
"code": "UNAUTHORIZED",
"message": "Authorization not provided",
"issues": []
}403 — Acceso insuficienteCampos de la respuesta Nombre Tipo Requerido Descripción messagestring Sí The error message codestring Sí The error code issuesarray<object> No An array of issues that were responsible for the error
Ejemplo de respuesta {
"code": "FORBIDDEN",
"message": "Insufficient access",
"issues": []
}404 — No encontradoCampos de la respuesta Nombre Tipo Requerido Descripción messagestring Sí The error message codestring Sí The error code issuesarray<object> No An array of issues that were responsible for the error
Ejemplo de respuesta {
"code": "NOT_FOUND",
"message": "Not found",
"issues": []
}500 — Error interno del servidorCampos de la respuesta Nombre Tipo Requerido Descripción messagestring Sí The error message codestring Sí The error code issuesarray<object> No An array of issues that were responsible for the error
Ejemplo de respuesta {
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal server error",
"issues": []
}Abrir en la referencia interactiva →
