Sunucu uç noktaları
Sunucuları listeleyin, canlı durumu okuyun ve kontrollü güç işlemleri çalıştırın.
Son güncelleme
Liste ve ayrıntı
| Yöntem | Yol | Kapsam |
|---|---|---|
GET | /servers | servers:read |
GET | /servers/{serverId} | servers:read |
GET | /servers/{serverId}/status | servers:read |
POST | /servers/{serverId}/actions | servers:power |
curl --fail-with-body \
-H "Authorization: Bearer $SOURCE_API_KEY" \
"https://api.sourcebilisim.com/v1/servers?limit=25"Liste yanıtındaki meta.next_cursor doluysa sonraki sayfada before olarak gönderin:
GET /servers?limit=25&before=123Yanıtlar yalnız müşteriye gerekli alanları içerir. LXC kimliği, node erişimi, SFTP parolası ve altyapı kimlikleri döndürülmez.
Canlı durum
GET /servers/{serverId}/status, sunucunun müşteri görünür çalışma durumunu döndürür. Bağımlı node hizmeti geçici olarak kullanılamıyorsa güvenli bir hata yanıtı alınır; upstream hata ayrıntıları müşteriye sızdırılmaz.
Güç işlemleri
curl --fail-with-body -X POST \
-H "Authorization: Bearer $SOURCE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"action":"restart"}' \
https://api.sourcebilisim.com/v1/servers/123/actionsGeçerli eylemler start, stop ve restart değerleridir. Bunlar LXC makinesini değil Minecraft sürecini yönetir.
- Hesap başına dakikada en fazla 6 güç işlemi
- Aynı sunucuda güç işlemleri arasında en az 10 saniye
- Askıdaki sunucuda
stopdışındaki eylemler engellenir - Kurulumu tamamlanmamış veya başka işlem altında olan sunucu yönetilemez
Başarılı bir güç işlemi denetim kaydı üretir. Aynı isteği ağ zaman aşımı nedeniyle tekrar göndermeden önce sunucu durumunu kontrol edin.