Hemen başlayın

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.

3 DK OKUMA

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 okumauygulamalar, yayına almalar ve logları, çalışma logları, alan adları
Okuma ve yayına almaokuma, artı yayına alma, geri alma ve yeniden başlatma
Tam erişimyayına alma, artı değişkenler (okuma ve değiştirme) ve alan adları (ekleme, kaldırma)
Tam erişim ve terminaltam 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/apps

Neler yapabilirsiniz:

Yöntem ve yolNe yaparKapsam
GET /appsuygulamalarınız ve servisleriokuma
GET /apps/{id}bir uygulamaokuma
GET /apps/{id}/deploymentsyayına almalarıokuma
POST /apps/{id}/deploymentsyayına alma: en son commit'i derle ya da {"rebuild": false} ile çalışan sürümü yeniden yayına alyayına alma
GET /apps/{id}/deployments/{deployment}derleme loguyla bir yayına almaokuma
POST /apps/{id}/deployments/{deployment}/rollbacko sürüme geri dönyayına alma
POST /apps/{id}/restartyeniden başlatyayına alma
GET /apps/{id}/logssitenin, bir işçinin veya zamanlamanın çalışma loglarıokuma
GET, PUT, PATCH /apps/{id}/envdeğişkenleri oku, değiştir veya güncelletam
GET /apps/{id}/domainsalan adlarıokuma
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}bir alan adı ekle veya kaldırtam
  • 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-After ile 429 yanıtı verir.
  • Dil: mesajlar varsayılan olarak İngilizce gelir; Azerbaycan Türkçesi veya Rusça için Accept-Language: az ya da ru gö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 version

CI'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.

Hâlâ takıldınız mı?

Bizimle sohbet edin — AI hemen yanıt verir, gerektiğinde günün her saati bir mühendis katılır.

Destekle iletişime geçin