---
metadata:
  - name: generator
    content: Diplodoc Platform v5.19.6
alternate:
  - https://docs.routeq.com/doc/en/delivery/quickstart/register.md
  - https://docs.routeq.com/doc/tr/delivery/quickstart/register.md
---
> **Documentation Index:** Fetch the complete configuration index at https://docs.routeq.com/doc/tr/llms.txt

# OAuth Token (Belirteç) Alımı

İzleme Sistemi API'si ile çalışmak için OAuth token'ı gereklidir. OAuth token'ı için aranan koşullar:

- Token, şirketinde [yönetici](https://docs.routeq.com/doc/tr/delivery/interface/managers.md#user-roles) rolüne sahip bir kullanıcı için oluşturulmalıdır.
- Ayrıca, token iptal edilmemiş olmalıdır. Daha fazla bilgi için [Token için çalışma süresi](#lifetime) bölümünü okuyun.

İzleme Sistemi API'siyle çalışmaya başlamadan önce bir OAuth token'ı alın:


1. Gerekirse [Yandex ID](https://passport.yandex.com.tr/registration) ile bir hesap oluşturun. Kayıt sırasında Yandex Mail kurumsal adresinizi veya başka bir e-posta adresi kullanın.

2. Verilerin yüklenmesi için kullanılacak kullanıcı adıyla Yandex'e giriş yapın.

3. [Yandex ID için OAuth](https://oauth.yandex.com.tr/client/new)'ta uygulama oluşturma sayfasını açın.

4. **Genel veriler** bölümünde **Servisinizin adı** alanını doldurun. Servisin adı istediğiniz gibi olabilir. Bu ad, Yandex ID için OAuth servisindeki uygulamalar listenizde görünür.

    Servisin simgesini eklemeniz gerekmez.

5. **Uygulama platformları** bölümünde;

    1. **Web servisleri** seçeneğini kullanın.

    2. İmleci, görüntülenen **Redirect URI** alanına getirin ve `https://oauth.yandex.com.tr/verification_code` adresi ekleyin veya ayrıca görüntülenen ipucunda **Hata ayıklamak için URL ekle** seçeneğine tıklayın.

6. **Bilgi erişimi** bölümünde `courier:logistician` girin ve **Kurye ve sipariş verilerinin yüklenmesi ve sonuçların indirilmesi (rol Lojistik)** öğesini seçin.

7. Sayfanın alt kısmında **Uygulama oluştur** butonuna tıklayın.

    Uygulama sayfası açılır. **ClientID** alanındaki uygulama ID'si OAuth token'ını almanız için gereklidir.

8. OAuth token'ını alın. Bunun için:

    1. Bağlantıya tıklayın. `<Uygulamanızın-ClientID-si>` yerine 7. maddedeki değeri girin.




       ```
       https://oauth.yandex.com.tr/authorize?response_type=token&client_id=<Uygulamanızın-ClientID-si>
       ```


    2. Servisin doğru kullanıcı adıyla giriş yapmanızı önerdiğinden emin olun.

    3. **<kullanıcı adı> olarak giriş yap**'a tıklayın.

    4. Ekranda görüntülenen karakter dizisini kopyalayın; bu karakter dizisi, sizin OAuth token'ınızdır.

    5. Token'ın çalıştığından emin olun. Çalışıp çalışmadığını kontrol etmek için token'ı şu sorgu başlığına ekleyin:

    ```
    curl -H "Authorization: OAuth <OAuth-token'ınız>" -X GET https://courier.yandex.ru/api/v1/test
    ```

    Yanıt şu şekilde olmalı: `{"message":"OK"}`.

    OAuth hakkında daha fazla bilgi için [OAuth'un Yandex'te uygulanması](https://yandex.com/dev/id/doc/dg/oauth/concepts/ya-oauth-intro.html) bölümüne gidin.

## Token için Çalışma Süresi {#lifetime}

Token için çalışma süresi sınırsızdır.

Token'ınız aşağıdaki durumlarda geçersiz hale gelebilir:

- Token iptal edildi. Token'ınız iptal edilmişse, yenisini almanız gerekir. Token'ın iptal nedenleri için [Token iptali](https://yandex.com.tr/dev/id/doc/en/tokens/token-invalidate) bölümüne gidin.
- Kullanıcı, token'ın verildiği kullanıcı hesabının şifresini değiştirdi.
- Token'ın verildiği hesabın kullanıcısı **Tüm Yandex servislerinden çıkış yap** butonuna tıkladı.

## Sorun çözme {#solving-problems}

#### OAuth token'ı alınırken unauthorized_client hatası

Hesabınız için kısıtlamalar uygulanmışsa (bkz. Madde 8.1) OAuth token'ı alındığında hata oluşur. Bu durumda bu [formu](https://yandex.ru/dev/id/doc/en/feedback) kullanarak başvuru yapın. Destek ekibimiz kısıtlamaların kaldırılması konusunda karar verip sizinle iletişime geçecektir.

{% note info "Not" %}

Formu doldurmadan önce kısıtlamaların uygulandığı kullanıcı hesabıyla giriş yaptığınızdan emin olun; aksi takdirde form açılmaz.

{% endnote %}

{% include [warehouse-feedback](../_includes/feedback-e044755025a6.md) %}