Docs API başvurusu Tüm hizmetler ve siparişler Hizmetler (çekirdek) Hizmetler (çekirdek) Çekirdek hizmet uçları: yenileme, iptal, otomatik yenileme, ek hizmetler, ölçümler, SSO, parola.
# GET /services Hizmetleri Listeleme Kapsam: Services/GetServices coreGetServices Bu işlemin OpenAPI parçası
Hesabın sahip olduğu hizmetleri döndürür. — anahtarın sahibi
Parametreler Alan in Tür Açıklama pagequery integer Kaçıncı sayfa. limitquery integer Sayfa başına satır. En çok 100. statusquery string Durum süzgeci. Rozet gruplarını alır: bekleyen hem kurulumdakini hem işlemdekini kapsar, iptal ise tamamlananı da içerir. typequery string Ürün türü süzgeci. searchquery string Hizmet adında ve bağlı alan adında arar.
Yanıtlar 200 Success — data: array<object> 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled
Örnekler curl CLI Python JavaScript
Kopyala curl -s 'https://www.gyrohosting.com/api/v1/client/services' \
-H "Authorization: Bearer $GYRO_TOKEN"Kopyala gyro core service listKopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/services", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
},
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);# GET /services/{id} Hizmeti Okuma Kapsam: Services/GetService coreGetService Bu işlemin OpenAPI parçası
Hizmetin ayarlarını, erişim bilgilerini ve yenileme durumunu döndürür. — anahtarın sahibi
Parametreler Alan in Tür Açıklama id zorunlu path integer
Yanıtlar 200 Success — data: object 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled 404 not_found
Örnekler curl CLI Python JavaScript
Kopyala curl -s 'https://www.gyrohosting.com/api/v1/client/services/12345' \
-H "Authorization: Bearer $GYRO_TOKEN"Kopyala gyro core service get 12345Kopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/services/12345", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services/12345", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
},
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);# PATCH /services/{id} Hizmet Tercihlerini Değiştirme Kapsam: Services/UpdateService coreUpdateService Bu işlemin OpenAPI parçası
Otomatik yenilemeyi ve fatura profilini değiştirir. — iki alan
Parametreler Alan in Tür Açıklama id zorunlu path integer
İstek gövdesi Alan Tür Açıklama auto_renewboolean Hizmet bazlı otomatik yenileme. Hesap geneli otomatik ödeme açıkken değiştirilemez. billing_profile_idinteger Fatura profilinin numarası. Sıfır hesabın varsayılanına döner.
Yanıtlar 200 Success — data: object 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled 404 not_found 422 autorenew_locked, no_auto_pay_source, not_actionable, nothing_to_update
Örnekler curl CLI Python JavaScript
Kopyala curl -s -X PATCH 'https://www.gyrohosting.com/api/v1/client/services/12345' \
-H "Authorization: Bearer $GYRO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"auto_renew": true, "billing_profile_id": 1}'Kopyala gyro service update 12345 --help # tüm seçeneklerKopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.patch("https://www.gyrohosting.com/api/v1/client/services/12345", headers=h, json={"auto_renew": True, "billing_profile_id": 1}, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services/12345", {
method: "PATCH",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({"auto_renew": true, "billing_profile_id": 1}),
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);# POST /services/{id}/renew Yenileme Faturası Kesme Kapsam: Services/RenewService coreRenewService Bu işlemin OpenAPI parçası
Para harcar / fatura oluşturur. Para kuralları (AK-40): gövdede "confirm": true, Idempotency-Key başlığı, yalnız bakiye (kayıtlı kart yok), hesap başına günlük ücretli işlem sınırı (varsayılan 50, hesap/bayi bazında değiştirilebilir, 00:00 TR'de sıfırlanır). Hizmet için bir yenileme faturası keser. — fatura üretir
Parametreler Alan in Tür Açıklama id zorunlu path integer Idempotency-Key zorunlu header string
İstek gövdesi Alan Tür Açıklama cyclestring Yenileme döngüsü. Hizmet detayındaki döngü listesinden seçilir; verilmezse mevcut döngü kullanılır.
Yanıtlar 200 Success — data: object 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled 404 not_found 422 already_invoiced, cycle_invalid, not_renewable, renew_blocked_subscription, renew_disabled
Örnekler curl CLI Python JavaScript
Kopyala curl -s -X POST 'https://www.gyrohosting.com/api/v1/client/services/12345/renew' \
-H "Authorization: Bearer $GYRO_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"cycle": "string"}'Kopyala gyro service renew 12345 --help # tüm seçeneklerKopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
h["Idempotency-Key"] = str(uuid.uuid4())
r = requests.post("https://www.gyrohosting.com/api/v1/client/services/12345/renew", headers=h, json={"cycle": "string"}, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services/12345/renew", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({"cycle": "string"}),
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);# GET /services/{id}/invoices Hizmetin Faturalarını Okuma Kapsam: Services/GetServiceInvoices coreGetServiceInvoices Bu işlemin OpenAPI parçası
Bu hizmeti faturalayan belgeleri döndürür. — anahtarın sahibi
Parametreler Alan in Tür Açıklama id zorunlu path integer limitquery integer En çok satır. En çok 100. pagequery integer
Yanıtlar 200 Success — data: array<object> 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled 404 not_found
Örnekler curl CLI Python JavaScript
Kopyala curl -s 'https://www.gyrohosting.com/api/v1/client/services/12345/invoices' \
-H "Authorization: Bearer $GYRO_TOKEN"Kopyala gyro service invoice list 12345Kopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/services/12345/invoices", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services/12345/invoices", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
},
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);# GET /services/{id}/addons Hizmet Eklentilerini Okuma Kapsam: Services/GetServiceAddons coreGetServiceAddons Bu işlemin OpenAPI parçası
Hizmete bağlı ek hizmetleri döndürür. — anahtarın sahibi
Parametreler Alan in Tür Açıklama id zorunlu path integer
Yanıtlar 200 Success — data: array<object> 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled 404 not_found
Örnekler curl CLI Python JavaScript
Kopyala curl -s 'https://www.gyrohosting.com/api/v1/client/services/12345/addons' \
-H "Authorization: Bearer $GYRO_TOKEN"Kopyala gyro core service addon list 12345Kopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/services/12345/addons", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services/12345/addons", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
},
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);# POST /services/{id}/cancellation İptal Talebi Açma Kapsam: Services/CreateCancellation coreCreateCancellation Bu işlemin OpenAPI parçası
Hizmetin iptali için bir talep açar. — aynı anda tek talep
Parametreler Alan in Tür Açıklama id zorunlu path integer
İstek gövdesi Alan Tür Açıklama urgency zorunlu string Ne zaman iptal edilsin: hemen ya da dönem sonunda. reason zorunlu string Gerekçe. Beş değerden biri: gerek kalmadı, pahalı, başka yere geçiliyor, özellik eksik ya da diğer. reason_detailstring Serbest açıklama. Gerekçe diğer ise zorunludur. notestring Operatöre not.
Yanıtlar 200 Success — data: object 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled 404 not_found 422 cancellation_exists, not_actionable, one_time_service, reason_detail_required
Örnekler curl CLI Python JavaScript
Kopyala curl -s -X POST 'https://www.gyrohosting.com/api/v1/client/services/12345/cancellation' \
-H "Authorization: Bearer $GYRO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"urgency": "string", "reason": "string", "reason_detail": "string", "note": "string"}'Kopyala gyro service cancellation create 12345 --help # tüm seçeneklerKopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.post("https://www.gyrohosting.com/api/v1/client/services/12345/cancellation", headers=h, json={"urgency": "string", "reason": "string", "reason_detail": "string", "note": "string"}, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services/12345/cancellation", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({"urgency": "string", "reason": "string", "reason_detail": "string", "note": "string"}),
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);# DELETE /services/{id}/cancellation İptal Talebini Geri Çekme Kapsam: Services/RevokeCancellation coreRevokeCancellation Bu işlemin OpenAPI parçası
Açık bir iptal talebini geri çeker. — anahtarın sahibi
Parametreler Alan in Tür Açıklama id zorunlu path integer
Yanıtlar 200 Success — data: object 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled 404 not_found
Örnekler curl CLI Python JavaScript
Kopyala curl -s -X DELETE 'https://www.gyrohosting.com/api/v1/client/services/12345/cancellation' \
-H "Authorization: Bearer $GYRO_TOKEN"Kopyala gyro service cancellation delete 12345Kopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.delete("https://www.gyrohosting.com/api/v1/client/services/12345/cancellation", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services/12345/cancellation", {
method: "DELETE",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
},
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);# GET /services/{id}/metrics Ölçümleri Okuma Kapsam: Services/GetServiceMetrics coreGetServiceMetrics Bu işlemin OpenAPI parçası
Kullanıma göre ücretlenen ölçümleri ve tahmini bedeli döndürür. — kullanıma göre ücret
Parametreler Alan in Tür Açıklama id zorunlu path integer
Yanıtlar 200 Success — data: object 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled 404 not_found
Örnekler curl CLI Python JavaScript
Kopyala curl -s 'https://www.gyrohosting.com/api/v1/client/services/12345/metrics' \
-H "Authorization: Bearer $GYRO_TOKEN"Kopyala gyro service metrics list 12345Kopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/services/12345/metrics", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services/12345/metrics", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
},
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);# GET /services/{id}/metrics/billing Kullanım Fatura Geçmişi Kapsam: Services/GetServiceMetricBilling coreGetServiceMetricBilling Bu işlemin OpenAPI parçası
Ölçümlerin dönem dönem faturalanmış kullanımını döndürür. — anahtarın sahibi
Parametreler Alan in Tür Açıklama id zorunlu path integer pagequery integer Kaçıncı sayfa. limitquery integer Sayfa başına satır. En çok 100. metricquery string Tek bir ölçüme daraltır.
Yanıtlar 200 Success — data: array<object> 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled 404 not_found
Örnekler curl CLI Python JavaScript
Kopyala curl -s 'https://www.gyrohosting.com/api/v1/client/services/12345/metrics/billing' \
-H "Authorization: Bearer $GYRO_TOKEN"Kopyala gyro service metrics billing list 12345Kopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/services/12345/metrics/billing", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services/12345/metrics/billing", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
},
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);# PATCH /services/{id}/metrics/{key} Ölçümü Açma ve Kapatma Kapsam: Services/UpdateServiceMetric coreUpdateServiceMetric Bu işlemin OpenAPI parçası
Bir ölçümü açar ya da kapatır. — ödenmemiş fatura kilitler
Parametreler Alan in Tür Açıklama id zorunlu path integer key zorunlu path string
İstek gövdesi Alan Tür Açıklama enabled zorunlu boolean İstenen durum.
Yanıtlar 200 Success — data: object 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled 404 not_found 422 enabled_invalid, metric_module_rejected, metric_not_priced, metric_unpaid_lock, not_actionable
Örnekler curl CLI Python JavaScript
Kopyala curl -s -X PATCH 'https://www.gyrohosting.com/api/v1/client/services/12345/metrics/1' \
-H "Authorization: Bearer $GYRO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"enabled": true}'Kopyala gyro service metrics update 12345 --help # tüm seçeneklerKopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.patch("https://www.gyrohosting.com/api/v1/client/services/12345/metrics/1", headers=h, json={"enabled": True}, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services/12345/metrics/1", {
method: "PATCH",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({"enabled": true}),
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);# GET /services/{id}/dashboard Panel Özetini Okuma Kapsam: Services/GetServiceDashboard coreGetServiceDashboard Bu işlemin OpenAPI parçası
Hizmetin arkasındaki panelin özetini ve yeteneklerini döndürür. — modüle canlı sorar
Parametreler Alan in Tür Açıklama id zorunlu path integer
Yanıtlar 200 Success — data: object 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled 404 not_found 422 module_unavailable, not_actionable
Örnekler curl CLI Python JavaScript
Kopyala curl -s 'https://www.gyrohosting.com/api/v1/client/services/12345/dashboard' \
-H "Authorization: Bearer $GYRO_TOKEN"Kopyala gyro service dashboard get 12345Kopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/services/12345/dashboard", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services/12345/dashboard", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
},
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);# POST /services/{id}/module-method Modül Metodu Çalıştırma Kapsam: Services/UseServiceModuleMethod coreUseServiceModuleMethod Bu işlemin OpenAPI parçası
Modülün müşteriye açtığı bir metodu çalıştırır. — beyanlı metotlar
Parametreler Alan in Tür Açıklama id zorunlu path integer
İstek gövdesi Alan Tür Açıklama method zorunlu string Çalıştırılacak metot. Panel özetindeki metot listesinden alınır.
Yanıtlar 200 Success — data: object 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled 404 not_found 422 invalid_method, method_required, module_unavailable, tool_rejected 500 module_method_failed
Örnekler curl CLI Python JavaScript
Kopyala curl -s -X POST 'https://www.gyrohosting.com/api/v1/client/services/12345/module-method' \
-H "Authorization: Bearer $GYRO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"method": "string"}'Kopyala gyro service module-method 12345 --help # tüm seçeneklerKopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.post("https://www.gyrohosting.com/api/v1/client/services/12345/module-method", headers=h, json={"method": "string"}, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services/12345/module-method", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({"method": "string"}),
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);# POST /services/{id}/sso Panele Tek Oturum Açma Kapsam: Services/GetServiceSso coreGetServiceSso Bu işlemin OpenAPI parçası
Panele parolasız giriş için tek kullanımlık bir adres üretir. — kısa ömürlü adres
Parametreler Alan in Tür Açıklama id zorunlu path integer
Yanıtlar 200 Success — data: object 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled 404 not_found 422 sso_not_supported, tool_rejected 500 sso_failed
Örnekler curl CLI Python JavaScript
Kopyala curl -s -X POST 'https://www.gyrohosting.com/api/v1/client/services/12345/sso' \
-H "Authorization: Bearer $GYRO_TOKEN"Kopyala gyro service sso 12345Kopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.post("https://www.gyrohosting.com/api/v1/client/services/12345/sso", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services/12345/sso", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
},
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);# POST /services/{id}/password Panel Parolasını Değiştirme Kapsam: Services/ChangeServicePassword coreChangeServicePassword Bu işlemin OpenAPI parçası
Hizmetin panel parolasını değiştirir. — barındırma ve sunucu
Parametreler Alan in Tür Açıklama id zorunlu path integer
İstek gövdesi Alan Tür Açıklama password zorunlu string Yeni panel parolası. Operatörün asgari uzunluğunu karşılamalıdır.
Yanıtlar 200 Success — data: object 401 Missing, invalid or revoked key 403 Key lacks the scope, IP not allowed, or feature disabled 404 not_found 422 password_change_failed, password_not_supported, password_too_short
Örnekler curl CLI Python JavaScript
Kopyala curl -s -X POST 'https://www.gyrohosting.com/api/v1/client/services/12345/password' \
-H "Authorization: Bearer $GYRO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"password": "string"}'Kopyala gyro service password 12345 --help # tüm seçeneklerKopyala import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.post("https://www.gyrohosting.com/api/v1/client/services/12345/password", headers=h, json={"password": "string"}, timeout=60)
r.raise_for_status()
print(r.json()["data"])Kopyala const res = await fetch("https://www.gyrohosting.com/api/v1/client/services/12345/password", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({"password": "string"}),
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);