JobIntel.ai API

RESTful API for JobIntel.ai - AI-powered career assistance platform

v1.0.0Descargar especificación OpenAPI
Categorías de la API
POST/api/auth/login
User login

Authenticate a user and receive session tokens

Authentication

Cuerpo de la solicitud

User credentials for authentication

application/jsonrequired
emailstringemailrequiredUser email address
passwordstringrequiredUser password (minimum 8 characters)

Respuestas

200Login successful
401Invalid credentials
429Too many login attempts

ID de operación: loginUser

POST/api/auth/logout
User logout

End the current user session

Authentication

Respuestas

200Logout successful
401Not authenticated

ID de operación: logoutUser

GET/api/cover-letters
List cover letters

Get all cover letters for the authenticated user

Cover Letters

Parámetros

limitqueryinteger

Maximum number of cover letters to return

Default: 10

offsetqueryinteger

Number of cover letters to skip

Default: 0

Respuestas

200List of cover letters
401Not authenticated

ID de operación: listCoverLetters

POST/api/cover-letters
Create cover letter

Generate a new AI-powered cover letter

Cover Letters

Cuerpo de la solicitud

Cover letter creation parameters

application/jsonrequired
jobTitlestringrequiredThe job title to apply for
companystringrequiredCompany name
jobDescriptionstringrequiredFull job posting description
cvIdstringuuidReference to uploaded CV (optional)

Respuestas

201Cover letter created
400Invalid input
401Not authenticated
429Rate limit exceeded

ID de operación: createCoverLetter

GET/api/cover-letters/{id}
Get cover letter

Retrieve a specific cover letter by ID

Cover Letters

Parámetros

idpathstringrequired

Unique identifier of the cover letter

Respuestas

200Cover letter details
401Not authenticated
404Cover letter not found

ID de operación: getCoverLetter

PUT/api/cover-letters/{id}
Update cover letter

Update an existing cover letter

Cover Letters

Parámetros

idpathstringrequired

Unique identifier of the cover letter to update

Respuestas

200Cover letter updated
400Invalid input
401Not authenticated
404Cover letter not found

ID de operación: updateCoverLetter

DELETE/api/cover-letters/{id}
Delete cover letter

Remove a cover letter

Cover Letters

Parámetros

idpathstringrequired

Unique identifier of the cover letter to delete

Respuestas

204Cover letter deleted
401Not authenticated
404Cover letter not found

ID de operación: deleteCoverLetter

POST/api/cv-analysis
Analyze CV

Upload and analyze a CV using AI

CV Analysis

Respuestas

200Analysis complete
400Invalid file format
401Not authenticated
413File too large
429Rate limit exceeded

ID de operación: analyzeCV

GET/api/cv-analysis/{id}
Get CV analysis

Retrieve CV analysis results

CV Analysis

Respuestas

200Analysis results
401Not authenticated
404Analysis not found

ID de operación: getCVAnalysis

GET/api/applications
List job applications

Get all job applications for the user

Applications

Respuestas

200List of applications
401Not authenticated

ID de operación: listApplications

POST/api/applications
Track application

Add a new job application to track

Applications

Respuestas

201Application created
400Invalid input
401Not authenticated

ID de operación: createApplication

POST/api/interview-prep
Generate interview questions

Generate AI-powered interview questions based on job role

Interview Prep

Respuestas

200Questions generated
400Invalid input
401Not authenticated
429Rate limit exceeded

ID de operación: generateQuestions

GET/api/user/profile
Get user profile

Retrieve the current user profile

User

Respuestas

200User profile
401Not authenticated

ID de operación: getUserProfile

PUT/api/user/profile
Update user profile

Update user profile information

User

Respuestas

200Profile updated
400Invalid input
401Not authenticated

ID de operación: updateUserProfile

GET/api/subscription
Get subscription status

Check current subscription plan and usage

Billing

Respuestas

200Subscription details
401Not authenticated

ID de operación: getSubscription

POST/api/subscription
Subscribe to plan

Subscribe to a premium plan

Billing

Respuestas

201Subscription created
400Invalid plan
401Not authenticated
402Payment required

ID de operación: createSubscription

Esta documentación se genera automáticamente

Para más información, consulte la especificación OpenAPI