Geliştirici araçları: API token'ları, REST API, CLI ve «Bu hatayı açıkla».
Doğru kapsamla API token'ları oluşturun, REST API üzerinden betiklerden ve CI'dan uygulamalarla çalışın, rivervo komut satırını kullanın ve başarısız yayına almalar için AI açıklamaları alın.
Panelde uygulamalarla yaptığınız her şey betikle de yapılabilir — CI'dan yayına almalar, bir betikten değişkenler, terminalinizde loglar.
API token'ları
Hesap ayarları → API token'ları → Token oluştur. Bir ad verin (nerede kullanıldığı, örneğin «GitHub Actions») ve neler yapabileceğini seçin:
| Kapsam | İzin verdikleri |
|---|---|
| Yalnızca okuma | uygulamalar, yayına almalar ve logları, çalışma logları, alan adları |
| Okuma ve yayına alma | okuma, artı yayına alma, geri alma ve yeniden başlatma |
| Tam erişim | yayına alma, artı değişkenler (okuma ve değiştirme) ve alan adları (ekleme, kaldırma) |
| Tam erişim ve terminal | tam erişim, artı web sitelerinizde komutlar, dosyaları, cron görevleri, SSH anahtarları ve Git'ten yayına almalar |
Ne zaman sona ereceğini de belirleyebilirsiniz — 30, 90 veya 365 gün sonra ya da hiçbir zaman.
- Token bir kez gösterilir — hemen kopyalayın.
- Bir token sizin erişiminizle çalışır. Başka birinin hesabında uygulamadaki rolünüzle çalışır ve token'ın kapsamı bunun üzerine uygulanır. Bkz. Bir uygulamaya erişim.
- En fazla 20 token tutabilirsiniz. İptal et bir token'ı hemen durdurur.
- Token'larınızı yalnızca siz oluşturabilirsiniz: sizin adınıza hesabınıza giriş yapmış biri oluşturamaz.
REST API
API, OpenAPI 3.1 ile belgelenmiştir: api.rivervo.com/api/v1/openapi.json. Onu Postman'e, Insomnia'ya veya bir kod üreticiye aktarın.
Temel adres: https://api.rivervo.com/api/v1. Token'ı bearer token olarak gönderin:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsNeler yapabilirsiniz:
| Yöntem ve yol | Ne yapar | Kapsam |
|---|---|---|
GET /apps | uygulamalarınız ve servisleri | okuma |
GET /apps/{id} | bir uygulama | okuma |
GET /apps/{id}/deployments | yayına almaları | okuma |
POST /apps/{id}/deployments | yayına alma: en son commit'i derle ya da {"rebuild": false} ile çalışan sürümü yeniden yayına al | yayına alma |
GET /apps/{id}/deployments/{deployment} | derleme loguyla bir yayına alma | okuma |
POST /apps/{id}/deployments/{deployment}/rollback | o sürüme geri dön | yayına alma |
POST /apps/{id}/restart | yeniden başlat | yayına alma |
GET /apps/{id}/logs | sitenin, bir işçinin veya zamanlamanın çalışma logları | okuma |
GET, PUT, PATCH /apps/{id}/env | değişkenleri oku, değiştir veya güncelle | tam |
GET /apps/{id}/domains | alan adları | okuma |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | bir alan adı ekle veya kaldır | tam |
- Başka birinin hesabı: size erişim verilen bir hesabın uygulamalarıyla çalışmak için
X-Account: <the account's customer ID>başlığını ekleyin. - Sınırlar: kişi başına dakikada 120 istek, bunların 30'u değişiklik. Bunları aşınca API
Retry-Afterile429yanıtı verir. - Dil: mesajlar varsayılan olarak İngilizce gelir; Azerbaycan Türkçesi veya Rusça için
Accept-Language: azya darugönderin. - API üzerinden değiştirilen değişkenler, panelde olduğu gibi uygulamaya bir sonraki yayına almayla ulaşır —
{"rebuild": false}yeterlidir.
rivervo komut satırı
Aynı API token'larıyla terminalinizden yayına almalar, loglar, değişkenler ve geri almalar. Node.js 22 veya daha yenisini gerektirir:
npm install -g rivervo
rivervo login # paste the token
rivervo deploy shop # build the latest commit and follow the deploy
rivervo logs shop -f # follow the application's output
rivervo env set shop API_URL=https://example.com
rivervo rollback shop # back to the previous versionCI'da token'ı RIVERVO_TOKEN değişkeninden okur ve yeni sürüm yayına girmediğinde deploy hatayla çıkar; böylece bir boru hattını durdurabilir. Yayınlanana kadar aynısı REST API ile yapılabilir.
«Bu hatayı açıkla»
Bir yayına alma tamamlanmadığında ya da bir servis çalışmayı bıraktığında, logun yanında Bu hatayı açıkla görünür. Logun son satırlarını okur ve size kendi dilinizde şunları söyler:
- Olası neden — neyin yanlış gittiği;
- Nasıl düzeltilir — altyapınız için somut adımlar.
Açıklama AI tarafından logdan yazılır; bir şeyi değiştirmeden önce kontrol edin. Herhangi bir şey gönderilmeden önce değişkenlerinizin her değeri ve anahtara, şifreye veya token'a benzeyen her şey logdan gizlenir. Kodunuz ve değişkenlerinizin kendisi asla gönderilmez.
Her kişi günde en fazla 10 yeni açıklama isteyebilir; aynı log için daha önce yapılmış bir açıklama ücretsiz olarak yeniden gösterilir.
Rivervo MCP
Uygulamalarınızla AI asistanlarından da Rivervo MCP üzerinden çalışabilirsiniz — Claude, ChatGPT, Cursor, VS Code ve MCP'yi destekleyen diğer uygulamalarla çalışır: yayına almalar, loglar ve hatalar hakkında bir sohbette sorun ve asistanın sizin için yayına almasına veya geri almasına izin verin. Token gerekmez; Rivervo hesabınızla giriş yaparsınız. Bkz. Rivervo MCP.