Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Manuelfg1985/Proyecto_Final_26/llms.txt

Use this file to discover all available pages before exploring further.

The Agencia de Habilidades para el Futuro API is a Node.js/Express 5 backend service that powers a job-skills agency platform. It stores and manages applicant records in Firebase Firestore, secures write operations with JWT Bearer tokens, and is deployed on Vercel.

Quickstart

Make your first API call in minutes — list applicants, authenticate, and create records.

Configuration

Set up environment variables for Firebase, JWT, and admin credentials.

Authentication

Understand how JWT tokens are issued and how to protect your requests.

API Reference

Full reference for every endpoint — request parameters, response shapes, and error codes.

What this API does

The API exposes two resource groups:
  • /api/auth — Admin login, token verification, and public/private route testing.
  • /api/postulantes — Full CRUD for job applicants stored in a Firestore postulantes collection.
1

Configure your environment

Copy .env example to .env and fill in your Firebase project credentials and JWT secret. See the Configuration guide.
2

Start the server

npm install
npm start
The server listens on http://localhost:3000 by default.
3

Obtain a JWT token

POST your admin credentials to /api/auth/login to receive a Bearer token valid for 1 hour.
4

Manage applicants

Use the token in the Authorization header to create, update, or delete applicant records via /api/postulantes.

Key features

Firebase Firestore

Applicant records are persisted in a real-time NoSQL Firestore database — no SQL schema migrations needed.

JWT Auth

Stateless authentication using signed JSON Web Tokens with a configurable 1-hour expiry.

Protected Writes

POST, PUT, and DELETE routes require a valid Bearer token; GET routes are publicly accessible.

Vercel Ready

Zero-config deployment to Vercel — the live API is already running at the deploy URL.

Build docs developers (and LLMs) love