เริ่มต้นใช้งาน

เครื่องมือนักพัฒนา: API Token, REST API, CLI และ “อธิบายข้อผิดพลาดนี้”

สร้าง API Token ตามขอบเขตที่ต้องการ จัดการแอปพลิเคชันจากสคริปต์และ CI ผ่าน REST API และคำสั่ง rivervo และรับคำอธิบายจาก AI เมื่อการดีพลอยล้มเหลว

2 นาทีในการอ่าน

ทุกอย่างที่คุณทำกับแอปพลิเคชันในแผงควบคุมทำผ่านสคริปต์ได้เช่นกัน ทั้งการดีพลอยจาก 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

ยังติดปัญหาอยู่ใช่ไหม

แชทกับเรา AI ตอบทันที และวิศวกรจะเข้ามาช่วยเมื่อจำเป็น ได้ทุกเวลา

ติดต่อฝ่ายซัพพอร์ต