HTTP Clients REST

Clientes HTTP para consumo del frontend

Esta pagina centraliza todos los request samples del proyecto para que el front pueda consumir servicios sin depender solo de Swagger. Los ejemplos se mantienen sincronizados con los endpoints documentados en la API y pueden usarse como base para fetch, axios o cualquier cliente HTTP.

Archivos REST client

auth.http

@baseUrl = http://localhost:3000/api/v1

### Register candidate user
POST {{baseUrl}}/auth/register
Content-Type: application/json

{
  "email": "candidate1@example.com",
  "password": "Secret123",
  "role": "CANDIDATE"
}

### Register company user
POST {{baseUrl}}/auth/register
Content-Type: application/json

{
  "email": "company1@example.com",
  "password": "Secret123",
  "role": "COMPANY"
}

### Register admin user
POST {{baseUrl}}/auth/register
Content-Type: application/json

{
  "email": "admin1@example.com",
  "password": "Secret123",
  "role": "ADMIN"
}

### Login
POST {{baseUrl}}/auth/login
Content-Type: application/json

{
  "email": "candidate1@example.com",
  "password": "Secret123"
}

### Refresh token
POST {{baseUrl}}/auth/refresh-token
Content-Type: application/json

{
  "refreshToken": ""
}

### Logout
POST {{baseUrl}}/auth/logout
Content-Type: application/json

{
  "userId": ""
}

candidate-onboarding.context.http

@baseUrl = http://localhost:3000/api/v1
@sectorId =
@countryId =

### List all sectors
GET {{baseUrl}}/onboarding/sectors

### Get sector by id
GET {{baseUrl}}/onboarding/sectors/{{sectorId}}

### List countries
GET {{baseUrl}}/onboarding/countries

### List regions
GET {{baseUrl}}/onboarding/regions?countryId={{countryId}}

### List skills
GET {{baseUrl}}/onboarding/skills?sectorId={{sectorId}}

### Get combined metadata
GET {{baseUrl}}/onboarding/metadata

candidates.http

@baseUrl = http://localhost:3000/api/v1

@accessToken =
@candidateId =

### Create candidate profile
POST {{baseUrl}}/candidates
Authorization: Bearer {{accessToken}}
Content-Type: application/json

{
  "sectorId": "",
  "countryId": "",
  "regionId": "",
  "name": "Juan Pérez",
  "yearsOfExperience": 4,
  "videoSpanishUrl": "https://example.com/video-es.mp4",
  "videoEnglishUrl": "https://example.com/video-en.mp4",
  "photoUrls": ["https://example.com/photo1.jpg"],
  "skills": [
    { "skillId": "", "name": "JavaScript", "level": 4 },
    { "skillId": "", "name": "Node.js", "level": 3 }
  ]
}

### List candidates
GET {{baseUrl}}/candidates?sectorId=&countryId=®ionId=&minExperience=2&isAvailable=true&skillIds=SKILL_1,SKILL_2
Authorization: Bearer {{accessToken}}

### Get candidate profile
GET {{baseUrl}}/candidates/{{candidateId}}
Authorization: Bearer {{accessToken}}

### Get candidate matches
GET {{baseUrl}}/candidates/{{candidateId}}/matches
Authorization: Bearer {{accessToken}}

### Upload candidate CV
POST {{baseUrl}}/candidates/{{candidateId}}/upload-cv
Authorization: Bearer {{accessToken}}
Content-Type: multipart/form-data

------WebKitFormBoundary
Content-Disposition: form-data; name="file"; filename="candidate-cv.pdf"
Content-Type: application/pdf

< ./sample-data/candidate-cv.pdf
------WebKitFormBoundary--

### Subscribe candidate to plan
PATCH {{baseUrl}}/candidates/{{candidateId}}/subscribe
Authorization: Bearer {{accessToken}}
Content-Type: application/json

{
  "planId": "PREMIUM"
}

job-positions.http

@baseUrl = http://localhost:3000/api/v1
@companyAccessToken =
@jobPositionId =

### Create job position
POST {{baseUrl}}/job-positions
Authorization: Bearer {{companyAccessToken}}
Content-Type: application/json

{
  "companyId": "",
  "sectorId": "",
  "title": "Backend Developer",
  "description": "Node.js, PostgreSQL y APIs REST.",
  "requiredYearsOfExperience": 3,
  "skills": ["JavaScript", "Node.js", "PostgreSQL"],
  "skillWeight": 0.7,
  "experienceWeight": 0.3
}

matching.http

@baseUrl = http://localhost:3000/api/v1
@companyAccessToken =
@jobPositionId =
@candidateId =

### Get matching deck
GET {{baseUrl}}/matching/deck/{{jobPositionId}}
Authorization: Bearer {{companyAccessToken}}

### Process swipe
POST {{baseUrl}}/matching/swipe
Authorization: Bearer {{companyAccessToken}}
Content-Type: application/json

{
  "jobPositionId": "{{jobPositionId}}",
  "candidateId": "{{candidateId}}",
  "companyId": "",
  "swipeDirection": "RIGHT"
}

plans.http

@baseUrl = http://localhost:3000/api/v1
@accessToken =
@adminAccessToken =

### List plans
GET {{baseUrl}}/plans
Authorization: Bearer {{accessToken}}

### Get plan by id
GET {{baseUrl}}/plans/ULTIMATE
Authorization: Bearer {{accessToken}}

### Create a plan (ADMIN only)
POST {{baseUrl}}/plans
Authorization: Bearer {{adminAccessToken}}
Content-Type: application/json

{
  "id": "ULTIMATE",
  "name": "Ultimate",
  "description": "Plan empresarial con recomendaciones personalizadas y soporte VIP.",
  "price": 99.99,
  "durationMonths": 1,
  "benefits": ["Soporte VIP", "Visibilidad total", "Recomendaciones personalizadas"],
  "isActive": true
}

### Update a plan (ADMIN only)
PATCH {{baseUrl}}/plans/ULTIMATE
Authorization: Bearer {{adminAccessToken}}
Content-Type: application/json

{
  "price": 89.99,
  "benefits": ["Soporte VIP", "Visibilidad total", "Recomendaciones personalizadas", "Acceso a webinars"]
}

### Delete a plan (ADMIN only)
DELETE {{baseUrl}}/plans/ULTIMATE
Authorization: Bearer {{adminAccessToken}}