API Integration Manual - SkillSense AI | מדריך אינטגרציה למפתחים

מבוא כללי

SkillSense API מאפשר לכם לשלב את יכולות הגיוס החכם שלנו במערכות הקיימות שלכם. באמצעות API RESTful פשוט וידידותי למפתחים, תוכלו:

לפרסם משרות חדשות ולנהל משרות קיימות
לקבל ולעבד מועמדויות חדשות
להפעיל הערכות AI אוטומטיות על מועמדים
לקבל תובנות ודירוגים מבוססי בינה מלאכותית
לנהל את כל תהליך הגיוס מהמערכת שלכם

אבטחה מתקדמת

אימות מבוסס API Keys עם הצפנת HTTPS מלאה

ביצועים גבוהים

זמני תגובה מהירים עם זמינות של 99.9%

בינה מלאכותית

אלגוריתמי AI מתקדמים לניתוח וסינון מועמדים

אימות והרשאות בפיתוח

כל הבקשות ל-SkillSense API דורשות אימות באמצעות API Key ייעודי. תקבלו את ה-API Key שלכם דרך פאנל הניהול.

HTTP Headers


Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json

סוג מפתח	הרשאות	סטטוס
`read-only`	קריאת נתונים בלבד	זמין
`read-write`	קריאה ועריכת נתונים	בטא
`admin`	גישה מלאה לכל הפעולות	בפיתוח

התחלת עבודה מהירה

בואו נתחיל עם דוגמה פשוטה לקבלת רשימת המשרות הפעילות שלכם:

cURL


curl -X GET "https://api.skillsense.co.il/v1/jobs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

JavaScript


const response = await fetch('https://api.skillsense.co.il/v1/jobs', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const jobs = await response.json();
console.log(jobs);

PHP


$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.skillsense.co.il/v1/jobs', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Content-Type' => 'application/json',
    ]
]);

$jobs = json_decode($response->getBody(), true);

משרות API בטא

נהלו את כל המשרות שלכם - צרו משרות חדשות, עדכנו קיימות וקבלו סטטיסטיקות מפורטות.

GET /api/v1/jobs

קבלת רשימת כל המשרות הפעילות

GET /api/v1/jobs/{id}

קבלת פרטי משרה ספציפית

POST /api/v1/jobs

יצירת משרה חדשה

PUT /api/v1/jobs/{id}

עדכון פרטי משרה קיימת

DELETE /api/v1/jobs/{id}

מחיקת משרה

GET /api/v1/jobs/{id}/candidates

קבלת מועמדים למשרה ספציפית

מועמדים API בטא

נהלו מועמדים, עדכנו סטטוסים, וקבלו הערכות AI מפורטות.

GET /api/v1/candidates

קבלת רשימת כל המועמדים

GET /api/v1/candidates/{id}

קבלת פרטי מועמד ספציפי

PUT /api/v1/candidates/{id}/status

עדכון סטטוס מועמד

POST /api/v1/candidates/{id}/notes

הוספת הערות למועמד

בינה מלאכותית API בפיתוח

נצלו את כוח הבינה המלאכותית של SkillSense לניתוח מועמדים ויצירת תובנות חכמות.

POST /api/v1/ai/analyze-cv

ניתוח קורות חיים בעזרת AI

POST /api/v1/ai/generate-questions

יצירת שאלות ראיון מותאמות

POST /api/v1/ai/match-score

חישוב ציון התאמה למשרה

טיפול בשגיאות

SkillSense API משתמש בקודי HTTP סטנדרטיים לציון הצלחה או כישלון בקשה:

קוד שגיאה	משמעות	תיאור
`200`	הצלחה	הבקשה בוצעה בהצלחה
`400`	Bad Request	הבקשה לא תקינה או חסרים פרמטרים
`401`	Unauthorized	API Key לא תקין או חסר
`403`	Forbidden	אין הרשאה לבצע פעולה זו
`404`	Not Found	המשאב המבוקש לא נמצא
`429`	Rate Limit	חריגה ממגבלת הקצב המותרת
`500`	Server Error	שגיאה פנימית בשרת

JSON Error Response


{
  "error": {
    "code": 400,
    "message": "Missing required parameter: job_title",
    "details": "The job_title field is required when creating a new job",
    "timestamp": "2024-08-10T12:00:00Z"
  }
}

תמיכה ועזרה

נתקלתם בבעיה או יש לכם שאלות? אנחנו כאן לעזור:

שעות התמיכה: ראשון-חמישי, 09:00-18:00

מספר גרסה נוכחית: v1.8.13