تسجيل الدخولإنشاء حساب مجانًا

إعداد وكيل الذكاء الاصطناعي

شارك رابط الاكتشاف هذا مع Claude Code أو Codex أو OpenClaw. سيتبع الوكيل مسار الاكتشاف، ويتحقق من الرمز المكوّن من 8 أرقام، ويحفظ ApiKey طويلة العمر، ثم يبدأ العمل على مساحة العمل الخاصة بك.

الرابط الذي تشاركه مع الوكيل

شارك هذا الرابط كما هو:

https://api.expense-budget-tracker.com/v1/

يمثّل هذا الرابط مستند الاكتشاف العام الرسمي لوكلاء الذكاء الاصطناعي. ومن خلاله يعرف الوكيل كيف يبدأ تدفّق المصادقة، وما نقاط النهاية التي يجب استدعاؤها لاحقًا، وما آلية المصادقة التي يجب استخدامها بعد تسجيل الدخول، وأين يجد مواصفة API المنشورة.

ما الذي يفعله المستخدم

  1. افتح Claude Code أو Codex أو OpenClaw أو أي وكيل آخر يستطيع تنفيذ طلبات HTTP.
  2. اطلب من الوكيل الاتصال بـ Expense Budget Tracker باستخدام https://api.expense-budget-tracker.com/v1/.
  3. عندما يطلب الوكيل عنوان بريد إلكتروني، أدخل البريد الذي تستخدمه مع Expense Budget Tracker.
  4. افحص صندوق الوارد لديك بحثًا عن الرمز المكوّن من 8 أرقام.
  5. أرسل هذا الرمز إلى الوكيل.
  6. اسمح للوكيل بحفظ ApiKey المعادة خارج ذاكرة الدردشة، ثم تابِع مهمة الاستيراد أو الاستعلام أو إعداد الميزانية.

لا يتطلب تسجيل الدخول أي خطوة يدوية لنسخ المفتاح ولصقه. بعد التحقق من رمز البريد الإلكتروني، ينشئ الوكيل اتصاله بنفسه.

ما الذي يفعله الوكيل

التسلسل الكامل هو:

  1. GET https://api.expense-budget-tracker.com/v1/
  2. يقرأ استجابة الاكتشاف ويتبع الإجراءات التي يعيدها الخادم بدلًا من افتراض الخطوات التالية مسبقًا
  3. يرسل POST يتضمن بريد المستخدم إلى bootstrapUrl المعاد
  4. يتلقى otpSessionToken وإجراء verify_code
  5. يطلب من المستخدم رمز البريد الإلكتروني المكوّن من 8 أرقام
  6. يرسل POST يتضمن code وotpSessionToken وlabel للاتصال إلى https://auth.expense-budget-tracker.com/api/agent/verify-code
  7. يتلقى ApiKey جديدة
  8. يحفظ هذا المفتاح خارج ذاكرة الدردشة، ويفضّل أن يكون تحت الاسم EXPENSE_BUDGET_TRACKER_API_KEY
  9. ينفّذ GET https://api.expense-budget-tracker.com/v1/me مع Authorization: ApiKey <key>
  10. ينفّذ GET https://api.expense-budget-tracker.com/v1/workspaces
  11. إذا لزم الأمر، ينشئ مساحة عمل عبر POST /v1/workspaces
  12. يحفظ مساحة عمل افتراضية عبر POST /v1/workspaces/{workspaceId}/select
  13. يفحص العلاقات المسموح بها عبر GET https://api.expense-budget-tracker.com/v1/schema
  14. ينفّذ SQL عبر POST https://api.expense-budget-tracker.com/v1/sql

اختيار مساحة العمل يتم صراحةً، لكنه ليس إجراءً مؤقتًا بلا أثر. بعد POST /v1/workspaces/{workspaceId}/select تُحفَظ مساحة العمل المحددة لهذا المفتاح، لذلك يمكن لطلبات /v1/sql اللاحقة ألا ترسل X-Workspace-Id. ومع ذلك، يمكنك الاستمرار في إرسال X-Workspace-Id لتجاوز مساحة العمل المحفوظة في طلب محدد.

إذا كان لدى المستخدم مساحة عمل واحدة فقط ولم يكن للمفتاح اختيار محفوظ بعد، فإن الواجهة الخلفية تحفظ هذه المساحة وتستخدمها تلقائيًا.

ما الذي يجب على الوكيل حفظه

المفتاح المعاد من verify-code طويل العمر. لذلك لا ينبغي الاعتماد على ذاكرة الدردشة وحدها.

  • احفظه في ملف .env محلي على هيئة EXPENSE_BUDGET_TRACKER_API_KEY='<PASTE_KEY_HERE>' إذا وافق المستخدم على الكتابة إلى الملفات
  • وإلا، صدّره في جلسة الطرفية الحالية على هيئة EXPENSE_BUDGET_TRACKER_API_KEY='<PASTE_KEY_HERE>' واطلب من المستخدم حفظه في مكان دائم

الطلبات الموثّقة تستخدم:

  • Authorization: ApiKey <key>
  • X-Workspace-Id: <workspaceId> فقط إذا أردت تجاوز مساحة العمل المحفوظة أو قبل حفظ أي مساحة عمل

إذا كنت وكيل ذكاء اصطناعي

ابدأ بهذا:

curl https://api.expense-budget-tracker.com/v1/

ثم اتبع الإجراءات التي يعيدها الخادم. لا تفترض أي خطوات لاحقة مسبقًا ما دامت وثيقة الاكتشاف توفّرها بالفعل.

بعد verify-code، احفظ ApiKey المعادة في مكان آمن. ثم حمّل:

  • /v1/me للحصول على سياق الحساب
  • /v1/workspaces للحصول على مساحات العمل المتاحة
  • /v1/schema للحصول على علاقات SQL والأعمدة المسموح بها
  • /v1/openapi.json أو /v1/swagger.json للحصول على مواصفة API المنشورة والقابلة للقراءة آليًا

أمثلة على أوامر يكتبها المستخدم

Claude Code

اتصل بـ Expense Budget Tracker باستخدام https://api.expense-budget-tracker.com/v1/.
استخدم بريدي الإلكتروني عند الحاجة، واطلب مني الرمز المكوّن من 8 أرقام، واحفظ ApiKey المعادة خارج ذاكرة الدردشة، ثم استورد أحدث كشف حساب بنكي لدي من ~/Downloads.

Codex

استخدم https://api.expense-budget-tracker.com/v1/ للاتصال بحسابي في Expense Budget Tracker.
اطلب بريدي الإلكتروني، وانتظر رمز البريد الإلكتروني، واحفظ المفتاح، وافحص /schema، ثم اعرض أحدث معاملاتي.

OpenClaw

اتصل بنفسك بـ Expense Budget Tracker عبر https://api.expense-budget-tracker.com/v1/.
بعد تسجيل الدخول، اعرض مساحات العمل المتاحة لي، واحفظ إحداها كمساحة افتراضية لهذا المفتاح، ثم استورد ملف CSV الجديد الذي رفعته.

ما الذي يمكنك فعله بعد الإعداد

  • استيراد كشوفات البنك أو ملفات تصدير البطاقات
  • تصنيف المعاملات باستخدام الفئات الموجودة لديك
  • التحقق من أرصدة الحسابات بمقارنتها مع البنك
  • الاستعلام عن الإنفاق حسب الفئة أو الفترة أو التاجر أو الحساب
  • تحديث بنود الميزانية للشهر التالي

للاطلاع على نقاط النهاية منخفضة المستوى وتفاصيل المصادقة، راجع مرجع API.