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

# REST API başvuru kaynağı

> OTO REST API’nin 20 grupta toplanan 76 uç noktası, her birinin ne işe yaradığı ve onu içeren en düşük plan. Tüm şemalar apis.tryoto.com adresindedir.

Platformdaki tüm uç noktalar, ne işe yaradıkları ve onları içeren en düşük plan. İstek ve yanıt şemaları, doğrudan koleksiyonun kendisinden üretilen ve her zaman güncel olan [apis.tryoto.com](https://apis.tryoto.com) adresindedir.

> [!NOTE]
>
> **Plan sütunu nasıl okunur?**
>
> Etiket, uç noktayı içeren **en düşük** planı gösterir; yani Starter+, Eko Plan, Profesyonel Plan, Pro ve Kurumsal Plan anlamına gelir. Yanındaki notlar ek koşullardır: bir ek modül, bir kota ya da uç noktanın neyi kabul edeceğine ilişkin bir kısıtlama.
>
> Tümü için temel URL: `https://api.tryoto.com`. Her çağrı `Authorization: Bearer <access_token>` gerektirir; ayrıntılar için [Kimlik Doğrulama](https://docs.tryoto.com/tr/developers/authentication.md) sayfasına bakın.

**20 grupta** toplam **76 uç nokta**.

### Yetkilendirme

| Uç nokta | Yol | Plan |
| - | - | - |
| **Refresh Token** Kalıcı refresh anahtarınızı bir saatlik erişim belirteciyle değiştirir. | `POST` `/rest/v2/refreshToken` | Free+ |
| **Health Check** Platform çalışıyor mu? Pratikte kimlik doğrulama gerektirmez; bağlantı testi olarak kullanışlıdır. | `GET` `/rest/v2/healthCheck` | Free+ |

### Hesap

| Uç nokta | Yol | Plan |
| - | - | - |
| **Account Info** Hesabınızın profili ve güncel bakiyesi. | `GET` `/rest/v2/accountInfo` | Free+ |
| **Buy Credit** Kargo cüzdanına kredi yükler. | `POST` `/rest/v2/buyCredit` | Free+ |
| **Request Mobile Verification** Bir telefon numarasına doğrulama kodu gönderir. | `POST` `/rest/v2/requestMobileVerification` | Free+ |
| **Verify Mobile Number** Kodu doğrular. Mart 2026’da marketplace alt hesapları için eklendi. | `POST` `/rest/v2/verifyMobileNumber` | Free+ |

### İşlemler

| Uç nokta | Yol | Plan |
| - | - | - |
| **Get Shipping Price Transactions List** Her gönderi için alınan ücret ve bu ücreti oluşturan fiyat satırı. | `POST` `/rest/v2/getShippingPriceTransactionsList` | Starter+ |
| **Credit Transactions** Cüzdan hareketleri. | `GET` `/rest/v2/creditTransactions` | Free+ |
| **Shipment Transactions** Gönderi düzeyindeki ücretler; tarihe ve siparişe göre filtrelenebilir. | `GET` `/rest/v2/shipmentTransactions` | Free+ |
| **COD Transactions** Kapıda Ödeme Cüzdanı bakiyesi, yaklaşan transferler, para çekme işlemleri ve geçmiş. Eylül 2026’da eklendi. | `GET` `/rest/v2/codTransactions` | Free+ |

### Pazaryeri (Marketplace)

| Uç nokta | Yol | Plan |
| - | - | - |
| **Register** Bir marketplace ana hesabının altında satıcı alt hesabı oluşturur. | `POST` `/rest/v2/marketplace/register` | Free+ *marketplace anahtarı gerekir* |
| **Client Info** Bir alt hesabın bilgilerini günceller. | `POST` `/rest/v2/marketplace/clientInfo` | Free+ *marketplace anahtarı gerekir* |
| **Client Info** Bir alt hesabın bilgilerini okur. | `GET` `/rest/v2/marketplace/clientInfo` | Free+ *marketplace anahtarı gerekir* |

### Siparişler

| Uç nokta | Yol | Plan |
| - | - | - |
| **Create Order** Giriş noktası. Müşteri, adres, ürünler, ödeme yöntemi. | `POST` `/rest/v2/createOrder` | Free+ |
| **Update Order** Henüz gönderisi oluşturulmamış bir siparişi değiştirir. | `POST` `/rest/v2/updateOrder` | Free+ |
| **Update Order Status** Kendi sisteminizden bir durumu (delivered, returned, pickedUp) zorla uygular. | `POST` `/rest/v2/updateOrderStatus` | Scale+ |
| **Cancel Order** Gönderimden önce iptal eder. | `POST` `/rest/v2/cancelOrder` | Free+ |
| **Get Orders** Sayfalı ve filtrelenebilir liste. | `GET` `/rest/v2/orders` | Free+ |
| **Hold Order** Bir siparişi iptal etmeden bekletir. | `POST` `/rest/v2/holdOrder` | Free+ |
| **Unhold Order** Siparişi tekrar kuyruğa alır. | `POST` `/rest/v2/unHoldOrder` | Free+ |
| **Get Order Details** Bir siparişe ait tüm bilgiler. | `GET` `/rest/v2/orderDetails` | Free+ |
| **Check Order Availability** Siparişi taahhüt etmeden önce, karşılanıp karşılanamayacağını ve nereden karşılanacağını kontrol eder. | `POST` `/rest/v2/checkOrderAvailability` | Pro+ |

### Kargo Fiyatları

| Uç nokta | Yol | Plan |
| - | - | - |
| **Check OTO Delivery Fee** Olası bir koli için fiyatlar, tahmini teslimat süreleri ve son kabul saatleri. Ödeme sayfası için kullanılan uç nokta budur. | `POST` `/rest/v2/checkOTODeliveryFee` | Free+ |
| **Check Delivery Fee** Kendi pazarlık ettiğiniz kargo şirketi sözleşmelerine göre fiyatlar. | `POST` `/rest/v2/checkDeliveryFee` | Starter+ |
| **Get Delivery Fee** Hâlihazırda var olan bir siparişin ücreti. | `POST` `/rest/v2/getDeliveryFee` | Free+ |
| **Get Delivery Options** Hesabınızda tanımlı teslimat seçenekleri. | `GET` `/rest/v2/getDeliveryOptions` | Starter+ |

### Gönderiler

| Uç nokta | Yol | Plan |
| - | - | - |
| **Create Shipment** Koliyi bir kargo şirketiyle rezerve eder. deliveryOptionId alır ya da seçimi sizin yerinize yapar. | `POST` `/rest/v2/createShipment` | Free+ |
| **Cancel Shipment** Kargo şirketi nezdinde iptal eder. | `POST` `/rest/v2/cancelShipment` | Free+ |

### İade Gönderileri

| Uç nokta | Yol | Plan |
| - | - | - |
| **Create Return Shipment** Dönüş ayağını rezerve eder. | `POST` `/rest/v2/createReturnShipment` | Free+ |
| **Get Return Link** Tek bir sipariş için müşteriye yönelik iade portalı bağlantısı. | `POST` `/rest/v2/getReturnLink` | Starter+ |
| **Get Return Details** Bir iadenin durumu. | `POST` `/rest/v2/getReturnDetails` | Free+ |
| **Trigger Return SMS** İade bağlantısını müşteriye SMS ile gönderir. | `POST` `/rest/v2/triggerReturnSms` | Starter+ |

### Yazdırma

| Uç nokta | Yol | Plan |
| - | - | - |
| **Print AWB** Bir siparişin kargo etiketi (AWB). | `GET` `/rest/v2/print/orderId` | Free+ |
| **Print Label** Siparişin belgeleri: kargo etiketi (AWB), proforma, sipariş detayları veya iade belgesi. | `POST` `/rest/v2/printLabel` | Free+ *plan matrisinde yer almıyor* |

### Takip

| Uç nokta | Yol | Plan |
| - | - | - |
| **Order Tracking** Bir siparişin güncel durumu. | `POST` `/rest/v2/orderStatus` | Free+ |
| **Order History** Kargo şirketleri arasında standartlaştırılmış, eksiksiz olay geçmişi. | `POST` `/rest/v2/orderHistory` | Free+ |
| **Track Shipment** Kargo şirketi düzeyinde gönderi takibi. | `POST` `/rest/v2/trackShipment` | Enterprise+ |

### Müşteri Bildirimleri

| Uç nokta | Yol | Plan |
| - | - | - |
| **Customer Notifications** Bir sipariş için müşteriye hangi mesajların gönderildiği ve bu mesajlara ne olduğu. | `GET` `/rest/v2/orders/{orderId}/customer-notifications` | Scale+ |

### Kargo Şirketi Entegrasyonları

| Uç nokta | Yol | Plan |
| - | - | - |
| **Get Delivery Estimation** Bir hat için beklenen teslimat aralığı. | `POST` `/rest/v2/getDeliveryEstimation` | Scale+ |
| **AI Estimated Delivery Dates** Kargo şirketinin beyan ettiği hizmet seviyesi yerine, modelin tahmin ettiği teslimat tarihleri. | `POST` `/rest/v2/aiEstimatedDeliveryDates` | Scale+ |
| **Check Coverage** Bu adrese teslimat yapan biri var mı? | `POST` `/rest/v2/checkCoverage` | Starter+ |
| **Available Cities** Aktif kargo şirketlerinizin hizmet verdiği şehirler. | `POST` `/rest/v2/availableCities` | Free+ |
| **Available Time Slots** Rezerve edilebilir teslimat zaman aralıkları. | `POST` `/rest/v2/availableTimeslots` | Starter+ |
| **DC List** Kargo şirketi kataloğu. | `POST` `/rest/v2/dcList` | Free+ |
| **DC Config** Belirli bir kargo şirketinin gerektirdiği kimlik bilgisi şablonu. | `POST` `/rest/v2/dcConfig` | Starter+ |
| **DC Activation** Bir kargo şirketi sözleşmesini etkinleştirir. | `POST` `/rest/v2/dcActivation` | Starter+ *plana göre 3 / 7 / 20 / sınırsız sözleşme* |
| **Get Cities** Şehir referans verileri. | `POST` `/rest/v2/getCities` | Free+ |
| **Check DC Branch List** Kargo şirketlerinin teslim şubeleri ve akıllı teslimat dolapları. | `POST` `/rest/v2/checkDCBranchList` | Free+ |

### Çıkış Noktaları

| Uç nokta | Yol | Plan |
| - | - | - |
| **Create Pickup Location** Bir hub oluşturur. Ulusal adres alanlarını, servingRadius ve preparationSla değerlerini içerir. | `POST` `/rest/v2/createPickupLocation` | Free+ *şube türü yalnızca Kurumsal Plan’da* |
| **Update Pickup Location** Bir çıkış noktasını değiştirir. | `POST` `/rest/v2/updatePickupLocation` | Free+ *şube türü yalnızca Kurumsal Plan’da* |
| **Get Pickup Location List** Çıkış noktalarını listeler. | `GET` `/rest/v2/getPickupLocationList` | Free+ *şube türü yalnızca Kurumsal Plan’da* |

### Markalar

| Uç nokta | Yol | Plan |
| - | - | - |
| **Get List of Brands** Hesaptaki markalar. | `GET` `/rest/v2/getBrandList` | Starter+ |
| **Create Brand** Marka ekler. | `POST` `/rest/v2/createBrand` | Starter+ |

### Satış Kanalları

| Uç nokta | Yol | Plan |
| - | - | - |
| **Sales Channels List** Her kanalın entegrasyon koduyla birlikte katalog. | `GET` `/rest/v2/salesChannel/getSalesChannelsList` | Free+ |
| **Sales Channel Config** Tek bir kanalın kimlik bilgisi şablonu. | `POST` `/rest/v2/salesChannel/getSalesChannelConfig` | Free+ |
| **Sales Channel Activation** Kanalı bağlar. | `POST` `/rest/v2/salesChannel/salesChannelActivation` | Free+ *plana göre 1 / 3 / 5 / sınırsız kanal* |

### Ürünler

| Uç nokta | Yol | Plan |
| - | - | - |
| **Create Product** SKU ekler. | `POST` `/rest/v2/createProduct` | Free+ |
| **Product List** SKU’ları listeler. | `POST` `/rest/v2/productList` | Free+ |
| **Add Box** Bir ambalaj kutusu tanımlar. | `POST` `/rest/v2/addBox` | Free+ |
| **Update Box** Bir kutuyu değiştirir. | `POST` `/rest/v2/updateBox` | Free+ |
| **Get Box** Bir kutuyu okur. | `GET` `/rest/v2/getBox` | Free+ |

### Stok Yönetimi (Stock Management)

| Uç nokta | Yol | Plan |
| - | - | - |
| **Update Stock Quantity** Bir SKU’nun bir lokasyondaki stoğunu ayarlar. | `POST` `/rest/v2/updateStockQuantity` | Starter+ *WMS ek modülü gerekir* |
| **Check Inventory Stock** Tek bir lokasyondaki stok. | `GET` `/rest/v2/checkInventoryStock` | Starter+ *WMS ek modülü gerekir* |
| **Check Global Stock** Tüm lokasyonlardaki stok. | `GET` `/rest/v2/checkGlobalStock` | Starter+ *WMS ek modülü gerekir* |
| **Create Inventory Order** Bir giriş ya da transfer siparişi. | `POST` `/rest/v2/createInventoryOrder` | Starter+ *WMS ek modülü gerekir* |
| **Update Packing Status** Paketleme ilerlemesini kendi WMS’inizden bildirir. | `POST` `/rest/v2/updatePackingStatus` | Starter+ *WMS ek modülü gerekir* |
| **Get Orders Ready For Packing** Tek bir depo kodu için toplama ve paketleme kuyruğu. | `POST` `/rest/v2/getPackingOrders` | Starter+ *WMS ek modülü gerekir* |
| **Check Available Stores For Pickup** Ürünleri bulunduran ve teslim edebilecek şubeler. | `POST` `/rest/v2/availableStoresForPickup` | Starter+ *WMS ek modülü gerekir* |
| **Available Cities For Pickup** Mağazadan teslimin mümkün olduğu şehirler. | `POST` `/rest/v2/availableCitiesForPickup` | Starter+ *WMS ek modülü gerekir · plan matrisinde yer almıyor* |

### Ulusal Adres

| Uç nokta | Yol | Plan |
| - | - | - |
| **Get National Address From Short Code** Suudi Arabistan kısa adres kodunu tam adrese dönüştürür. | `POST` `/rest/v2/getNationalAddressFromShortCode` | Free+ |

### Webhook

| Uç nokta | Yol | Plan |
| - | - | - |
| **Register a webhook** Bir URL’yi bir olay türüne abone eder. | `POST` `/rest/v2/webhook` | Starter+ |
| **List webhooks** Kayıtlı abonelikleriniz. | `GET` `/rest/v2/webhook` | Starter+ |
| **Update a webhook** Bir aboneliği id ile yerinde değiştirir. | `PUT` `/rest/v2/webhook` | Starter+ |
| **Delete a webhook** Bir aboneliği kaldırır. | `DELETE` `/rest/v2/webhook` | Starter+ |

### OTO FLEX

| Uç nokta | Yol | Plan |
| - | - | - |
| **Assign Driver** Bir siparişi kendi sürücülerinizden birine atar. | `POST` `/rest/v2/assignDriver` | Starter+ |
| **Track Driver** O sürücünün nerede olduğu. | `POST` `/rest/v2/trackDriver` | Starter+ |

## İlgili sayfalar

* [Kimlik Doğrulama](https://docs.tryoto.com/tr/developers/authentication.md) — bu uç noktaların nasıl çağrılacağı.
* [Webhook’lar](https://docs.tryoto.com/tr/developers/webhook-events.md) — size geri dönen olaylar.
* [apis.tryoto.com](https://apis.tryoto.com) — tüm şemalar ve çalıştırılabilir örnekler.


## Related topics

- [OTO API Postman koleksiyonu](https://docs.tryoto.com/tr/developers/postman-collection.md)
- [OTO API’ye genel bakış](https://docs.tryoto.com/tr/developers/overview.md)
- [API hataları ve istek sınırları](https://docs.tryoto.com/tr/developers/errors-and-rate-limits.md)


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