Turso

يُربط Turso برمز API للمنصة:

1. افتح Turso، وانتقل إلى صفحة API Tokens في إعدادات حسابك، أو شغّل turso auth api-tokens mint polylane من CLI.
2. انسخ رمز API للمنصة.
3. الصق الرمز في Polylane. إذا كان الرمز يستطيع الوصول إلى أكثر من مؤسسة، فاختر المؤسسة التي تريد ربطها عند المطالبة.
4. يتحقق Polylane من الرمز ويبدأ المزامنة.

يغطي كل اتصال مؤسسة Turso واحدة. يكتشف Polylane مجموعات قواعد بياناتها وقواعد بياناتها، بما في ذلك المواقع والتوزيع ونسب التفريع وحالة القراءة/الكتابة. تُشفَّر الرموز قبل تخزينها، ولا يراها الوكيل أبداً. لا يقرأ Polylane إلا Platform API؛ فلا يتصل أبداً بقواعد بياناتك ولا يحتفظ أبداً ببيانات اعتماد لقواعد البيانات.

تبلّغ Platform API في Turso عن الاستخدام كعدّادات تراكمية لفترة الفوترة لا كسلاسل زمنية، فلا تحمل قواعد البيانات رسوماً بيانية للمقاييس. تستطلع المراقبة تلك العدّادات وتراقب الفروق بدلاً من ذلك: يُفحص كل من حجم القراءة والكتابة، وحركة المزامنة، ونمو التخزين، وعدد قواعد البيانات، واستهلاك الحصة مقابل خطتك، وأثقل الاستعلامات لكل قاعدة بيانات مقابل تاريخ الحساب نفسه.

استكشاف الأخطاء

خطأ "Invalid Turso API token"

• تختلف رموز API للمنصة عن رموز مصادقة قواعد البيانات؛ أصدر واحداً بـ turso auth api-tokens mint أو من إعدادات حسابك.
• تحقق من أن الرمز لم يُلغَ في إعدادات Turso.

خطأ "Multiple Turso organizations are reachable"

• يستطيع الرمز الوصول إلى أكثر من مؤسسة، فسمّ المؤسسة التي تريد ربطها.
• عند الربط في وحدة التحكم، اختر المؤسسة عند المطالبة بعد التحقق.
• عند الربط عبر API، عيّن حقل organization إلى slug المؤسسة.

موارد مفقودة

• قد يستغرق Turso بضع دقائق لمزامنة كل شيء.
• أطلق Sync يدوياً من رأس الحساب للتحديث.

الفصل

افصل الحساب في Polylane، ثم ألغِ رمز API من إعدادات حساب Turso الخاص بك أو بـ turso auth api-tokens revoke.

لا يحتاج ربط Turso إلى متصفح: نقطة النهاية نفسها التي تستدعيها وحدة التحكم تناسب مهمة CI. ينشئ طلب POST موثَّق واحد الاتصال ويبدأ المزامنة الأولى.

المتطلبات الأساسية

• مفتاح API من Polylane بنطاقَي cloud_accounts:write وcloud_accounts:read. انظر مفاتيح API وOAuth.
• معرّف مساحة عملك، الذي يبدأ بـ ws_. اقرأه من GET /v1/workspaces بالمفتاح نفسه.
• رمز API لمنصة Turso، مُصدَر من إعدادات حسابك أو بـ turso auth api-tokens mint polylane.

إنشاء الاتصال

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "turso",
    "workspaceId": "ws_0abc123",
    "token": "<platform-api-token>",
    "organization": "my-org-slug"
  }'

يربط استدعاء واحد مؤسسة Turso واحدة.

• لا يجوز حذف organization إلا حين يصل الرمز إلى مؤسسة واحدة بالضبط؛ وإلا يفشل الاستدعاء بالرمز 400 الذي يسرد slugs المؤسسات التي يمكن الوصول إليها.

تسرد الاستجابة ما رُبط، مع المزامنة الأولى جارية أصلاً. مختصرة إلى الحقلين اللذين تقرؤهما بقية التدفق:

{
  "success": true,
  "result": {
    "provider": "turso",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

يقع الحساب المربوط أصلاً في failures بدلاً من accounts، فلا يكرر تكرار الاستدعاء اتصالاً أبداً.

انتظار المزامنة الأولى

استطلع كل حساب مُعاد عبر id الخاص به حتى تصل status إلى ready (‏new عند التسجيل، وsyncing أثناء تدفق الموارد):

until [ "$(curl -s "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY" | jq -r '.result.status')" = "ready" ]; do
  sleep 15
done

أعطِ الحلقة موعداً نهائياً ليُفشل الربط الفاشل المهمة بدلاً من تعليقها. وبعد أن يصبح الحساب ready، تكون موارده في Topology ويكون Polylane قد بدأ فحصه الأول.

الفصل من API

يوقف حذف الاتصال كل مزامنة وفحص ويحذف بيانات الاعتماد التي احتفظ بها Polylane. يحتاج الاستدعاء إلى نطاق cloud_accounts:delete:

curl -X DELETE "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY"

ثم ألغِ بيانات اعتماد Turso على جانب المزود، كما هو موضح تحت الفصل أدناه.