JobIntel.ai API

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

v1.0.0Scarica specifica OpenAPI
Categorie API
POST/api/auth/login
User login

Authenticate a user and receive session tokens

Authentication

Corpo della Richiesta

User credentials for authentication

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

Risposte

200Login successful
401Invalid credentials
429Too many login attempts

ID Operazione: loginUser

POST/api/auth/logout
User logout

End the current user session

Authentication

Risposte

200Logout successful
401Not authenticated

ID Operazione: logoutUser

GET/api/cover-letters
List cover letters

Get all cover letters for the authenticated user

Cover Letters

Parametri

limitqueryinteger

Maximum number of cover letters to return

Default: 10

offsetqueryinteger

Number of cover letters to skip

Default: 0

Risposte

200List of cover letters
401Not authenticated

ID Operazione: listCoverLetters

POST/api/cover-letters
Create cover letter

Generate a new AI-powered cover letter

Cover Letters

Corpo della Richiesta

Cover letter creation parameters

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

Risposte

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

ID Operazione: createCoverLetter

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

Retrieve a specific cover letter by ID

Cover Letters

Parametri

idpathstringrequired

Unique identifier of the cover letter

Risposte

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

ID Operazione: getCoverLetter

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

Update an existing cover letter

Cover Letters

Parametri

idpathstringrequired

Unique identifier of the cover letter to update

Risposte

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

ID Operazione: updateCoverLetter

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

Remove a cover letter

Cover Letters

Parametri

idpathstringrequired

Unique identifier of the cover letter to delete

Risposte

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

ID Operazione: deleteCoverLetter

POST/api/cv-analysis
Analyze CV

Upload and analyze a CV using AI

CV Analysis

Risposte

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

ID Operazione: analyzeCV

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

Retrieve CV analysis results

CV Analysis

Risposte

200Analysis results
401Not authenticated
404Analysis not found

ID Operazione: getCVAnalysis

GET/api/applications
List job applications

Get all job applications for the user

Applications

Risposte

200List of applications
401Not authenticated

ID Operazione: listApplications

POST/api/applications
Track application

Add a new job application to track

Applications

Risposte

201Application created
400Invalid input
401Not authenticated

ID Operazione: createApplication

POST/api/interview-prep
Generate interview questions

Generate AI-powered interview questions based on job role

Interview Prep

Risposte

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

ID Operazione: generateQuestions

GET/api/user/profile
Get user profile

Retrieve the current user profile

User

Risposte

200User profile
401Not authenticated

ID Operazione: getUserProfile

PUT/api/user/profile
Update user profile

Update user profile information

User

Risposte

200Profile updated
400Invalid input
401Not authenticated

ID Operazione: updateUserProfile

GET/api/subscription
Get subscription status

Check current subscription plan and usage

Billing

Risposte

200Subscription details
401Not authenticated

ID Operazione: getSubscription

POST/api/subscription
Subscribe to plan

Subscribe to a premium plan

Billing

Risposte

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

ID Operazione: createSubscription

Questa documentazione è generata automaticamente

Per maggiori informazioni, consultare la specifica OpenAPI