להתחיל

כלים למפתחים: טוקני 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יומני ריצה של האתר, של worker או של התזמוןקריאה
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

פריסות, יומנים, משתנים וחזרה לגרסה קודמת מהטרמינל, עם אותם טוקני API. נדרש 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 יוצא עם שגיאה כשהגרסה החדשה לא עולה לאוויר, כך שאפשר להתנות בו pipeline. עד שהוא יפורסם, אפשר לעשות את אותו הדבר עם REST API.

«הסבר את השגיאה»

כשפריסה לא מסתיימת, או ששירות מפסיק לעבוד, ליד היומן מופיע הסבר את השגיאה. הוא קורא את השורות האחרונות של היומן ומסביר לכם, בשפה שלכם:

  • סיבה סבירה — מה השתבש;
  • איך לתקן — צעדים מעשיים לסביבה שלכם.

את ההסבר כותב AI על סמך היומן; בדקו אותו לפני שאתם משנים משהו. לפני שמשהו נשלח, כל ערכי המשתנים שלכם וכל מה שנראה כמו מפתח, סיסמה או טוקן מוסתרים מהיומן. הקוד והמשתנים שלכם עצמם אף פעם לא נשלחים.

כל אדם יכול לבקש עד 10 הסברים חדשים ביום; הסבר שכבר נוצר לאותו יומן מוצג שוב בחינם.

Rivervo MCP

אפשר לעבוד עם האפליקציות גם מעוזרי AI דרך Rivervo MCP — זה עובד עם Claude, ‏ChatGPT, ‏Cursor, ‏VS Code ואפליקציות אחרות שתומכות ב-MCP: שאלו על פריסות, יומנים ושגיאות בשיחה, ותנו לעוזר לפרוס או לחזור לגרסה קודמת בשבילכם. לא צריך טוקן; מתחברים עם חשבון Rivervo. ראו Rivervo MCP.

עדיין תקועים?

דברו איתנו בצ׳אט — AI עונה מיד, ומהנדס מצטרף כשצריך, בכל שעה ביממה.

פנייה לתמיכה