> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitflare.com/llms.txt
> Use this file to discover all available pages before exploring further.

# v1'den v2'ye Geçiş

> Müşteri API v1'den v2'ye yükseltme için adım adım kılavuz

<Warning>
  **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.
</Warning>

## 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.

```bash theme={null}
# 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](/tr/api-documentation/customer-endpoints/auth/device-code) 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ı

<Steps>
  <Step title="Temel URL'nizi güncelleyin">
    İstemcinizdeki yol önekini `/customer/v1/` yerine `/customer/v2/` yapın:

    ```bash theme={null}
    # Ö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
    ```
  </Step>

  <Step title="Konumlar uç noktasını güncelleyin">
    Konumlar uç noktası üst düzey yoldan lisanslar grubuna taşındı:

    ```bash theme={null}
    # Önce
    GET /customer/v1/locations

    # Sonra
    GET /customer/v2/licenses/locations
    ```
  </Step>

  <Step title="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.
  </Step>

  <Step title="(İsteğe bağlı) Kimlik doğrulamayı yükseltin">
    API anahtarları yerine Bearer belirteci kullanmak istiyorsanız [cihaz yetkilendirme akışını](/tr/api-documentation/customer-endpoints/auth/device-code) veya [cüzdan imzası akışını](/tr/api-documentation/customer-endpoints/auth/wallet-challenge) uygulayın.
  </Step>
</Steps>

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

Geçiş sırasında sorun yaşarsanız [Discord](https://discord.gg/orbitflare) üzerinden ulaşın veya [support@orbitflare.com](mailto:support@orbitflare.com) adresine yazın.