תיעוד ה-API

אימות

כל בקשה נושאת את המפתח שלך (נוצר ב-Settings → Peroot Connect) בכותרת Authorization:

Authorization: Bearer prk_live_XXXX

לחלופין, OAuth 2.1 (PKCE) עבור קונקטורים כמו claude.ai ו-ChatGPT: הלקוח נרשם דינמית, המשתמש מאשר בחלון Peroot, והבקשות נושאות access token במקום מפתח. גילוי אוטומטי דרך /.well-known/oauth-authorization-server.

נקודות הקצה

• post/enhance

  שדרוג פרומפט (צורך 1 קרדיט; cache-hit חינם)

  אותו צינור כמו הפלטפורמה: סקילים פר-פלטפורמה, עובדות זיכרון, פרופיל סגנון ופרופילי מודלים. תומך Idempotency-Key (retry תוך 15 דק׳ לא מחויב שוב) ו-hard-stop של 55ש׳ עם החזר קרדיט.

• get/quota

  יתרת מכסה ומועד חידוש (חינמי)

• get/prompts

  רשימת הפרומפטים השמורים (חינמי)

• post/prompts

  שמירת פרומפט לספרייה + Memory Palace (חינמי)

• get/prompts/search

  חיפוש עמום בספרייה האישית (חינמי)

• get/prompts/{id}

  שליפת פרומפט שמור (חינמי)

• get/prompts/{id}/related

  שכנים ב-Memory Palace, פרומפטים קרובים בגרף (חינמי)

  אותו מנוע כמו גרף ה-Memory Palace בפלטפורמה: דמיון מילות מפתח (Jaccard) + שימוש משותף ב-24 שעות.

• get/chains

  שרשראות הפרומפטים השמורות של המשתמש (חינמי)

• get/chains/{id}

  שרשרת מלאה עם שלביה, להרצה על ידי הסוכן (חינמי)

  ההרצה היא באחריות הסוכן: מלא את משתני כל שלב, הרץ כל prompt_text דרך POST /enhance לפי order, והזן פלטים קדימה לפי input_from_step. כל שלב צורך קרדיט אחד.

• get/library/search

  חיפוש בספרייה הציבורית, תבניות מוכחות (חינמי)

• post/templates/fill

  מילוי תבנית, {משתנים} + דיווח חסרים (חינמי)

• get/user/memory

  עובדות הזיכרון של המשתמש (חינמי)

• post/user/memory

  שמירת עובדה חדשה לזיכרון (חינמי, עד 100)

• post/feedback

  משוב 👍/👎 על שדרוג (חינמי)

סכמות מלאות (שדות, גבולות, enums), ב-OpenAPI. סוכני MCP מקבלים את אותן יכולות ככלים דרך https://www.peroot.space/api/mcp.

קודי שגיאה

כל שגיאה חוזרת כ-{ error, error_en, code } , עברית + אנגלית, כדי שהסוכן יסביר למשתמש בשפתו.