API v1
API para Desarrolladores
Integra JobFlow en tus sistemas con nuestra API REST. Autenticación mediante token Bearer (Laravel Sanctum).
Autenticación
Registra una cuenta, inicia sesión para obtener un token Bearer e inclúyelo en cada solicitud autenticada.
POST /api/v1/auth/register
POST /api/v1/auth/login
POST /api/v1/auth/logout (auth required)
GET /api/v1/auth/me (auth required)
POST /api/v1/auth/login
POST /api/v1/auth/logout (auth required)
GET /api/v1/auth/me (auth required)
El token debe incluirse en el header: Authorization: Bearer {token}
Anuncios de Empleo
Busca anuncios por categoría, posición geográfica y radio. Postúlate directamente vía API.
GET /api/v1/jobs ?category=&location=&radius=&page=
GET /api/v1/jobs/{slug}
GET /api/v1/categories
POST /api/v1/jobs/{id}/apply (auth required)
GET /api/v1/jobs/{slug}
GET /api/v1/categories
POST /api/v1/jobs/{id}/apply (auth required)
Candidaturas
Gestiona las candidaturas: consulta el estado, actualiza (empresas) o retira (trabajadores).
GET /api/v1/applications (auth required)
GET /api/v1/applications/{id} (auth required)
PUT /api/v1/applications/{id}/status (company only)
POST /api/v1/applications/{id}/withdraw (worker only)
GET /api/v1/applications/{id} (auth required)
PUT /api/v1/applications/{id}/status (company only)
POST /api/v1/applications/{id}/withdraw (worker only)
Perfiles
Lee y actualiza el perfil de trabajador o empresa. Accede al trust score.
GET /api/v1/profile/worker (auth required)
PUT /api/v1/profile/worker (auth required)
GET /api/v1/profile/company (auth required)
PUT /api/v1/profile/company (auth required)
GET /api/v1/profile/trust-score (auth required)
PUT /api/v1/profile/worker (auth required)
GET /api/v1/profile/company (auth required)
PUT /api/v1/profile/company (auth required)
GET /api/v1/profile/trust-score (auth required)
Ejemplo de uso
# Login
curl -X POST https://jobflow.trovido.com/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"user@example.com","password":"secret"}'
# Response
{"token":"1|abc...","user":{...}}
# List jobs (with token)
curl https://jobflow.trovido.com/api/v1/jobs?category=chef&page=1 \
-H "Authorization: Bearer 1|abc..."
Notas importantes
- Rate limit: 60 solicitudes/minuto para usuarios autenticados, 30/minuto para anónimos.
- Todas las respuestas están en formato JSON. Content-Type: application/json.
- Las listas soportan paginación: ?page=1&per_page=15 (máx 100).
- Errores devueltos con código HTTP apropiado (401, 403, 404, 422, 429) y body JSON con campo "message".
- El acceso API está disponible para los planes Business y Premium. El plan Starter tiene acceso de solo lectura a los anuncios públicos.
