YYYY-MM-DD). מסמך ה-OpenAPI שפורסם כולל את גרסת החוזה שלו בשדה
info["x-contract-version"], וכל פעולה מצהירה על שלב מחזור החיים שלה
בשדה x-lifecycle-stage (preview, compatibility או ga).
- המפרט הנוכחי זמין תמיד בכתובת
/v1-reference/openapi-v1.json. - תצלומי מצב של מסמכי העזר לפי גרסאות זמינים בכתובת
/v1-reference/openapi/<version>.json, לדוגמה/v1-reference/openapi/2026-07-01.json.
עדכוני תיעוד
2026-08-25 — המדריכים של/v1 והרשימה של OpenAPI servers מציינים כעת את
מארחים האזוריים הפעילים בארה”ב ובאיחוד האירופי. זהו הבהרה בתיעוד. גרסת החוזה
לא השתנתה. ראו אזורים.
2026-07-01
ה-Public API של/v1 תומך בגרסת חוזה זו. ניתן לקבע אותה באמצעות
Living-Security-Version: 2026-07-01, או להשתמש בגרסת ברירת המחדל שהוקצתה
לחשבון השירות שלכם.
ראו את מדריך ההתחלה המהירה ל-API לבקשה הראשונה שלכם,
אימות למפתחות API ול-OAuth, ו-
אזורים לקבלת המארח הנכון.
2026-08-05
תאריך זה מזהה את חוזה התאימות הישן והנפרד של/api/v1.
הוא אינו ערך של Living-Security-Version עבור ה-API החדש של /v1.
- אנשים: חיפוש אנשים בארגון (
GET /people/search) ואחזור החברוּת של אדם (GET /people/{personId}/membership). - מפתחות גישה ל-API: יצירה, הצגה, החלפה וביטול של מפתחות גישה ל-API
(
POST /access-keys,GET /access-keys,POST /access-keys/{id}/rotate,DELETE /access-keys/{id}).
compatibility. ראו את סקירת ה-Public API לנושאי
אימות, עימוד וטיפול בשגיאות, ואת
מדיניות התאימות וההוצאה משימוש
להסבר כיצד החוזה הזה מתפתח.