Hesap
Anahtar bilgisi ve API anahtarlarınızın yazma kaydı.
#GET/whoami
Çağıran API anahtarını gösterKapsam: anywhoamiBu işlemin OpenAPI parçası
Yanıtlar
| 200 | Key details — data: object |
| 401 | Missing, invalid or revoked key |
Örnekler
curl -s 'https://www.gyrohosting.com/api/v1/client/whoami' \
-H "Authorization: Bearer $GYRO_TOKEN"gyro whoamiimport os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/whoami", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])const res = await fetch("https://www.gyrohosting.com/api/v1/client/whoami", {
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/cloud/activity
API anahtarlarınızla yapılan yazma çağrılarını listeleKapsam: cloud_readlistActivityBu işlemin OpenAPI parçası
/cloud/... altındaki her GET dışı çağrı 365 gün saklanır (yöntem, yol, kapsam, HTTP durumu, IP, anahtar no). İstek ve yanıt gövdeleri saklanmaz.
Parametreler
| Alan | in | Tür | Açıklama |
|---|---|---|---|
page | query | integer | |
limit | query | integer |
Yanıtlar
| 200 | Activity page — data: array<ActivityEntry> |
| 401 | Missing, invalid or revoked key |
| 403 | Key lacks the scope, IP not allowed, or feature disabled |
Örnekler
curl -s 'https://www.gyrohosting.com/api/v1/client/cloud/activity' \
-H "Authorization: Bearer $GYRO_TOKEN"gyro activity listimport os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/cloud/activity", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])const res = await fetch("https://www.gyrohosting.com/api/v1/client/cloud/activity", {
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/ping
PingKapsam: System/PingcorePingBu işlemin OpenAPI parçası
Yanıtlar
| 200 | Success — data: object |
| 401 | Missing, invalid or revoked key |
| 403 | Key lacks the scope, IP not allowed, or feature disabled |
Örnekler
curl -s 'https://www.gyrohosting.com/api/v1/client/ping' \
-H "Authorization: Bearer $GYRO_TOKEN"gyro ping getimport os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/ping", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])const res = await fetch("https://www.gyrohosting.com/api/v1/client/ping", {
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/me
Profili OkumaKapsam: Account/GetMecoreGetMeBu işlemin OpenAPI parçası
Anahtarın sahibi olan müşterinin profilini döndürür. — anahtarın sahibi
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 -s 'https://www.gyrohosting.com/api/v1/client/me' \
-H "Authorization: Bearer $GYRO_TOKEN"gyro me getimport os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/me", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])const res = await fetch("https://www.gyrohosting.com/api/v1/client/me", {
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/me
Profili GüncellemeKapsam: Account/UpdateMecoreUpdateMeBu işlemin OpenAPI parçası
Gönderdiğiniz profil alanlarını değiştirir. — operatör kapısı
İstek gövdesi
| Alan | Tür | Açıklama |
|---|---|---|
name | string | Adı. Boşaltılamaz. |
surname | string | Soyadı. Boşaltılamaz. |
kind | string | Hesap türü. Bireysele geçmek şirket bilgilerini temizler. |
company | object | Şirket bilgileri. Hesabın kurumsal olmasını gerektirir. |
birthday | string | Doğum tarihi. |
identity | string | Kimlik numarası. |
landline_phone | string | Sabit telefon. |
language | string | Dil kodu. Kurulumda bulunmalıdır. |
country | string | Ülke kodu. |
currency | string | Görüntü para birimi kodu. |
timezone | string | Saat dilimi. Boş göndermek hesabın kendi seçimini siler. |
date_format | string | Tarih biçimi. Boş göndermek hesabın kendi seçimini siler. |
custom_fields | object | Ek alanların değerleri. Kutu tipli alanlar dizi alır. |
avatar | string | Profil görseli. Yalnız kodlanmış içerik kabul edilir; adres reddedilir. |
email | string | |
phone | string |
Yanıtlar
| 200 | Success — data: object |
| 401 | Missing, invalid or revoked key |
| 403 | Key lacks the scope, IP not allowed, or feature disabled |
| 422 | avatar_url_not_allowed, birthday_required, company_name_required, company_requires_corporate, custom_field_required, field_not_editable, field_too_long, kind_invalid, language_invalid, name_required, nothing_to_update |
Örnekler
curl -s -X PATCH 'https://www.gyrohosting.com/api/v1/client/me' \
-H "Authorization: Bearer $GYRO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "string", "surname": "string", "kind": "string", "company": {}, "birthday": "string", "identity": "string", "landline_phone": "string", "language": "string", "country": "string", "currency": "string", "timezone": "string", "date_format": "string", "custom_fields": {}, "avatar": "string", "email": "string", "phone": "string"}'gyro me update --help # tüm seçeneklerimport os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.patch("https://www.gyrohosting.com/api/v1/client/me", headers=h, json={"name": "string", "surname": "string", "kind": "string", "company": {}, "birthday": "string", "identity": "string", "landline_phone": "string", "language": "string", "country": "string", "currency": "string", "timezone": "string", "date_format": "string", "custom_fields": {}, "avatar": "string", "email": "string", "phone": "string"}, timeout=60)
r.raise_for_status()
print(r.json()["data"])const res = await fetch("https://www.gyrohosting.com/api/v1/client/me", {
method: "PATCH",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({"name": "string", "surname": "string", "kind": "string", "company": {}, "birthday": "string", "identity": "string", "landline_phone": "string", "language": "string", "country": "string", "currency": "string", "timezone": "string", "date_format": "string", "custom_fields": {}, "avatar": "string", "email": "string", "phone": "string"}),
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);#GET/me/security
Güvenlik Özetini OkumaKapsam: Account/GetSecuritycoreGetSecurityBu işlemin OpenAPI parçası
Doğrulama durumunu, iki adımlı girişi ve son oturumları döndürür. — değiştirilemez
Yanıtlar
| 200 | Success — data: object |
| 401 | Missing, invalid or revoked key |
| 403 | Key lacks the scope, IP not allowed, or feature disabled |
Örnekler
curl -s 'https://www.gyrohosting.com/api/v1/client/me/security' \
-H "Authorization: Bearer $GYRO_TOKEN"gyro me security getimport os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/me/security", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])const res = await fetch("https://www.gyrohosting.com/api/v1/client/me/security", {
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/me/notifications
Bildirim Tercihlerini OkumaKapsam: Account/GetNotificationscoreGetNotificationsBu işlemin OpenAPI parçası
Hesabın hangi bildirimleri hangi kanaldan aldığını döndürür.
Yanıtlar
| 200 | Success — data: object |
| 401 | Missing, invalid or revoked key |
| 403 | Key lacks the scope, IP not allowed, or feature disabled |
Örnekler
curl -s 'https://www.gyrohosting.com/api/v1/client/me/notifications' \
-H "Authorization: Bearer $GYRO_TOKEN"gyro me notification listimport os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/me/notifications", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])const res = await fetch("https://www.gyrohosting.com/api/v1/client/me/notifications", {
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}`);#PUT/me/notifications
Bildirim Tercihlerini YazmaKapsam: Account/UpdateNotificationscoreUpdateNotificationsBu işlemin OpenAPI parçası
Bildirim tercihlerinin tamamını yeniden yazar. — tam değiştirme
İstek gövdesi
| Alan | Tür | Açıklama |
|---|---|---|
invoices | object | Fatura bildirimleri. E-posta ve kısa mesaj kanallarını taşır; eksik kanal kapalı sayılır. |
support | object | Destek bildirimleri. |
product | object | Ürün ve hizmet bildirimleri. |
domain | object | Alan adı bildirimleri. |
marketing | object | Pazarlama bildirimleri. |
general | string |
Yanıtlar
| 200 | Success — data: object |
| 401 | Missing, invalid or revoked key |
| 403 | Key lacks the scope, IP not allowed, or feature disabled |
Örnekler
curl -s -X PUT 'https://www.gyrohosting.com/api/v1/client/me/notifications' \
-H "Authorization: Bearer $GYRO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"invoices": {}, "support": {}, "product": {}, "domain": {}, "marketing": {}, "general": "string"}'gyro me notification set --help # tüm seçeneklerimport os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.put("https://www.gyrohosting.com/api/v1/client/me/notifications", headers=h, json={"invoices": {}, "support": {}, "product": {}, "domain": {}, "marketing": {}, "general": "string"}, timeout=60)
r.raise_for_status()
print(r.json()["data"])const res = await fetch("https://www.gyrohosting.com/api/v1/client/me/notifications", {
method: "PUT",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({"invoices": {}, "support": {}, "product": {}, "domain": {}, "marketing": {}, "general": "string"}),
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);#GET/addresses
Adresleri ListelemeKapsam: Addresses/GetAddressescoreGetAddressesBu işlemin OpenAPI parçası
Hesabın fatura profillerini döndürür. — anahtarın sahibi
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 -s 'https://www.gyrohosting.com/api/v1/client/addresses' \
-H "Authorization: Bearer $GYRO_TOKEN"gyro address listimport os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/addresses", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])const res = await fetch("https://www.gyrohosting.com/api/v1/client/addresses", {
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/addresses
Adres EklemeKapsam: Addresses/CreateAddresscoreCreateAddressBu işlemin OpenAPI parçası
Hesaba yeni bir fatura profili ekler. — fatura profili
İstek gövdesi
| Alan | Tür | Açıklama |
|---|---|---|
name zorunlu | string | İlgili kişinin adı. |
surname zorunlu | string | Soyadı. |
email zorunlu | string | Geçerli bir e-posta. |
country zorunlu | string | Ülke kodu. Başvuru ucundan alınır. |
state zorunlu | string | İl. Listeden numara, liste boşsa serbest metin. |
city zorunlu | string | Şehir. Listeden numara, liste boşsa serbest metin. |
address zorunlu | string | Açık adres. |
zipcode zorunlu | string | Posta kodu. En çok yirmi karakter. |
kind | string | Kişi türü. Öntanımlı olarak bireysel. |
company | object | Şirket bilgileri. Kurumsal kişide ad zorunludur. |
label | string | Serbest etiket. |
phone | string | Kişinin telefonu. |
identity | string | Kimlik numarası. |
notifications | object | Kanal matrisi. Tam değiştirmedir; hiç gönderilmezse hepsi açılır. |
is_default | boolean | Bunu varsayılan profil yap. |
overwrite_invoices | boolean | Açık faturaları bu adrese yeniden yaz. |
Yanıtlar
| 200 | Success — data: object |
| 401 | Missing, invalid or revoked key |
| 403 | Key lacks the scope, IP not allowed, or feature disabled |
| 422 | company_name_required, contact_rejected, field_too_long, name_required, notifications_invalid |
| 500 | address_add_failed |
Örnekler
curl -s -X POST 'https://www.gyrohosting.com/api/v1/client/addresses' \
-H "Authorization: Bearer $GYRO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "string", "surname": "string", "email": "string", "country": "string", "state": "string", "city": "string", "address": "string", "zipcode": "string", "kind": "string", "company": {}, "label": "string", "phone": "string", "identity": "string", "notifications": {}, "is_default": true, "overwrite_invoices": true}'gyro address create --help # tüm seçeneklerimport os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.post("https://www.gyrohosting.com/api/v1/client/addresses", headers=h, json={"name": "string", "surname": "string", "email": "string", "country": "string", "state": "string", "city": "string", "address": "string", "zipcode": "string", "kind": "string", "company": {}, "label": "string", "phone": "string", "identity": "string", "notifications": {}, "is_default": True, "overwrite_invoices": True}, timeout=60)
r.raise_for_status()
print(r.json()["data"])const res = await fetch("https://www.gyrohosting.com/api/v1/client/addresses", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({"name": "string", "surname": "string", "email": "string", "country": "string", "state": "string", "city": "string", "address": "string", "zipcode": "string", "kind": "string", "company": {}, "label": "string", "phone": "string", "identity": "string", "notifications": {}, "is_default": true, "overwrite_invoices": true}),
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);#GET/addresses/{id}
Tek Adresi OkumaKapsam: Addresses/GetAddresscoreGetAddressBu işlemin OpenAPI parçası
Hesabın adreslerinden birini 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 -s 'https://www.gyrohosting.com/api/v1/client/addresses/12345' \
-H "Authorization: Bearer $GYRO_TOKEN"gyro address get 12345import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/addresses/12345", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])const res = await fetch("https://www.gyrohosting.com/api/v1/client/addresses/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}`);#PUT/addresses/{id}
Adresi GüncellemeKapsam: Addresses/UpdateAddresscoreUpdateAddressBu işlemin OpenAPI parçası
Adresin tamamını yeniden yazar. — tam gövde
Parametreler
| Alan | in | Tür | Açıklama |
|---|---|---|---|
id zorunlu | path | integer |
İstek gövdesi
| Alan | Tür | Açıklama |
|---|---|---|
name zorunlu | string | İlgili kişinin adı. |
surname zorunlu | string | Soyadı. |
email zorunlu | string | Geçerli bir e-posta. |
country zorunlu | string | Ülke kodu. Başvuru ucundan alınır. |
state zorunlu | string | İl. Listeden numara, liste boşsa serbest metin. |
city zorunlu | string | Şehir. Listeden numara, liste boşsa serbest metin. |
address zorunlu | string | Açık adres. |
zipcode zorunlu | string | Posta kodu. En çok yirmi karakter. |
kind | string | Kişi türü. Öntanımlı olarak bireysel. |
company | object | Şirket bilgileri. Kurumsal kişide ad zorunludur. |
label | string | Serbest etiket. |
phone | string | Kişinin telefonu. |
identity | string | Kimlik numarası. |
notifications | object | Kanal matrisi. Tam değiştirmedir; hiç gönderilmezse hepsi açılır. |
is_default | boolean | Bunu varsayılan profil yap. |
overwrite_invoices | boolean | Açık faturaları bu adrese yeniden yaz. |
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 | company_name_required, contact_rejected, field_too_long, name_required |
Örnekler
curl -s -X PUT 'https://www.gyrohosting.com/api/v1/client/addresses/12345' \
-H "Authorization: Bearer $GYRO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "string", "surname": "string", "email": "string", "country": "string", "state": "string", "city": "string", "address": "string", "zipcode": "string", "kind": "string", "company": {}, "label": "string", "phone": "string", "identity": "string", "notifications": {}, "is_default": true, "overwrite_invoices": true}'gyro address set 12345 --help # tüm seçeneklerimport os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.put("https://www.gyrohosting.com/api/v1/client/addresses/12345", headers=h, json={"name": "string", "surname": "string", "email": "string", "country": "string", "state": "string", "city": "string", "address": "string", "zipcode": "string", "kind": "string", "company": {}, "label": "string", "phone": "string", "identity": "string", "notifications": {}, "is_default": True, "overwrite_invoices": True}, timeout=60)
r.raise_for_status()
print(r.json()["data"])const res = await fetch("https://www.gyrohosting.com/api/v1/client/addresses/12345", {
method: "PUT",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({"name": "string", "surname": "string", "email": "string", "country": "string", "state": "string", "city": "string", "address": "string", "zipcode": "string", "kind": "string", "company": {}, "label": "string", "phone": "string", "identity": "string", "notifications": {}, "is_default": true, "overwrite_invoices": true}),
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);#DELETE/addresses/{id}
Adresi SilmeKapsam: Addresses/DeleteAddresscoreDeleteAddressBu işlemin OpenAPI parçası
Adresi siler ve gerekiyorsa varsayılanı devreder. — 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 -s -X DELETE 'https://www.gyrohosting.com/api/v1/client/addresses/12345' \
-H "Authorization: Bearer $GYRO_TOKEN"gyro address delete 12345import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.delete("https://www.gyrohosting.com/api/v1/client/addresses/12345", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])const res = await fetch("https://www.gyrohosting.com/api/v1/client/addresses/12345", {
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}`);#POST/addresses/{id}/default
Varsayılanı TaşımaKapsam: Addresses/SetDefaultAddresscoreSetDefaultAddressBu işlemin OpenAPI parçası
Bu adresi varsayılan fatura profili yapar. — hesabın ülkesi izler
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 -s -X POST 'https://www.gyrohosting.com/api/v1/client/addresses/12345/default' \
-H "Authorization: Bearer $GYRO_TOKEN"gyro address default 12345import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.post("https://www.gyrohosting.com/api/v1/client/addresses/12345/default", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])const res = await fetch("https://www.gyrohosting.com/api/v1/client/addresses/12345/default", {
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}`);