API admin

אוטומציה של betool מהמערכות שלכם — מודלים, חשבונות LLM, חיוב, צריכה, יומני ביקורת.

ממשק הניהול (admin) של betool נשען על REST API מאומת (קידומת /api), שניתן להשתמש בו גם מהסקריפטים שלכם: dashboards מותאמים של צריכה, ייצוא יומנים, מעקב אחר יתרת הקרדיטים.

אימות

כל קריאה נושאת טוקן סשן ב-Authorization: Bearer. לשימוש אוטומטי, צרו אסימון CLI ארוך-טווח מתפריט הארגון → הגדרות הארגון → אסימוני CLI (הערך הגלוי מוצג פעם אחת בלבד, ניתן לביטול בכל עת, מגובב (hashed) בצד השרת), ואז החליפו אותו בטוקן סשן:

# 1. החלפת אסימון ה-CLI בסשן (מוגבל קצב: 10 לדקה)
curl -X POST https://platform.betool.ai/api/auth/cli-login \
  -H "Content-Type: application/json" \
  -d "{\"token\": \"$BETOOL_CLI_TOKEN\"}"
# -> {"session_token": "...", "user": {...}, "active_org": {...}, ...}

# 2. קריאה ל-API עם הסשן
curl -H "Authorization: Bearer $BETOOL_SESSION" \
  https://platform.betool.ai/api/auth/me

אסימון CLI מוצמד לארגון אחד; הוא מפסיק לפעול אם מחזיקו הושבת או אינו עוד חבר פעיל בארגון זה. ההרשאות עוקבות אחר החברות (membership) שלו.

סינון

endpoints הרשימה מקבלים פרמטרים ייחודיים לכל משאב (בדרך כלל limit התחום בצד השרת); השדות הזמינים מתועדים בתגובה עצמה.

Endpoints עיקריים

Endpoint	תיאור
`GET /api/auth/me`	זהות, ארגון פעיל, חברויות
`GET /api/admin/models`	רשימת המודלים (pipelines)
`GET /api/admin/llm/accounts`	רשימת חשבונות ה-LLM (סוד מוסתר, `has_api_key`)
`GET /api/admin/billing/state`	תוכנית, יתרת קרדיטים, טעינה אוטומטית
`POST /api/admin/billing/topup`	טעינה ידנית (קישור תשלום)
`GET /api/admin/billing/usage`	יומן צריכה (`limit` ≤ 500, מסנן `source_kind`)
`GET /api/admin/me/supervisor-reads`	יומן ביקורת של גישות cross-tenant

כדי לנהל את התצורה בשפה טבעית (יצירה/עריכה של pipeline באמצעות הצעות, המוחלות רק לאחר שאושרו), העדיפו את שרת ה-MCP: זהו הממשק שתוכנן ללקוחות חיצוניים.

אימות

סינון

Endpoints עיקריים

Webhooks יוצאים

Rate limiting

SDK