เครื่องมือนักพัฒนา: API Token, REST API, CLI และ “อธิบายข้อผิดพลาดนี้”
สร้าง API Token ตามขอบเขตที่ต้องการ จัดการแอปพลิเคชันจากสคริปต์และ CI ผ่าน REST API และคำสั่ง rivervo และรับคำอธิบายจาก AI เมื่อการดีพลอยล้มเหลว
ทุกอย่างที่คุณทำกับแอปพลิเคชันในแผงควบคุมทำผ่านสคริปต์ได้เช่นกัน ทั้งการดีพลอยจาก CI ตัวแปรจากสคริปต์ และบันทึกในเทอร์มินัลของคุณ
API Token
การตั้งค่าบัญชี → API Token → สร้าง Token ตั้งชื่อ (ระบุที่ใช้งาน เช่น “GitHub Actions”) แล้วเลือกสิ่งที่ Token ทำได้:
| ขอบเขต | อนุญาต |
|---|---|
| อ่านอย่างเดียว | แอปพลิเคชัน การดีพลอยและบันทึก บันทึกขณะทำงาน โดเมน |
| อ่านและดีพลอย | การอ่าน รวมถึงการดีพลอย การย้อนกลับ และการรีสตาร์ต |
| สิทธิ์เต็ม | การดีพลอย รวมถึงตัวแปร (อ่านและเปลี่ยน) และโดเมน (เพิ่ม ลบ) |
| สิทธิ์เต็มและเทอร์มินัล | สิทธิ์เต็ม รวมถึงคำสั่งบนเว็บไซต์ของคุณ ไฟล์ Cron jobs คีย์ SSH และการดีพลอยจาก Git |
คุณตั้งวันหมดอายุได้ด้วย — หลัง 30, 90 หรือ 365 วัน หรือไม่หมดอายุ
- Token จะแสดง ครั้งเดียว ให้คัดลอกทันที
- Token ทำงานด้วยสิทธิ์ ของคุณ ในบัญชีของผู้อื่น Token ทำงานตามบทบาทของคุณในแอปพลิเคชัน และขอบเขตของ Token จะจำกัดเพิ่มอีกชั้น ดู การเข้าถึงแอปพลิเคชัน
- คุณมี Token ได้สูงสุด 20 รายการ เพิกถอน หยุด Token ทันที
- เฉพาะคุณเท่านั้นที่สร้าง Token ของคุณได้ ผู้ที่เข้าสู่ระบบบัญชีของคุณในนามของคุณสร้างไม่ได้
REST API
API มีเอกสารในรูปแบบ OpenAPI 3.1: api.rivervo.com/api/v1/openapi.json นำเข้าไปใน Postman, Insomnia หรือเครื่องมือสร้างโค้ดได้
ที่อยู่หลัก: https://api.rivervo.com/api/v1 ส่ง Token เป็น 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 | ดีพลอย: บิลด์คอมมิตล่าสุด หรือใช้ {"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: <รหัสลูกค้าของบัญชี>เพื่อจัดการแอปพลิเคชันของบัญชีที่คุณได้รับสิทธิ์เข้าถึง - ขีดจำกัด: 120 คำขอต่อนาทีต่อคน ในจำนวนนี้เป็นการเปลี่ยนแปลงได้ 30 ครั้ง หากเกิน API จะตอบ
429พร้อมRetry-After - ภาษา: ข้อความเป็นภาษาอังกฤษโดยค่าเริ่มต้น ส่ง
Accept-Language: azหรือruเพื่อรับภาษาอาเซอร์ไบจานหรือรัสเซีย - ตัวแปรที่เปลี่ยนผ่าน API จะไปถึงแอปพลิเคชันในการดีพลอยครั้งถัดไป เช่นเดียวกับในแผงควบคุม ใช้
{"rebuild": false}ก็เพียงพอ
คำสั่ง rivervo
ดีพลอย ดูบันทึก จัดการตัวแปร และย้อนกลับจากเทอร์มินัลของคุณ ด้วย API Token ชุดเดียวกัน ต้องใช้ Node.js 22 ขึ้นไป:
npm install -g rivervo
rivervo login # วาง Token
rivervo deploy shop # บิลด์คอมมิตล่าสุดและติดตามการดีพลอย
rivervo logs shop -f # ติดตามเอาต์พุตของแอปพลิเคชัน
rivervo env set shop API_URL=https://example.com
rivervo rollback shop # ย้อนกลับไปเวอร์ชันก่อนหน้าใน CI คำสั่งนี้อ่าน Token จากตัวแปร RIVERVO_TOKEN และ deploy จะจบด้วยข้อผิดพลาดเมื่อเวอร์ชันใหม่ไม่ขึ้นใช้งาน จึงใช้เป็นด่านตรวจใน Pipeline ได้ ระหว่างที่ยังไม่เผยแพร่ คุณทำสิ่งเดียวกันได้ด้วย REST API
“อธิบายข้อผิดพลาดนี้”
เมื่อการดีพลอยไม่สำเร็จ หรือบริการหยุดทำงาน ปุ่ม อธิบายข้อผิดพลาดนี้ จะปรากฏข้างบันทึก ระบบจะอ่านบรรทัดสุดท้ายของบันทึกและบอกคุณเป็นภาษาของคุณ:
- สาเหตุที่เป็นไปได้ — เกิดอะไรผิดพลาด
- วิธีแก้ไข — ขั้นตอนที่ชัดเจนสำหรับสแตกของคุณ
คำอธิบายเขียนโดย AI จากบันทึก โปรดตรวจสอบก่อนเปลี่ยนแปลงสิ่งใด ก่อนส่งข้อมูลใดๆ ค่าทุกค่าของตัวแปรและทุกอย่างที่ดูเหมือนคีย์ รหัสผ่าน หรือ Token จะถูกซ่อนจากบันทึก โค้ดและตัวแปรของคุณเองจะไม่ถูกส่งไปเลย
แต่ละคนขอคำอธิบายใหม่ได้สูงสุด 10 ครั้งต่อวัน คำอธิบายที่เคยสร้างแล้วสำหรับบันทึกเดียวกันจะแสดงซ้ำได้ฟรี
Rivervo MCP
คุณจัดการแอปพลิเคชันจากผู้ช่วย AI ได้ด้วยผ่าน Rivervo MCP ซึ่งใช้ได้กับ Claude, ChatGPT, Cursor, VS Code และแอปอื่นที่รองรับ MCP: ถามเรื่องการดีพลอย บันทึก และข้อผิดพลาดในบทสนทนา และให้ผู้ช่วยดีพลอยหรือย้อนกลับให้คุณ ไม่ต้องใช้ Token เพียงเข้าสู่ระบบด้วยบัญชี Rivervo ของคุณ ดู Rivervo MCP