Referencia API/Endpoints

Endpoints

Lista completa de todos los endpoints disponibles en la API de AstrApp.

Base URL

https://api.astrapp.lat/api/v1

Todos los endpoints usan esta URL base. Requieren autenticación vía header Authorization: Bearer <token>

Autenticación

POST/auth/registerRegistrar usuario

POST/auth/loginIniciar sesión

POST/auth/logoutCerrar sesión

GET/auth/api-keysListar API keys

POST/auth/api-keysCrear API key

DELETE/auth/api-keys/{id}Revocar API key

Proyectos

GET/projectsListar proyectos

POST/projectsCrear proyecto

GET/projects/{id}Obtener proyecto

PATCH/projects/{id}Actualizar proyecto

DELETE/projects/{id}Eliminar proyecto

Datasets

GET/projects/{id}/datasetsListar datasets

POST/projects/{id}/datasetsCrear dataset

GET/projects/{id}/datasets/{datasetId}Obtener dataset

POST/projects/{id}/datasets/{datasetId}/uploadSubir archivo

DELETE/projects/{id}/datasets/{datasetId}Eliminar dataset

Entrenamiento

POST/projects/{id}/trainingIniciar entrenamiento

GET/projects/{id}/training/{jobId}Estado del job

GET/projects/{id}/training/{jobId}/metricsMétricas por época

GET/projects/{id}/training/{jobId}/logsLogs en streaming

DELETE/projects/{id}/training/{jobId}Cancelar training

Modelos

GET/projects/{id}/modelsListar modelos

GET/projects/{id}/models/{modelId}Obtener modelo

PATCH/projects/{id}/models/{modelId}Actualizar modelo

POST/projects/{id}/models/{modelId}/exportExportar modelo

POST/projects/{id}/models/{modelId}/deployDesplegar modelo

Inferencia

POST/inference/{modelId}/predictPredicción única

POST/inference/{modelId}/chatChat con streaming

POST/chat/completionsChat completions (OpenAI compatible)

Evaluación

GET/projects/{id}/experimentsListar experimentos

POST/projects/{id}/experimentsCrear experimento

GET/projects/{id}/experiments/{expId}Obtener experimento

POST/projects/{id}/experiments/{expId}/runsCrear run

Integraciones

GET/integrations/webhooksListar webhooks

POST/integrations/webhooksCrear webhook

DELETE/integrations/webhooks/{id}Eliminar webhook

POST/integrations/hubspot/connectConectar HubSpot

POST/integrations/n8n/triggerTrigger n8n

Analytics

GET/analytics/projects/{id}Analytics de proyecto

GET/analytics/models/{id}Analytics de modelo

Facturación

GET/billing/subscriptionsObtener suscripción

GET/billing/usageUso actual

GET/billing/invoicesListar facturas

Códigos de Estado

200OK - Request exitoso

201Created - Recurso creado

202Accepted - Procesamiento asíncrono

204No Content - Sin contenido

400Bad Request - Datos inválidos

401Unauthorized - Token inválido

403Forbidden - Sin permisos

404Not Found - No encontrado

429Too Many Requests - Rate limit

500Server Error - Error interno

Rate Limits

Plan	Requests/mes	Burst
Free	5,000	10 req/10s
Professional	50,000	50 req/10s
Enterprise	Ilimitado	200 req/10s

Proyectos