> ## 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 Postman koleksiyonu

> Kod yazmadan önce OTO API’yi Postman’den test ortamında çağırın; erişim belirtecinden ilk isteğe kadar on dakikalık bir ilk deneme yapın.

Bir API’yi anlamanın en hızlı yolu onu çağırmaktır. Yayımlanan koleksiyon, daha kendi kodunuzun tek satırını yazmadan bunu test ortamında yapmanızı sağlar.

## Koleksiyon

Tüm başvuru kaynağı [apis.tryoto.com](https://apis.tryoto.com) adresindedir. Doğrudan Postman koleksiyonunun kendisinden üretilir, bu yüzden API’den kopmaz: Her uç nokta gerçek istek gövdesini, canlı bir örnek yanıtı ve otuzdan fazla dilde çalıştırılabilir kodu içerir.

| Neler sunar? | Neden önemli? |
| - | - |
| **İstek ve yanıt şemaları** | Her alan, türü ve zorunlu olup olmadığı. |
| **Uygulamalı örnekler** | Alan listeleri yerine gerçek yükler (payload); çok kolili bir gönderi gibi zahmetli olanlar dahil. |
| **Kendi dilinizde kod** | İstekten üretilen cURL, JavaScript, Python, PHP, Java, Go, C#, Ruby, Swift ve daha fazlası. |
| **Bir yapay zekâ asistanı** | Portala yerleşiktir; tüm uç noktaları okumak yerine hangisinin ne yaptığını sorabilirsiniz. |

## Test ortamında çalışmak

Koleksiyonu `https://staging-api.tryoto.com` adresine yönlendirdiğinizde, gerçek kargo şirketleri yerine test kargo şirketleriyle, tam olarak canlı ortamdaki gibi davranır. Aynı yollar, aynı yükler, aynı yanıtlar; ancak gerçek koli ve fatura yok.

> [!TIP]
>
> **Temel URL’yi ilk günden bir değişken olarak tanımlayın**
>
> Test ortamı ile canlı ortam arasındaki tek fark, sunucu adresi ve anahtardır. İkisi de baştan koleksiyon değişkeni olursa, ortam değiştirmek bir açılır menüden seçim yapmaktan ibarettir.
>
> Bunun yerine her isteğe elle yazılırlarsa, ortam değiştirmek her isteği düzenlemek ve birini atlamak anlamına gelir. Atlanan da genellikle bir şey oluşturan istek olur.

## On dakikalık ilk deneme

1. Bir test ortamı hesabı edinin ve bu hesabın `refresh_token` değerini **Ayarlar → API Integrations** bölümünden alın.
2. `POST /rest/v2/refreshToken` uç noktasını çağırın. `access_token` değerini bir değişkene kaydedin.
3. Hem anahtarın hem de sunucu adresinin doğru olduğunu doğrulamak için `GET /rest/v2/healthCheck` uç noktasını çağırın.
4. Adresi test kargo şirketlerinizin hizmet verdiği bir yerle değiştirerek, örnek gövdeyle `POST /rest/v2/createOrder` uç noktasını çağırın.
5. Bu güzergah için `POST /rest/v2/checkOTODeliveryFee` uç noktasını çağırın ve dönen sonuca bakın: kargo şirketi bazında fiyatlar, tahmini teslimat süreleri ve son kabul saatleri.
6. `POST /rest/v2/createShipment` uç noktasını çağırın. Artık yazdırabileceğiniz bir kargo etiketiniz (AWB) var.

Bu sıralama, entegrasyonun tamamının küçük bir modelidir. Geri kalan her şey bunun bir varyasyonudur.

> [!NOTE]
>
> **Test ortamında gerçek bir adres kullanın**
>
> Kargo şirketi kapsama alanı test ortamında bile kontrol edilir; bu yüzden uydurma bir şehir “no carriers available” sonucunu verir ve kötü bir test verisi yerine bozuk bir entegrasyon gibi görünür.
>
> `availableCities` yanıtında gördüğünüz bir şehri seçin ve onu kullanmaya devam edin.

## İlgili sayfalar

* [Kimlik Doğrulama](https://docs.tryoto.com/tr/developers/authentication.md) — tüm bunların dayandığı anahtarı almak.
* [REST API başvuru kaynağı](https://docs.tryoto.com/tr/developers/rest-api-reference.md) — başka neler var.
* [apis.tryoto.com](https://apis.tryoto.com) — koleksiyonun kendisi.


## Related topics

- [OTO API’ye genel bakış](https://docs.tryoto.com/tr/developers/overview.md)
- [API kimlik doğrulaması](https://docs.tryoto.com/tr/developers/authentication.md)
- [REST API başvuru kaynağı](https://docs.tryoto.com/tr/developers/rest-api-reference.md)


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