JobIntel.ai API

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

v1.0.0Ladda ner OpenAPI-specifikation
API-kategorier
POST/api/auth/login
User login

Authenticate a user and receive session tokens

Authentication

Request Body

User credentials for authentication

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

Svar

200Login successful
401Invalid credentials
429Too many login attempts

Operations-ID: loginUser

POST/api/auth/logout
User logout

End the current user session

Authentication

Svar

200Logout successful
401Not authenticated

Operations-ID: logoutUser

GET/api/cover-letters
List cover letters

Get all cover letters for the authenticated user

Cover Letters

Parametrar

limitqueryinteger

Maximum number of cover letters to return

Default: 10

offsetqueryinteger

Number of cover letters to skip

Default: 0

Svar

200List of cover letters
401Not authenticated

Operations-ID: listCoverLetters

POST/api/cover-letters
Create cover letter

Generate a new AI-powered cover letter

Cover Letters

Request Body

Cover letter creation parameters

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

Svar

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

Operations-ID: createCoverLetter

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

Retrieve a specific cover letter by ID

Cover Letters

Parametrar

idpathstringrequired

Unique identifier of the cover letter

Svar

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

Operations-ID: getCoverLetter

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

Update an existing cover letter

Cover Letters

Parametrar

idpathstringrequired

Unique identifier of the cover letter to update

Svar

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

Operations-ID: updateCoverLetter

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

Remove a cover letter

Cover Letters

Parametrar

idpathstringrequired

Unique identifier of the cover letter to delete

Svar

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

Operations-ID: deleteCoverLetter

POST/api/cv-analysis
Analyze CV

Upload and analyze a CV using AI

CV Analysis

Svar

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

Operations-ID: analyzeCV

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

Retrieve CV analysis results

CV Analysis

Svar

200Analysis results
401Not authenticated
404Analysis not found

Operations-ID: getCVAnalysis

GET/api/applications
List job applications

Get all job applications for the user

Applications

Svar

200List of applications
401Not authenticated

Operations-ID: listApplications

POST/api/applications
Track application

Add a new job application to track

Applications

Svar

201Application created
400Invalid input
401Not authenticated

Operations-ID: createApplication

POST/api/interview-prep
Generate interview questions

Generate AI-powered interview questions based on job role

Interview Prep

Svar

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

Operations-ID: generateQuestions

GET/api/user/profile
Get user profile

Retrieve the current user profile

User

Svar

200User profile
401Not authenticated

Operations-ID: getUserProfile

PUT/api/user/profile
Update user profile

Update user profile information

User

Svar

200Profile updated
400Invalid input
401Not authenticated

Operations-ID: updateUserProfile

GET/api/subscription
Get subscription status

Check current subscription plan and usage

Billing

Svar

200Subscription details
401Not authenticated

Operations-ID: getSubscription

POST/api/subscription
Subscribe to plan

Subscribe to a premium plan

Billing

Svar

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

Operations-ID: createSubscription

Denna dokumentation är automatiskt genererad

För mer information, se OpenAPI-specifikationen