DiyoCP entegrasyonu için ihtiyacınız olan tüm endpointler, hata kodları ve kullanım örnekleri.
https://api.diyocp.com/v2
API Token'ınız (Bearer Token) tam yetkiye sahiptir. Bu anahtarı asla istemci tarafında (JavaScript, Android App vb.) saklamayın. Tüm istekleri sunucu tabanlı (Backend) yapınız. Token çalınırsa panelden "API Erişimini Sıfırla" butonunu kullanın.
API sunucumuz IP adresi başına dakikalık istek sınırı uygular. Yanıt başlıklarında (Headers) kalan hakkınızı görebilirsiniz.
/auth/login
API Key ve Email adresinizi kullanarak geçici bir Bearer Token alır. Bu token varsayılan olarak 60 dakika geçerlidir.
| Alan | Tip | Açıklama |
|---|---|---|
| email * | string | Yönetici e-postası. |
| api_key * | string | Panelden alınan key. |
{ "status": true, "data": { "token": "eyJhbGciOiJIUzI1NiIsIn...", "expires_in": 3600, "type": "Bearer" } }
/services/{id}/action
Belirtilen hizmete (VDS, VPS, Dedicated) güç sinyali gönderir. Bu işlem VMware, Proxmox veya Hetzner API'si üzerinden asenkron olarak gerçekleşir.
| action * | boot reboot shutdown |
{ "status": true, "message": "Restart işlemi kuyruğa alındı.", "data": { "task_id": 9281, "module": "vmware_esxi" } }
| Kod | Hata Mesajı | Açıklama |
|---|---|---|
| 200 | OK | İstek başarılı. |
| 201 | Created | Yeni kaynak oluşturuldu (Müşteri, Ticket vb.). |
| 400 | Bad Request | Eksik parametre veya hatalı veri formatı. |
| 401 | Unauthorized | Token geçersiz veya süresi dolmuş. |
| 403 | Forbidden | Bu işlemi yapmak için yetkiniz yok. |
| 404 | Not Found | İstenen kaynak (ID) bulunamadı. |
| 429 | Too Many Requests | Dakikalık istek sınırını aştınız. |
| 500 | Internal Server Error | Sunucu tarafında beklenmeyen bir hata oluştu. |
| 503 | Service Unavailable | Sistem bakımda veya aşırı yük altında. |
Hosting firmanızı manuel işlemlerden kurtarın. DiyoCP ile bugün tanışın, %80 zaman tasarrufu sağlayın.