כלים למפתחים: טוקני API, REST API, CLI ו«הסבר את השגיאה».
צרו טוקני API עם ההרשאות המתאימות, עבדו עם אפליקציות מסקריפטים ומ-CI דרך REST API ושורת הפקודה rivervo, וקבלו הסברים של AI לפריסות שנכשלו.
כל מה שעושים עם אפליקציות בלוח הבקרה אפשר גם להריץ מסקריפט — פריסות מ-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.