1
Consultar metadata y catálogos de utilidades
Antes de renderizar los formularios de registro o vacantes, el front debe precargar
catálogos desde
/api/v1/utils/metadata o en
llamadas separadas.
GET /api/v1/utils/metadata
GET /api/v1/utils/sectors
GET /api/v1/utils/countries
GET /api/v1/utils/regions?countryId=COUNTRY_ID
GET /api/v1/utils/skills?sectorId=SECTOR_ID
2
Registrar usuario base
El usuario candidato se crea primero en auth. Ese paso genera la
identidad de acceso, no el perfil completo del candidato.
POST /api/v1/auth/register
{
"email": "candidate1@example.com",
"password": "Secret123",
"role": "CANDIDATE"
}
3
Iniciar sesion y persistir tokens
El frontend debe guardar accessToken y
refreshToken. El access token se usa en
cada llamada protegida.
POST /api/v1/auth/login
{
"email": "candidate1@example.com",
"password": "Secret123"
}
4
Crear perfil del candidato
Con token y rol CANDIDATE, el frontend
crea el perfil funcional con sector, region, experiencia y skills.
POST /api/v1/candidates
Authorization: Bearer <accessToken>
{
"sectorId": "SECTOR_ID",
"countryId": "COUNTRY_ID",
"regionId": "REGION_ID",
"name": "Juan Perez",
"yearsOfExperience": 4,
"videoSpanishUrl": "https://example.com/video-es.mp4",
"videoEnglishUrl": "https://example.com/video-en.mp4",
"photoUrls": ["https://example.com/photo1.jpg"],
"skills": [
{ "skillId": "SKILL_1", "name": "JavaScript", "level": 4 },
{ "skillId": "SKILL_2", "name": "Node.js", "level": 3 }
]
}
5
Subir CV
La carga de CV usa multipart/form-data.
El campo esperado es file.
POST /api/v1/candidates/:id/upload-cv
Authorization: Bearer <accessToken>
Content-Type: multipart/form-data
field: file
6
Consultar planes y suscribirse
El candidato puede listar planes y luego suscribirse con
PATCH /api/v1/candidates/:id/subscribe.
GET /api/v1/plans
Authorization: Bearer <accessToken>
PATCH /api/v1/candidates/:id/subscribe
Authorization: Bearer <accessToken>
{
"planId": "PREMIUM"
}