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

# OTO API’ye genel bakış

> OTO API ile geliştirin: siparişler, hub’lar, gönderiler ve kargo şirketleri için 76 REST uç noktası; ayrıca webhook’lar, test ortamı ve Postman koleksiyonu.

Panelde yapabildiğiniz her şeyi API ile de yapabilirsiniz. OTO’yu kendi sisteminizin (bir e-ticaret sitesi, ERP, WMS ya da pazaryeri) altında çalıştırıyorsanız, ihtiyacınız olan her şey burada.

## Neler geliştirebilirsiniz?

API, ürünle aynı nesneler etrafında kurgulanmıştır; dolayısıyla zihinsel model aynen geçerlidir: bir **sipariş** gelir, bir **hub**’a atanır, bir **kargo şirketi** ile **gönderi** oluşturulur ve müşteri bilgilendirilir. Dört fiil, **20 grupta** toplam **76 uç nokta**.

| Amacınız… | Başlangıç noktası |
| - | - |
| Hazır entegrasyonu olmayan bir sistemden sipariş aktarmak | [Kimlik Doğrulama](https://docs.tryoto.com/tr/developers/authentication.md), ardından `createOrder` |
| Ödeme sayfasında canlı kargo seçeneklerini ve teslimat tarihlerini göstermek | [Checkout API](https://docs.tryoto.com/tr/modules/sales-channels/checkout-api.md) |
| Sürekli sorgulamak yerine bir şey olduğunda haberdar edilmek | [Webhook’lar](https://docs.tryoto.com/tr/developers/webhook-events.md) |
| Kendi WMS’inizi çalıştırıp stokları senkron tutmak | [Uç nokta dizinindeki](https://docs.tryoto.com/tr/developers/rest-api-reference.md) Stock Management |
| OTO’yu kendi satıcılarınıza yeniden satmak | [Uç nokta dizinindeki](https://docs.tryoto.com/tr/developers/rest-api-reference.md) Marketplace |

## Bir entegrasyonun yapısı

Entegrasyonların çoğu, aynı sırayla yapılan aynı beş çağrıdan oluşur. API’nin geri kalanı bunların etrafındaki durumlar için vardır.

| # | Çağrı | Neden |
| - | - | - |
| 1 | `POST /rest/v2/refreshToken` | Erişim belirteci alın. Her istekte değil, saatte bir. |
| 2 | `POST /rest/v2/createOrder` | Sipariş artık OTO’da vardır ve [sipariş yönlendirme](https://docs.tryoto.com/tr/modules/omnichannel-oms/order-routing.md) kurallarına tabidir. |
| 3 | `POST /rest/v2/checkOTODeliveryFee` | İsteğe bağlı. Seçimi otomasyona bırakmak yerine kendiniz yapmak istiyorsanız, seçenekleri ve fiyatları gösterir. |
| 4 | `POST /rest/v2/createShipment` | Kargo şirketi rezerve edilir ve bir kargo etiketi (AWB) oluşur. |
| 5 | `POST /rest/v2/webhook` | Sipariş başına değil, bir kez kaydedilir. Bu noktadan sonraki her şey size gönderilir. |

> [!TIP]
>
> **5. adım, çoğu kişinin atladığı adımdır**
>
> `orderStatus` uç noktasını bir zamanlayıcıyla sorgulamak caziptir; çünkü ilk gün, barındırmanız gereken kendi uç noktanız olmadan çalışır.
>
> Ancak hacim arttığında işe yaramaz hâle gelir: Hiçbir şeyin değişmediğini öğrenmek için binlerce çağrı yaparsınız ve gerçekten ihtiyaç duyduğunuz durum, bir sorgulama aralığı kadar geç ulaşır. Bir webhook yarım günlük iştir ve sorunu kalıcı olarak ortadan kaldırır.

## Nerede bulunur?

| Kaynak | Konum |
| - | - |
| **Refresh anahtarınız** | **Ayarlar → API Integrations → Connect** |
| **Tüm istek ve yanıt şemaları** | [apis.tryoto.com](https://apis.tryoto.com) — 30’dan fazla dilde örnek içeren canlı başvuru kaynağı |
| **Canlı ortam temel URL’si** | `https://api.tryoto.com` |
| **Test ortamı (sandbox) temel URL’si** | `https://staging-api.tryoto.com` |

## Bu bölümde

> **[Kimlik Doğrulama](https://docs.tryoto.com/tr/developers/authentication.md)**
>
> Belirteçler, başlıklar, test ortamı ve plan kapsamı.

> **[REST API başvuru kaynağı](https://docs.tryoto.com/tr/developers/rest-api-reference.md)**
>
> 76 uç noktanın tamamı ve her birinin gerektirdiği plan.

> **[Webhook olayları](https://docs.tryoto.com/tr/developers/webhook-events.md)**
>
> Üç olay türü, yükler (payload) ve imza doğrulama.

> **[Postman koleksiyonu](https://docs.tryoto.com/tr/developers/postman-collection.md)**
>
> Kod yazmadan her uç noktayı test ortamında çalıştırın.

> **[Hatalar ve istek sınırları](https://docs.tryoto.com/tr/developers/errors-and-rate-limits.md)**
>
> Hataların neye benzediği ve nasıl ele alınacağı.

## Bağlantılı olduğu modüller

* [Satış Kanalları](https://docs.tryoto.com/tr/modules/sales-channels/overview.md) — kendiniz geliştirmeniz gerekmediğinde kullanabileceğiniz hazır entegrasyonlar.
* [Sipariş senkronizasyonu](https://docs.tryoto.com/tr/modules/omnichannel-oms/order-sync.md) — aktardığınız bir siparişe ne olduğu.
* [Hub Yönetimi](https://docs.tryoto.com/tr/modules/hubs-management/overview.md) — burada hub olarak oluşturulan çıkış noktaları.


## Related topics

- [Entegrasyonlara genel bakış](https://docs.tryoto.com/tr/integrations/overview.md)
- [SMS, e-posta ve WhatsApp sağlayıcıları](https://docs.tryoto.com/tr/integrations/messaging-providers.md)
- [İşbirliği ve bildirimler](https://docs.tryoto.com/tr/platform/collaboration-and-notifications.md)


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