مرجع Machine API

• OpenAPI 3.1
• llms.txt
• فهرس واجهة RFC 9727
• مخطط حمولة Webhook v2
• الأسعار والفهرس الحيّان

تُولَّد قائمة العمليات من السجل نفسه الذي يُولَّد منه OpenAPI، بدلًا من نسخها من التوثيق القديم. الطريقة والمسار والـ Scope والـ Scope الشرطي ودعم الـ idempotency تتبع السجل؛ أما الشروحات فتأتي من قاموس مترجم مفتاحه operationId. العملية غير المعروفة تتطلب ترجمة في كل لغة بدلًا من عرض الإنجليزية بصمت.

يستخدم OpenAPI حاليًا كائنات طلب/استجابة عامة للعديد من العمليات. مثال طلب المحفظة العام فيه ليس حمولة صالحة لكل POST. استخدم الأمثلة المدقَّقة في المصادقة وعمليات الشحن وWatchdog لتلك المسارات. المستند مرجع اكتشاف، وليس تأكيدًا بأن كل مسار يشترك في حالة الاستجابة أو الحقول نفسها.

تغطي هذه الوحدة فوترة الآلات عبر x402 وأتمتة Watchdog. تستخدم مسارات البيانات المقاسة واجهاتها القائمة وتُسرد بشكل منفصل. MCP واجهة أدوات للقراءة فقط بمسار حساب OAuth منفصل؛ ولا تغيّر هذه الوحدة تنفيذه. أدلة المستخدم الخاصة بـ Credits وMCP شرائح توثيق منفصلة.

• GET /api/x402/account — Scope: read; جلب رصيد الـ Credits ودفتر الحساب.
• GET /api/x402/account/terms — Scope: read; جلب حالة قبول الشروط.
• POST /api/x402/account/terms — Scope: write; قبول الشروط الحالية.
• GET /api/x402/alerts — Scope: read; عرض سجل التنبيهات.
• DELETE /api/x402/alerts — Scope: write; حذف سجل التنبيهات المحدد.
• DELETE /api/x402/alerts/{id} — Scope: write; حذف تنبيه واحد.
• GET /api/x402/alerts/export — Scope: read; تصدير سجل التنبيهات بصيغة CSV.
• POST /api/x402/auth/challenge — Scope: بدون مصادقة; إنشاء challenge من نوع SIWE محدد بالـ Scopes.
• POST /api/x402/auth/token — Scope: بدون مصادقة; استبدال رسالة SIWE موقّعة بـ bearer token.
• GET /api/x402/auth/tokens — Scope: read; عرض tokens الواجهة الخاصة بالمحفظة.
• DELETE /api/x402/auth/tokens/{id} — Scope: write; إبطال token للواجهة.
• GET /api/x402/channels — Scope: read; عرض حالة القنوات.
• PUT /api/x402/channels/{key} — Scope: write; تكوين قناة إدخال; Idempotency-Key مدعوم.
• DELETE /api/x402/channels/{key} — Scope: write; إزالة هدف قناة.
• POST /api/x402/channels/{key}/test — Scope: write; إرسال اختبار قناة.
• POST /api/x402/message-preview — Scope: read; معاينة رسالة مترجمة.
• GET /api/x402/openapi.json — Scope: بدون مصادقة; جلب مستند OpenAPI هذا.
• GET /api/x402/pricing — Scope: بدون مصادقة; اكتشاف الأسعار والمنتجات والـ watches والإشارات والمساعدة.
• GET /api/x402/provider-fsp — Scope: read; جلب عرض FSP الخاص بالمزوّد.
• GET /api/x402/recipients — Scope: read; عرض المستلمين المسمّين.
• POST /api/x402/recipients — Scope: write; إنشاء مستلم إدخال; Idempotency-Key مدعوم.
• PATCH /api/x402/recipients/{id} — Scope: write; تحديث مستلم.
• DELETE /api/x402/recipients/{id} — Scope: write; حذف مستلم.
• POST /api/x402/recipients/{id}/test — Scope: write; اختبار مستلم.
• POST /api/x402/recipients/telegram-link — Scope: write; إنشاء رابط ربط مستلم Telegram.
• GET /api/x402/settings — Scope: read; جلب إعدادات الإشعارات.
• PUT /api/x402/settings — Scope: write; استبدال إعدادات الإشعارات.
• GET /api/x402/stats — Scope: بدون مصادقة; جلب مجاميع الفوترة العامة.
• GET /api/x402/subscriptions — Scope: read; عرض الاشتراكات والسعة.
• POST /api/x402/subscriptions — Scope: spend; شراء سعة اشتراك; Idempotency-Key مدعوم.
• PATCH /api/x402/subscriptions — Scope: write (spend عندما تكون autoRenew بقيمة true); تحديث Auto-Renew.
• GET /api/x402/subscriptions/quote — Scope: read; عرض سعر لسعة اشتراك.
• POST /api/x402/subscriptions/trial — Scope: write; بدء التجربة لمرة واحدة.
• POST /api/x402/topup — Scope: write; إنشاء مسودة شحن; Idempotency-Key مدعوم.
• GET /api/x402/topup/{handle} — Scope: read; جلب حالة الشحن.
• POST /api/x402/topup/{handle}/confirm — Scope: write; تأكيد معاملة شحن.
• GET /api/x402/watches — Scope: read; عرض الـ watches.
• POST /api/x402/watches — Scope: write; إنشاء watch; Idempotency-Key مدعوم.
• GET /api/x402/watches/{id} — Scope: read; جلب watch.
• PATCH /api/x402/watches/{id} — Scope: write; تحديث watch.
• DELETE /api/x402/watches/{id} — Scope: write; حذف watch.