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

# Noyax API

> Noyax verilerinize kendi uygulamanızdan, sunucudan sunucuya güvenli erişim.

Noyax API ile ERP, e-ticaret, CRM gibi sistemlerinizi Noyax'a bağlayabilirsiniz. API REST prensiplerine göre çalışır: kaynaklar URL ile adreslenir, istek ve yanıt gövdeleri JSON'dur ve sonuçlar standart HTTP durum kodlarıyla bildirilir.

<CardGroup cols={2}>
  <Card title="Hızlı başlangıç" icon="rocket" href="/tr/v1/quickstart">
    Token alın ve ilk isteğinizi 5 dakikada atın.
  </Card>

  <Card title="Kimlik doğrulama" icon="key" href="/tr/v1/guides/authentication">
    API anahtarı, access token ve refresh token akışı.
  </Card>

  <Card title="Cariler" icon="users" href="/tr/v1/customers/overview">
    Cari kartları ve alt kayıtları için kurallar.
  </Card>

  <Card title="API referansı" icon="code" href="/tr/v1/customers/list">
    Tüm endpoint'ler, alanlar ve deneme ekranı.
  </Card>
</CardGroup>

## Temel bilgiler

|                        |                                                                                     |
| ---------------------- | ----------------------------------------------------------------------------------- |
| **Base URL**           | `https://api.noyax.com/api/v1`                                                      |
| **Format**             | JSON (UTF-8). Alan adları PascalCase'tir: `CustomerCode`, `TaxNumber`               |
| **Kimlik doğrulama**   | `Authorization: Bearer <access token>`                                              |
| **Zorunlu header'lar** | `X-UserID`, `X-CompanyID` ([ayrıntılar](/tr/v1/guides/request-context))             |
| **Tarihler**           | ISO 8601, Türkiye saati (UTC+3), saat dilimi bilgisi olmadan: `2026-09-17T14:30:00` |
| **Hata mesajları**     | İngilizce                                                                           |

## Yanıt yapısı

Tüm yanıtlar aynı zarfı kullanır. Başarılı yanıtlarda `ResultCode` `0000` olur ve veri `Data` içindedir. Hatalarda `Success` `false` olur, `ResultCode` hatayı kodla, `Errors` ise her hatayı koduyla birlikte listeler.

<CodeGroup>
  ```json Başarılı theme={null}
  {
    "Success": true,
    "ResultCode": "0000",
    "Message": null,
    "Data": {
      "Id": "3f2b8c1e-5d47-4a9b-9e21-6c0d8f7a1b24",
      "CustomerCode": "0000382026",
      "Name": "Örnek Ticaret A.Ş."
    }
  }
  ```

  ```json Hatalı theme={null}
  {
    "Success": false,
    "ResultCode": "1004",
    "Message": "Name is required. TaxNumber is required.",
    "Errors": [
      { "Code": "1004", "Message": "Name is required." },
      { "Code": "1005", "Message": "TaxNumber is required." }
    ]
  }
  ```
</CodeGroup>

Hata yanıtının yapısı için [Hatalar](/tr/v1/guides/errors), tüm kodlar için [Sonuç kodları](/tr/v1/guides/result-codes) sayfasına bakın.

## Erişim almak

API anahtarınız ve kuruluş adınız (OrgName) Noyax tarafından verilir. Anahtarın hangi modüllerde okuma ya da yazma yetkisi olduğu ve günlük istek limiti anahtar bazında tanımlanır. Erişim talebi için Noyax destek ekibiyle iletişime geçin.

<Warning>
  API anahtarınızı yalnızca sunucu tarafında saklayın. Tarayıcı, mobil uygulama gibi son kullanıcıya dağıtılan kodlara koymayın.
</Warning>