ابدأ الآن

أدوات المطورين: رموز API وREST API وCLI و«اشرح هذا الخطأ».

أنشئ رموز API بالصلاحيات المناسبة، واعمل مع التطبيقات من السكربتات وCI عبر REST API وسطر أوامر rivervo، واحصل على شروحات يكتبها AI لعمليات النشر الفاشلة.

3 دقائق قراءة

كل ما تفعله مع التطبيقات في لوحة التحكم يمكن أتمتته أيضًا — النشر من CI، والمتغيرات من سكربت، والسجلات في الطرفية لديك.

رموز API

إعدادات الحساب ← رموز API ← إنشاء رمز. امنحه اسمًا (مكان استخدامه، مثل «GitHub Actions») واختر ما يُسمح له بفعله:

الصلاحيةتسمح بـ
قراءة فقطالتطبيقات وعمليات النشر وسجلاتها وسجلات التشغيل والنطاقات
قراءة ونشرالقراءة، إضافةً إلى النشر والتراجع وإعادة التشغيل
وصول كاملالنشر، إضافةً إلى المتغيرات (قراءة وتغيير) والنطاقات (إضافة وحذف)
وصول كامل والطرفيةالوصول الكامل، إضافةً إلى الأوامر على مواقعك وملفاتها ومهام Cron ومفاتيح SSH والنشر من Git

يمكنك أيضًا تحديد موعد انتهاء صلاحيته — بعد 30 أو 90 أو 365 يومًا، أو أبدًا.

  • يُعرض الرمز مرة واحدة — انسخه فورًا.
  • يعمل الرمز بصلاحيات وصولك. في حساب شخص آخر، يعمل بدورك في التطبيق، وتُطبَّق صلاحية الرمز فوق ذلك. راجع الوصول إلى تطبيق.
  • يمكنك امتلاك حتى 20 رمزًا. يوقف إلغاء الرمز فورًا.
  • أنت وحدك من يمكنه إنشاء رموزك: لا يستطيع ذلك من سجّل الدخول إلى حسابك نيابةً عنك.

REST API

واجهة API موثقة بمعيار OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json. استوردها إلى Postman أو Insomnia أو مولّد كود.

العنوان الأساسي: https://api.rivervo.com/api/v1. أرسل الرمز كـ bearer token:

curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/apps

ما يمكنك فعله:

الطريقة والمسارما يفعلهالصلاحية
GET /appsتطبيقاتك وخدماتهاقراءة
GET /apps/{id}تطبيق واحدقراءة
GET /apps/{id}/deploymentsعمليات نشرهقراءة
POST /apps/{id}/deploymentsالنشر: بناء آخر commit، أو مع {"rebuild": false} نشر الإصدار العامل مجددًانشر
GET /apps/{id}/deployments/{deployment}عملية نشر مع سجل بنائهاقراءة
POST /apps/{id}/deployments/{deployment}/rollbackالعودة إلى ذلك الإصدارنشر
POST /apps/{id}/restartإعادة التشغيلنشر
GET /apps/{id}/logsسجلات تشغيل الموقع أو العامل أو الجدولةقراءة
GET، PUT، PATCH /apps/{id}/envقراءة المتغيرات أو استبدالها أو تحديثهاكامل
GET /apps/{id}/domainsالنطاقاتقراءة
POST /apps/{id}/domains، DELETE /apps/{id}/domains/{name}إضافة نطاق أو حذفهكامل
  • حساب شخص آخر: أضف الترويسة X-Account: <the account's customer ID> للعمل مع تطبيقات حساب مُنحت حق الوصول إليه.
  • الحدود: 120 طلبًا في الدقيقة لكل شخص، منها 30 تغييرًا. عند تجاوزها تُرجع API الرمز 429 مع Retry-After.
  • اللغة: تأتي الرسائل بالإنجليزية افتراضيًا، أرسل Accept-Language: az أو ru للأذربيجانية أو الروسية.
  • تصل المتغيرات المعدّلة عبر API إلى التطبيق مع النشر التالي، كما في لوحة التحكم — ويكفي {"rebuild": false}.

سطر أوامر rivervo

النشر والسجلات والمتغيرات والتراجع من الطرفية لديك، بالرموز نفسها. يحتاج إلى Node.js 22 أو أحدث:

npm install -g rivervo
rivervo login                       # الصق الرمز
rivervo deploy shop                 # بناء آخر commit ومتابعة النشر
rivervo logs shop -f                # متابعة مخرجات التطبيق
rivervo env set shop API_URL=https://example.com
rivervo rollback shop               # العودة إلى الإصدار السابق

في CI يقرأ الرمز من المتغير RIVERVO_TOKEN، وينتهي deploy بخطأ عندما لا يصبح الإصدار الجديد متاحًا، لذا يمكن استخدامه كشرط في خط المعالجة. وإلى أن يُنشر، يمكن فعل الشيء نفسه عبر REST API.

«اشرح هذا الخطأ»

عندما لا يكتمل النشر أو تتوقف خدمة عن العمل، يظهر اشرح هذا الخطأ بجانب السجل. يقرأ آخر أسطر السجل ويخبرك بلغتك:

  • السبب المحتمل — ما الذي حدث بشكل خاطئ؛
  • كيفية الإصلاح — خطوات محددة لبيئتك التقنية.

يكتب AI الشرح بناءً على السجل، فتحقق منه قبل أن تغيّر أي شيء. قبل إرسال أي شيء، تُخفى من السجل كل قيم متغيراتك وكل ما يبدو كمفتاح أو كلمة مرور أو رمز. ولا يُرسل الكود الخاص بك ولا متغيراتك نفسها أبدًا.

يمكن لكل شخص طلب حتى 10 شروحات جديدة يوميًا، ويُعرض الشرح المُعدّ مسبقًا للسجل نفسه مجددًا مجانًا.

Rivervo MCP

يمكنك أيضًا العمل مع تطبيقاتك من مساعدات AI عبر Rivervo MCP — يعمل مع Claude وChatGPT وCursor وVS Code وغيرها من التطبيقات التي تدعم MCP: اسأل عن عمليات النشر والسجلات والأخطاء في محادثة، ودع المساعد ينشر أو يتراجع نيابةً عنك. لا حاجة إلى رمز، فتسجّل الدخول بحساب Rivervo الخاص بك. راجع Rivervo MCP.

ما زلت تحتاج إلى مساعدة؟

تحدّث معنا — يجيب AI فورًا وينضم مهندس عند الحاجة، في أي وقت من اليوم.

تواصل مع الدعم