API v1
डेवलपर API
REST API के माध्यम से JobFlow को अपने सिस्टम में एकीकृत करें। Bearer टोकन प्रमाणीकरण (Laravel Sanctum)।
प्रमाणीकरण
एक खाता पंजीकृत करें, लॉगिन करके Bearer टोकन प्राप्त करें, और प्रत्येक प्रमाणित अनुरोध में टोकन शामिल करें।
POST /api/v1/auth/register
POST /api/v1/auth/login
POST /api/v1/auth/logout (auth required)
GET /api/v1/auth/me (auth required)
POST /api/v1/auth/login
POST /api/v1/auth/logout (auth required)
GET /api/v1/auth/me (auth required)
टोकन हेडर में शामिल करना होगा: Authorization: Bearer {token}
नौकरी के विज्ञापन
श्रेणी, भौगोलिक स्थान और दूरी के अनुसार नौकरियां खोजें। API के माध्यम से सीधे आवेदन करें।
GET /api/v1/jobs ?category=&location=&radius=&page=
GET /api/v1/jobs/{slug}
GET /api/v1/categories
POST /api/v1/jobs/{id}/apply (auth required)
GET /api/v1/jobs/{slug}
GET /api/v1/categories
POST /api/v1/jobs/{id}/apply (auth required)
आवेदन
आवेदन प्रबंधित करें: स्थिति देखें, अपडेट करें (कंपनियां) या वापस लें (नौकरी खोजने वाले)।
GET /api/v1/applications (auth required)
GET /api/v1/applications/{id} (auth required)
PUT /api/v1/applications/{id}/status (company only)
POST /api/v1/applications/{id}/withdraw (worker only)
GET /api/v1/applications/{id} (auth required)
PUT /api/v1/applications/{id}/status (company only)
POST /api/v1/applications/{id}/withdraw (worker only)
प्रोफ़ाइल
नौकरी खोजने वाले या कंपनी प्रोफ़ाइल पढ़ें और अपडेट करें। विश्वास स्कोर तक पहुंचें।
GET /api/v1/profile/worker (auth required)
PUT /api/v1/profile/worker (auth required)
GET /api/v1/profile/company (auth required)
PUT /api/v1/profile/company (auth required)
GET /api/v1/profile/trust-score (auth required)
PUT /api/v1/profile/worker (auth required)
GET /api/v1/profile/company (auth required)
PUT /api/v1/profile/company (auth required)
GET /api/v1/profile/trust-score (auth required)
उपयोग उदाहरण
# Login
curl -X POST https://jobflow.trovido.com/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"user@example.com","password":"secret"}'
# Response
{"token":"1|abc...","user":{...}}
# List jobs (with token)
curl https://jobflow.trovido.com/api/v1/jobs?category=chef&page=1 \
-H "Authorization: Bearer 1|abc..."
महत्वपूर्ण नोट्स
- दर सीमा: प्रमाणित उपयोगकर्ता 60 अनुरोध/मिनट, अनाम 30/मिनट।
- सभी प्रतिक्रियाएं JSON प्रारूप में हैं। Content-Type: application/json।
- सूचियां पेजिनेशन का समर्थन करती हैं: ?page=1&per_page=15 (अधिकतम 100)।
- त्रुटियां उचित HTTP कोड (401, 403, 404, 422, 429) और JSON मैसेज बॉडी के साथ लौटाई जाती हैं।
- API एक्सेस बिजनेस और प्रीमियम प्लान के लिए उपलब्ध है। स्टार्टर प्लान केवल सार्वजनिक नौकरियों को पढ़ सकता है।
