جديد! |استدعاء API واحد وبيانات نظيفة. بلا حاجة لأدوات استخراج.← احصل على 10,000 توكن مجاني

منصة المطورين

FineProxy API وMCP

أتمت عمليات البروكسي من الكود أو اربط وكيل ذكاء اصطناعي. تعرّف على ما هو مدعوم، وأين تنطبق ضمانات الأمان، وكيفية تدقيق تكامل قائم قبل الانتقال إلى مزوّد آخر.

REST API49 عملية OpenAPI
خادم MCP49 أداة للوكيل
الوصولمفاتيح API محددة النطاق

منصة واحدة وطريقتان للأتمتة

تستخدم API وMCP مفاتيح FineProxy محددة النطاق نفسها وتتيحان سير عمل العملاء نفسه. اختر بناءً على من سيتولى تشغيلها: تطبيقك أم وكيل ذكاء اصطناعي.

REST · OpenAPI 3.1

ادمج FineProxy في تطبيقك

استخدم نقاط نهاية HTTP الموثقة من واجهة خلفية أو برنامج نصي أو مهمة CI أو لوحة داخلية أو سير عمل بلا برمجة. تتوفر مواصفات العميل الحالية في لوحة التحكم.

الأنسب عندما يجب أن ينفّذ الكود لديك ما يلي:
  • تشغيل سير عمل حتمي من دون نموذج ذكاء اصطناعي
  • التحقق من بنى الطلبات والاستجابات وفق OpenAPI
  • التحكم بنفسك في إعادة المحاولة وقوائم الانتظار والسجلات والنشر
فتح توثيق API

JSON-RPC 2.0 · Streamable HTTP

امنح وكيل ذكاء اصطناعي وصولًا مضبوطًا

اربط Cursor أو Claude أو VS Code أو Cline أو n8n أو أي عميل MCP آخر بخادم FineProxy. يتلقى الوكيل الأدوات التي تسمح بها نطاقات مفتاح API.

الأنسب عندما تريد من الوكيل ما يلي:
  • فحص المخزون والخدمات والاستخدام وسجل الدعم
  • تسعير عمليات الخدمة المعتمدة وتنفيذها
  • تشخيص الأعطال وشرح التغييرات الموصى بها
فتح إعداد MCP في لوحة التحكم

دقّق تكاملًا قائمًا قبل الترحيل

نزّل ملف Markdown واحدًا، وأرفقه مع مستودعك إلى وكيل برمجة، وشغّل موجه التدقيق المُعد مسبقًا. المرحلة الأولى للقراءة فقط: تحدد التوافق والمحوّلات والعوائق والكود الدقيق الذي سيحتاج إلى تغيير.

موجه تدقيق الترحيل للقراءة فقط
اقرأ حزمة وكيل FineProxy المرفقة وافحص هذا المستودع.

لا تعدّل الكود خلال المرحلة الأولى.

ابحث عن كل موضع يُهيّأ فيه مزوّد البروكسي الحالي أو يُستدعى. قارن كل سير عمل بإمكانات FineProxy الموثقة. أبلغ عن:
1. مسارات العمل المتوافقة بالكامل.
2. مسارات العمل التي تحتاج إلى محوّل أو تحويل بيانات.
3. السلوك غير المدعوم أو غير الواضح.
4. أذونات FineProxy API المطلوبة.
5. الملفات ومسارات الكود الدقيقة التي ستتغير.
6. التغييرات في المصادقة وتخزين الأسرار.
7. خطة ترحيل مرحلية مع التراجع.
8. اختبارات التكامل اللازمة قبل التحويل.

لا تخترع نقاط نهاية. ضع علامة استفهام على أي أمر لا تؤكده حزمة الوكيل أو مواصفات OpenAPI الحالية.

ينبغي أن يتحقق التدقيق مما يلي

  1. 01مواضع تهيئة مزوّد الخدمة الحالي واستدعائه
  2. 02الاختلافات في المصادقة وتخزين الأسرار
  3. 03سير عمل شراء الخدمة وتجديدها وإلغائها وتحديث عناوين IP
  4. 04تنسيقات قوائم البروكسي والبروتوكولات والمنافذ وأساليب المصادقة
  5. 05اختيار الدول وقوائم السماح وحدود الاتصالات
  6. 06التصفح بالصفحات وإعادة المحاولة وعدم التكرار والأخطاء ومعالجة حدود المعدل
  7. 07تبعيات الفوترة وتحليلات الاستخدام والدعم وخطافات الويب
  8. 08خطة ترحيل واختبار لكل ملف من دون تعديل الكود

للتنفيذ على مستوى نقاط النهاية، زوّد الوكيل أيضًا بملف OpenAPI الحالي الذي نزّلته من لوحة التحكم. لا تحتوي حزمة الوكيل عمدًا على بيانات اعتماد أو بيانات حساب خاصة.

ما يمكنك أتمتته

تشرح الصفحة العامة سير العمل الكامل بدلًا من تكرار كل نقطة نهاية. استخدم مواصفات OpenAPI المباشرة عند تنفيذ الطلبات الفردية.

01

الشراء والتوفير

استكشف المخزون المباشر، واحسب مزيجًا دقيقًا من الدول، وقدّم طلبًا من محفظة لوحة التحكم.

  • عرض الدول المتاحة والمخزون الحالي من عناوين IP
  • تسعير حزمة متعددة الدول من دون الالتزام بأموال
  • الشراء مع قيد للسعر ومفتاح عدم تكرار
02

إدارة الخدمات

شغّل الخدمات النشطة من دون انتظار تذكرة دعم عندما تدعم الخطة الإجراء المطلوب.

  • تجديد الخدمات أو تعليقها أو استعادتها أو إلغاؤها
  • استبدال عناوين IP أو إضافتها وتحديث بيانات الاعتماد
  • إدارة التجديد التلقائي وقوائم السماح وإضافات الاتصال
03

التحليلات والتشخيص

استخدم بيانات القياس للحساب والخدمة للتحقق من الحمل والموثوقية وسلوك الوجهات.

  • قراءة النظرات العامة للاستخدام والسلاسل الزمنية
  • فحص أهم الوجهات وفئات الأخطاء
  • تلقي التشخيصات والتوصيات التشغيلية
04

الفوترة والدعم

اربط عمليات البروكسي بسير العمل المالي وسير عمل الدعم المحيط بها.

  • قراءة الفواتير وتنزيل ملفات PDF الخاصة بها
  • بدء إيداع في المحفظة والتحقق من حالته
  • إنشاء تذاكر الدعم وقراءتها والرد عليها وإغلاقها
05

الوصول عبر البروكسي

استرجع الإعدادات التي تحتاجها التطبيقات للاتصال عبر البروكسيات المشتراة.

  • قراءة إعداد اتصال البروكسي المتناوب
  • تغيير اسم دخول الخدمة وكلمة المرور
  • إدارة حدود الاتصالات لكل عنوان IP في قائمة السماح
06

الأحداث والحساب

حافظ على مزامنة الأنظمة الخارجية وافحص معلومات الحساب ذات الصلة بالأمان.

  • تهيئة خطافات الويب ومعالجة التسليم
  • قراءة بيانات الملف الشخصي وعنوان IP للمتصل وسجل تسجيل الدخول
  • إدارة مفاتيح API بأذونات محددة بدقة

ما لن تفعله المنصة

أتمتة FineProxy محدودة عن قصد. يتحدد الوصول وفق المفتاح وخطة الخدمة والمخزون المباشر وفحوصات الأمان الصريحة.

لا وصول خارج النطاقات الممنوحة

لا يمكن لأداة أو نقطة نهاية قراءة مورد أو تغييره ما لم يتضمن مفتاح API الإذن المطلوب.

لا إنفاق من دون wallet:spend

تظل عمليات الشراء والتجديد وتحديثات IP المدفوعة غير متاحة عند غياب النطاق المالي.

لا إجراءات تدميرية خفية

تتطلب العمليات غير القابلة للعكس علامة تأكيد صريحة، ولا يمكن أن تحدث بوصفها أثرًا جانبيًا لطلب قراءة.

لا وصول إلى الكود المصدري عبر MCP

يشغّل FineProxy MCP حساب العميل. ولتدقيق برنامج نصي، يجب أيضًا منح وكيل البرمجة وصولًا إلى ذلك البرنامج أو المستودع.

لا ضمان لمخزون غير متاح

يُتحقق من توافر الدول والكميات وفق المخزون المباشر. لا تستطيع الأتمتة طلب مخزون غير متاح.

لا API للشركاء غير النشطين

لا تظهر مواصفات الشركاء ونقاط نهاية التقارير إلا عندما يكون للحساب وضع شريك نشط.

اربط وكيلًا خلال دقائق

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

mcp.json
{
  "mcpServers": {
    "fineproxy": {
      "url": "https://fineproxy.org/account_new/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer fb_YOUR_API_KEY"
      }
    }
  }
}

OpenAPI 3.1

استخدم المواصفات المباشرة للتنفيذ

تعرض لوحة التحكم مواصفات OpenAPI 3.1 المنقحة للعميل، وأمثلة الطلبات، ومخططات الاستجابات، ومقتطفات العميل المُنشأة. ويحصل الشركاء النشطون أيضًا على مواصفات منفصلة للشركاء.

عرض مرجع API التفاعلي

اختر أصغر مجموعة أذونات مفيدة

يُفصل وصول القراءة عن الكتابة. ابدأ بنطاقات القراءة فقط للاستكشاف وتدقيق الترحيل، ثم أضف وصول الكتابة أو الوصول المالي فقط إلى سير العمل الذي يتطلبه.

customer:read

قراءة الملف الشخصي للعميل ومعلومات الحساب.

customer:write

تحديث معلومات العميل.

wallet:read

عرض رصيد المحفظة وبياناتها.

wallet:deposit

إنشاء إيداعات المحفظة ومراقبتها.

wallet:spend

السماح للأتمتة بإنفاق أموال المحفظة.

services:read

عرض الخدمات وإعدادات البروكسي وحالة الخدمة.

services:write

إنشاء الخدمات والإضافات أو تعديلها.

tickets:read

قراءة تذاكر الدعم ورسائلها.

tickets:write

إنشاء التذاكر أو الرد عليها أو تحديثها أو إغلاقها.

catalog:read

قراءة المنتجات والخيارات والدول والمخزون الحالي.

usage:read

قراءة استخدام الخدمة والتحليلات التشخيصية.

webhooks

إنشاء اشتراكات خطافات الويب وإدارتها.

إعدادات أمان افتراضية يجدر الحفاظ عليها

  • أنشئ مفتاح API منفصلًا لكل تطبيق أو وكيل كي يمكن إبطاله بشكل مستقل.
  • ابدأ التدقيق بنطاقات القراءة فقط. لا تضف services:write أو wallet:spend إلا بعد مراجعة الخطة المقترحة.
  • خزّن المفاتيح في متغيرات البيئة أو مدير أسرار، ولا تضعها مطلقًا في الكود المصدري أو الموجهات أو لقطات الشاشة أو إعداد MCP المودع في المستودع.
  • استخدم الإجمالي المتوقع الوارد في عرض السعر للمشتريات. يؤدي تغير السعر إلى رفض العملية بدلًا من تحصيل مبلغ أكبر بصمت.
  • أعد استخدام مفتاح عدم التكرار عند إعادة محاولة طلب مالي انتهت مهلته كي لا تُحصّل تكلفة العملية نفسها مرتين.
  • راجع توقيعات خطافات الويب وسجل التسليم قبل جعل الأحداث جزءًا من سير عمل حرج.

ابدأ بالرؤية ثم امنح التحكم

يجيب تدقيق للقراءة فقط عما إذا كان الترحيل ممكنًا من دون إتاحة وصول مالي أو وصول للكتابة. بعد اعتماد الخطة، أنشئ مفتاح إنتاج محدود النطاق ونفّذ وفق مواصفات OpenAPI المباشرة.