v1'den v2'ye Geçiş

API v1 kullanımdan kaldırılmıştır. Çalışmaya devam etmektedir ancak gelecekteki bir sürümde kaldırılacaktır. Tam uç nokta kümesine, gelişmiş kimlik doğrulamaya, profil yönetimine ve fatura işlemlerine erişmek için v2’ye geçin.

Değişenler

API v2, sürümlü bir URL yapısı, yeni uç nokta grupları ve mevcut API anahtarı yönteminin yanı sıra isteğe bağlı Bearer belirteci kimlik doğrulama akışı sunar.

Alan	v1	v2
Temel yol	`/customer/v1/`	`/customer/v2/`
Kimlik doğrulama — API anahtarı	`X-ORBIT-KEY: <key>` başlığı	Aynı — değişmedi
Kimlik doğrulama — Bearer belirteci	Desteklenmiyor	`Authorization: Bearer <token>`
Lisans uç noktaları	`/customer/v1/licenses/...`	`/customer/v2/licenses/...`
IP beyaz listesi	Düz uç noktalar	`/licenses/{id}/ips` altında iç içe
API anahtarı yönetimi	Mevcut değil	`/customer/v2/api-keys/...`
Profil	Mevcut değil	`/customer/v2/profile/...`
Faturalar	Mevcut değil	`/customer/v2/invoices/...`

Kimlik doğrulama — değişiklik gerekmez

X-ORBIT-KEY başlığıyla kimlik doğruluyorsanız, kimlik doğrulama için hiçbir değişiklik gerekmez. Aynı anahtar v2 ile çalışır.

# v1 ve v2 ile çalışır
curl -H "X-ORBIT-KEY: YOUR_API_KEY" https://api.orbitflare.com/customer/v2/licenses

İsteğe bağlı olarak, güvenliği artırmak için Bearer belirteci kimlik doğrulamasına (cihaz akışı veya cüzdan imzası) geçebilirsiniz. Ayrıntılar için Kimlik doğrulama uç noktalarına bakın.

Uç nokta eşlemesi

Lisanslar

v1 uç noktası	v2 karşılığı
`GET /customer/v1/licenses`	`GET /customer/v2/licenses`
`GET /customer/v1/licenses/{id}`	`GET /customer/v2/licenses/{id}`
`POST /customer/v1/licenses/{id}/reset-key`	`POST /customer/v2/licenses/{id}/reset-key`
`POST /customer/v1/licenses/{id}/regenerate-key`	`POST /customer/v2/licenses/{id}/regenerate-key`
`GET /customer/v1/locations`	`GET /customer/v2/licenses/locations`
`GET /customer/v1/licenses/{id}/ips`	`GET /customer/v2/licenses/{id}/ips`
`POST /customer/v1/licenses/{id}/ips`	`POST /customer/v2/licenses/{id}/ips`
`DELETE /customer/v1/licenses/{id}/ips/{ip}`	`DELETE /customer/v2/licenses/{id}/ips/{ip}`

Yalnızca v2’de yeniler

Bu uç noktalar v1’de yoktur ve yalnızca v2’de kullanılabilir:

Uç nokta	Açıklama
`POST /customer/v2/auth/device/code`	Cihaz yetkilendirme akışını başlatır
`POST /customer/v2/auth/device/token`	Cihaz kodunu erişim belirteciyle takas eder
`POST /customer/v2/auth/wallet/challenge`	Cüzdan imzası meydan okuması ister
`POST /customer/v2/auth/wallet/verify`	Cüzdan imzasını doğrular ve belirteç döner
`GET /customer/v2/api-keys`	Tüm API anahtarlarını listeler
`POST /customer/v2/api-keys`	Yeni API anahtarı oluşturur
`PATCH /customer/v2/api-keys/{id}`	Bir API anahtarını günceller
`DELETE /customer/v2/api-keys/{id}`	Bir API anahtarını siler
`GET /customer/v2/profile`	Kullanıcı profilini döndürür
`PATCH /customer/v2/profile`	Kullanıcı profilini günceller
`GET /customer/v2/profile/balance`	Hesap bakiyesini döndürür
`GET /customer/v2/invoices`	Faturaları listeler
`GET /customer/v2/invoices/{id}`	Belirli bir faturayı döndürür
`POST /customer/v2/invoices/{id}/pay`	Faturayı hesap bakiyesiyle öder

Geçiş adımları

Temel URL'nizi güncelleyin

İstemcinizdeki yol önekini /customer/v1/ yerine /customer/v2/ yapın:

# Önce
curl -H "X-ORBIT-KEY: YOUR_API_KEY" \
  https://api.orbitflare.com/customer/v1/licenses

# Sonra
curl -H "X-ORBIT-KEY: YOUR_API_KEY" \
  https://api.orbitflare.com/customer/v2/licenses

Konumlar uç noktasını güncelleyin

Konumlar uç noktası üst düzey yoldan lisanslar grubuna taşındı:

# Önce
GET /customer/v1/locations

# Sonra
GET /customer/v2/licenses/locations

Entegrasyonunuzu test edin

Mevcut entegrasyonunuzu v2 uç noktalarına karşı çalıştırın. Paylaşılan uç noktalar (lisanslar, IP’ler) için yanıt gövdeleri geriye dönük uyumludur. Taşınan uç noktalar için yanıt ayrıştırma değişikliği gerekmez.

(İsteğe bağlı) Kimlik doğrulamayı yükseltin

API anahtarları yerine Bearer belirteci kullanmak istiyorsanız cihaz yetkilendirme akışını veya cüzdan imzası akışını uygulayın.

Yardıma mı ihtiyacınız var?

Geçiş sırasında sorun yaşarsanız Discord üzerinden ulaşın veya support@orbitflare.com adresine yazın.

Genel Bakış

Müşteri API v2

Müşteri API v1 (kullanımdan kaldırıldı)

v1'den v2'ye Geçiş

Değişenler

Kimlik doğrulama — değişiklik gerekmez

Uç nokta eşlemesi

Lisanslar

Yalnızca v2’de yeniler

Geçiş adımları

Yardıma mı ihtiyacınız var?

​Değişenler

​Kimlik doğrulama — değişiklik gerekmez

​Uç nokta eşlemesi

​Lisanslar

​Yalnızca v2’de yeniler

​Geçiş adımları

​Yardıma mı ihtiyacınız var?

Değişenler

Kimlik doğrulama — değişiklik gerekmez

Uç nokta eşlemesi

Lisanslar

Yalnızca v2’de yeniler

Geçiş adımları

Yardıma mı ihtiyacınız var?