Skip to main content
ה-API הציבורי מוגש תחת /v1 במקור ה-dashboard של Failproof AI שלך.

יצירת מפתח וביצוע בקשה

  1. פתח את Administration → Keys, בחר ב-Create key, ובחר בתצורת ההרשאות הצרה ביותר המכסה את ההשתלבות.
  2. הוסף הרשאות בודדות רק כשנדרש, צור את המפתח, והעתק את הסוד החד-פעמי שלו.
  3. בצע בקשת בדיקה ל-/v1/sessions וודא שהמפתח נשאר פעיל בדף Keys.
  4. סובב או כבה את המפתח מתפריט הפעולות שלו כאשר הבעלות על ההשתלבות משתנה. מגירת המפתח ה-API החדש עם תצורות הרשאות והרשאות בודדות.
מגירת היצירה מוצגת למעלה. הסוד החד-פעמי מופיע רק לאחר שתבחר ב-create; העתק אותו לפני שתסגור את ההשהייה.
מפתחות מחוסנים לארגון וסט הרשאות. בקשה ללא ההרשאה הנדרשת של נקודת הקצה מחזירה 403 ומזהה את ההרשאה החסרה.

בחירת ארגון

מפתח ארגון פועל על הארגון שלו באופן אוטומטי. מפתח בהיקף מופע יכול לבחור ארגון לכל בקשה:
השתמש במחליף הארגון בכותרת ה-dashboard לפני פתיחת Administration → Keys. מפתחות שנוצרו שם שייכים לארגון שנבחר. אשר את slug הארגון ב-URL וההשגחה על המפתח לפני העתקת הרשאות לאוטומציה.
השתמש בדפי נקודת הקצה שנוצרו בסעיף זה עבור נתיבים עדכניים, פרמטרים, דרישות הרשאה וקודי סטטוס. המפרט נוצר מהערות תסריט השרת ובדוק מול נתב /v1. המפרט הנוכחי כולל כיסוי מלא של נתיב, שיטה, פרמטר, הרשאה וקוד סטטוס. גופי תגובה מסוימים נשארים בעלי טיפוס בתכוון מכיוון שהשרת עדיין בונה אותם כ-JSON דינמי. בדוק תגובה אמיתית לפני יצירת לקוח מוקלד חזק סביב נקודת קצה ללא סכמת תגובה. השתמש ב-Content-Type: application/json עבור כתיבת JSON. התייחס ל-401 כהשהייה או אימות לא תקין, 403 כזהות תקפה ללא ההרשאה הנדרשת, 404 כמשאב חסר או לא נגיש לארגון, 409 כסכסוך מדינה, ו-422 כערך שדה או הרשאה לא תקף. תגובות שגיאה כוללות הודעה קריאה לאדם; כישלונות הרשאה גם קוראים לגרנט הנדרש.
פריסת הנהלת המדיניות מנוהלת בתכוון מחוץ לפני /v1 הציבורי הרגיל. השתמש בשרתון Cloud תמך.