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

# API kimlik doğrulaması

> OTO Gösterge Paneli’nden refresh anahtarınızı alın, bir saatlik erişim belirteciyle değiştirin ve her API çağrısında Bearer başlığıyla gönderin.

İki anahtar. Birini saklarsınız, diğerini her saat atıp yenisini alırsınız.

## Refresh anahtarınızı alın

Panelde **Ayarlar → API Integrations** bölümüne gidin ve **Connect**’e basın. Bu işlem `refresh_token` değerinizi oluşturur.

Bu anahtar **kalıcıdır** ve elinizdeki tek uzun ömürlü kimlik bilgisidir. Belirteç uç noktası dışında hiçbir şeyi çağırmak için kullanılamaz.

> [!WARNING]
>
> **Refresh anahtarını bir şifre gibi koruyun**
>
> Süresi dolmadığı için sızdırılan bir anahtar, biri fark edip yeniden oluşturana kadar onu ele geçiren kişi için kullanılabilir olmaya devam eder.
>
> Yeri bir gizli bilgi yöneticisi (secrets manager) ya da bir ortam değişkenidir; asla istemci tarafı kod, mobil uygulama paketi, kod deposu, destek bileti veya ekran görüntüsü değildir. Bir tarayıcıya ulaşan her şey, o tarayıcıyı kullanan kişi tarafından okunabilir.

## Erişim belirteciyle değiştirin

`POST /rest/v2/refreshToken` Free+

```json theme={null}
{ "refresh_token": "<your permanent token>" }
```

Yanıt, geçerlilik süresi **bir saat** olan bir `access_token` içerir. Bunu diğer tüm çağrılarda gönderin:

```text theme={null}
Authorization: Bearer <access_token>
```

> [!TIP]
>
> **Erişim belirtecini önbelleğe alın; her istek için yenisini istemeyin**
>
> Bir belirteç bir saat geçerlidir; dolayısıyla o saat içinde API’yi bin kez çağıran bir iş için bin değil, tek bir belirteç yeterlidir.
>
> Sağlam yöntem şudur: Belirteci ve bitiş zamanını bellekte tutun, süresinin dolmasına birkaç dakika kala yenileyin ve sizin saatinizle sunucunun saatinin uyuştuğunu varsaymak yerine 401 yanıtı aldığınızda da yenileyin. Her çağrı için yeni belirteç istemek, bir entegrasyonun yavaşlamasının en yaygın nedenidir.

## Bağlantıyı kontrol edin

`GET /rest/v2/healthCheck` Free+

Platformun erişilebilir olduğunu ve yanıt verdiğini doğrular. Kendi izleme sisteminize bağlamanıza değer; böylece bir şey bozulduğunda hangi tarafta bozulduğunu zaten bilirsiniz.

## Test ortamı (sandbox)

Kendi hesabı, kendi anahtarı ve test kargo şirketleri olan ayrı bir ortamdır: `https://staging-api.tryoto.com`. Aynı yollar, aynı veri yapıları.

> [!NOTE]
>
> **Test ortamında geliştirin, ancak geçişi de test edin**
>
> Test ortamı, gerçek koliye dönüşmeyen siparişler ve gerçek faturaya dönüşmeyen rezervasyonlar oluşturduğunuz yerdir. Üzerinde güvenle deneme yapabileceğiniz başka bir ortam yoktur.
>
> Asıl hazırlıklı olmanız gereken an, canlıya geçiştir: Canlı ortamda kargo şirketi sözleşmeleri, hub’lar ve kodlar farklıdır. Geliştirme sırasında koda gömülen bir yapılandırma değeri, canlıya geçişin ilk günündeki klasik sorundur; bu yüzden ortama özgü her değeri ilk commit’ten itibaren yapılandırmada tutun.

## Planlara göre erişim

Uç noktalar abonelik planlarına göre sınırlandırılır; bazıları ayrıca bir ek modül gerektirir. [Dizindeki](https://docs.tryoto.com/tr/developers/rest-api-reference.md) her uç noktada, onu içeren en düşük plan belirtilir.

| Plan | Neleri açar? |
| - | - |
| Free+ | Siparişler, gönderiler, yazdırma, takip, ürünler, kargo şirketi sorgulama, ulusal adres. Uçtan uca çalışan bir entegrasyon için yeterlidir. |
| Starter+ | Webhook’lar, kendi kargo şirketi sözleşmeleriniz, markalar, iade otomasyonu, OTO FLEX ve WMS ek modülüyle Stock Management. |
| Scale+ | Sipariş durumunu kendi tarafınızdan zorla güncelleme, müşteri bildirimi geçmişi ve yapay zekâ ile tahmin edilen tarihler dahil teslimat tahmini. |
| Pro+ | İşlem öncesi uygunluk kontrolleri ve sınırsız satış kanalı. |
| Enterprise+ | Kargo şirketi düzeyinde gönderi takibi, sınırsız kargo şirketi sözleşmesi ve **şube** türünde çıkış noktaları. |

> [!NOTE]
>
> **API üzerinden mağazadan gönderim, Kurumsal Plan özelliğidir**
>
> Çıkış noktaları tüm planlarda oluşturulabilir, ancak yalnızca **depo** olarak. `type: "branch"` türünde, yani aynı zamanda gönderim de yapan bir mağaza oluşturmak yalnızca Kurumsal Plan’da mümkündür.
>
> Mağazaların siparişleri programatik olarak hazırlamasını planlıyorsanız, tasarımınızı buna göre kurmadan önce kontrol etmeniz gereken sınır budur. Şubenin ne olduğunu ve neden önemli olduğunu öğrenmek için [Hub Yönetimi](https://docs.tryoto.com/tr/modules/hubs-management/overview.md) sayfasına bakın.

## İlgili sayfalar

* [Webhook’lar](https://docs.tryoto.com/tr/developers/webhook-events.md) — sormak yerine haberdar edilmek.
* [Uç nokta dizini](https://docs.tryoto.com/tr/developers/rest-api-reference.md) — API’nin tamamı.


## Related topics

- [Güvenlik ve uyumluluk](https://docs.tryoto.com/tr/platform/security-and-compliance.md)
- [Kullanıcılar, roller ve yetkiler](https://docs.tryoto.com/tr/platform/users-roles-and-permissions.md)
- [OTO API Postman koleksiyonu](https://docs.tryoto.com/tr/developers/postman-collection.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.