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

# Postman koleksiyonu

> Tüm endpoint'leri içeren, giriş akışı hazır bir Postman koleksiyonu indirin.

API'nin tamamını (kimlik doğrulama dahil) kapsayan, hazır değişkenlerle çalışan bir Postman koleksiyonu hazırladık. curl komutlarını elle kopyalamak yerine doğrudan içe aktarıp deneyebilirsiniz.

<CardGroup cols={2}>
  <Card title="Koleksiyonu indirin" icon="file-arrow-down">
    `NoyaxApi.postman_collection.json` — her modül kendi klasöründe, kimlik doğrulama dahil tüm endpoint'ler.

    <a href="/postman/NoyaxApi.postman_collection.json" download>İndirmeyi başlat ↓</a>
  </Card>

  <Card title="Ortamı indirin" icon="gear">
    `NoyaxApi.postman_environment.json` — aynı değişkenler, ayrı bir Postman Environment olarak.

    <a href="/postman/NoyaxApi.postman_environment.json" download>İndirmeyi başlat ↓</a>
  </Card>
</CardGroup>

<Steps>
  <Step title="İçe aktarın">
    Postman'de **Import**'a tıklayıp her iki dosyayı da seçin (environment isteğe bağlıdır; koleksiyonun kendi değişkenleri zaten yeterlidir).
  </Step>

  <Step title="Değişkenleri doldurun">
    Koleksiyonun **Variables** sekmesinde (ya da içe aktardıysanız environment'ta) şunları girin:

    | Değişken    | Açıklama                                               |
    | ----------- | ------------------------------------------------------ |
    | `orgName`   | Kuruluş adınız                                         |
    | `apiKey`    | API anahtarınız                                        |
    | `userId`    | `X-UserID` olarak gönderilecek Noyax kullanıcı ID'si   |
    | `companyId` | `X-CompanyID` olarak gönderilecek şirket ID'si         |
    | `periodId`  | Yalnızca muhasebe tabloları için; boş bırakabilirsiniz |

    `baseUrl` ve `authBaseUrl` dev ortamına ayarlıdır, farklı bir ortama karşı çalışacaksanız değiştirin.
  </Step>

  <Step title="Login'i çalıştırın">
    **Auth → Login** isteğini gönderin. Yanıttaki access/refresh token otomatik olarak `accessToken`/`refreshToken` değişkenlerine kaydedilir (isteğin **Tests** sekmesindeki script bunu yapar).
  </Step>

  <Step title="Diğer istekleri çalıştırın">
    Koleksiyondaki her istek, `accessToken` değişkenini kullanan Bearer kimlik doğrulamasını koleksiyon seviyesinden miras alır; `X-UserID`/`X-CompanyID` header'ları da otomatik olarak `userId`/`companyId` değişkenlerini kullanır. Ayrıca bir şey ayarlamanıza gerek yok.

    Access token süresi dolarsa **Auth → Refresh token**'ı çalıştırın; tekrar Login'e gerek kalmaz.
  </Step>
</Steps>

## İçerik

Koleksiyon, bu dokümantasyonu üreten OpenAPI tanımından derlendiği için API'deki gerçek endpoint, alan ve örnek değerlerle birebir uyumludur ve her sürümle güncel tutulur. `POST`/`PUT` gövdeleri gerçekçi örnek verilerle doludur; `PATCH` istekleri ise kısmi güncellemenin (bkz. [Kısmi güncelleme](/tr/v1/guides/partial-update)) mantığını göstermek için kasıtlı olarak yalnızca birkaç alan içerir.

<Note>
  Koleksiyon modülleri bu dokümandaki gruplamanın aynısını izler: Cariler, Ürünler, Tanımlar, Stok, Teklifler, Siparişler, İrsaliyeler, Faturalar, Finans.
</Note>