مطوّرو Polylane
كل ما تحتاجه للبناء على Polylane: واجهة API، وخادم MCP، وأداة CLI، وحزمة SDK، وطريقة المصادقة. للوكلاء: هذه الصفحة متاحة أيضًا بصيغة markdown على /developers.md.
البداية السريعة مع Polylane
- احصل على الوصول: Polylane في مرحلة ما قبل الإطلاق؛ انضم إلى قائمة الانتظار في الصفحة الرئيسية (أو
POST https://polylane.com/api/auth/email). - سجّل الدخول: بعد دعوتك، سجّل الدخول على console.polylane.com واربط حسابًا سحابيًا أو مستودعًا.
- أصدر مفتاح API: أنشئ مفتاحًا (
sk_...) في إعدادات وحدة التحكم. - الطلب الأول:
curl https://api.polylane.com/v1/auth/whoami -H "x-api-key: sk_..." - اربط وكيلًا: وجّه أي عميل MCP إلى
https://mcp.polylane.com/mcp. وتسجّل عملاء OAuth أنفسهم علىhttps://mcp.polylane.com/register.
واجهة Polylane API
- العنوان الأساسي:
https://api.polylane.com/v1 - مواصفة OpenAPI 3.0: https://api.polylane.com/v1/doc (نسخة مطابقة على /openapi.json)
- API catalog (RFC 9727): /.well-known/api-catalog
- دليل مصادقة الوكلاء: /auth.md
خوادم Polylane MCP
- المنتج (OAuth 2.0 أو مفتاح API):
https://mcp.polylane.com/mcp: الأدواتsearchوexecuteوsearchToolsوrunToolوrunCodeوstartMappingوadvanceMappingوgetMappingStatus. بطاقة الخادم. - التوثيق (من دون مصادقة):
https://docs.polylane.com/mcp: اعرض كل صفحة توثيق واقرأها.
أداة Polylane CLI
مبنية لتقودها وكلاء البرمجة: مخرجات منظمة وخيارات غير تفاعلية في كل مكان.
curl -fsSL https://polylane.com/setup.sh | bash # macOS / Linux
irm https://polylane.com/setup.ps1 | iex # Windows
polylane auth signup --email you@example.comالتوثيق الكامل لأداة CLI: docs.polylane.com/coding-agents/cli.
حزمة SDK
- npm: @coreplane/polylane
حدود المعدل
الطلبات محدودة المعدل لكل بيانات اعتماد. وعندما تتجاوز حدًا تعيد واجهة API الرمز
429: تراجع قليلًا واحترم Retry-After
عند وجوده، مع تراجع أسّي بدلًا من التكرار المتلاحق.
الإصدارات والإيقاف التدريجي
واجهة API مُرقَّمة الإصدار في مسار العنوان (/v1). التغييرات الجذرية تُطلق فقط في إصدار جديد. ويُعلن عن الإيقاف التدريجي في سجل البناء
ويُوثَّق قبل الإزالة؛ وتواصل الواجهات الموقوفة تدريجيًا العمل خلال فترة الانتقال.
نقاط دخول قابلة للقراءة آليًا
- /llms.txt: فهرس الموقع للوكلاء
- /agent.json: عرض منظم للمنتج (متاح أيضًا على
/?mode=agent) - /.well-known/mcp: اكتشاف MCP
- /.well-known/agent-card.json: بطاقة وكيل A2A
- /.well-known/agent-skills/index.json: فهرس المهارات
الحالة
التوافر المباشر لمنصة Polylane: status.polylane.com.
الدعم
راسل boris@coreplane.ai أو تواصل معنا على X عبر @polylanehq.