API pública · v1
REST API con autenticación por token. JSON en todo. Documentación completa, ejemplos listos para copiar.
Casos de uso
Mantén tus reservaciones, miembros y clases sincronizadas entre Aparto y tus plataformas internas.
Verifica si un miembro tiene créditos disponibles antes de permitirle entrar. Integra con torniquetes o apps.
Consume los datos de Aparto y muéstralos en tu propia interfaz. KPIs, reportes, alertas.
Referencia técnica
Base URL
https://api.aparto.com.mx/v1
Auth
Bearer token en header Authorization
Formato
application/json en request y response
Versionado
Versión en la URL (/v1/). Cambios breaking = nueva versión.
Rate limit
100 requests / minuto por token
Paginación
Cursor-based. Parámetros: cursor, limit (max 100).
Zona horaria
America/Mexico_City. Fechas en ISO 8601.
Ejemplo de request
GET /v1/reservaciones?fecha=2026-04-28
Authorization: Bearer tu_api_key
// Response 200
{
"data": [
{ "id": "res_01",
"miembro": "Valeria M.",
"clase": "Spinning 7am",
"status": "confirmada" }
],
"cursor": "next_page_token"
}
Endpoints
/v1/reservaciones
Lista reservaciones con filtros por fecha, clase o miembro
/v1/reservaciones
Crea una nueva reservación para un miembro
/v1/reservaciones/:id
Cancela una reservación existente
/v1/miembros
Lista todos los miembros activos del negocio
/v1/miembros/:id
Detalle de un miembro: perfil, créditos, historial
/v1/miembros
Registra un nuevo miembro
/v1/clases
Lista clases disponibles con horarios y capacidad
/v1/asistencias
Historial de asistencia con filtros
/v1/asistencias
Registra asistencia y descuenta crédito automáticamente
/v1/finanzas/ingresos
Ingresos por período, sucursal o tipo de paquete
/v1/paquetes
Catálogo de paquetes y precios del negocio
Errores comunes
Unauthorized
Token ausente o inválido. Revisa el header Authorization.
Forbidden
El token no tiene permisos para este recurso.
Not Found
El recurso solicitado no existe.
Unprocessable
Los datos del body no son válidos. Revisa los campos requeridos.
Too Many Requests
Superaste el límite de 100 requests/minuto.
Empieza a integrar
Crea una cuenta, activa el plan y tu key aparece en el panel bajo API.
Crear cuenta gratis