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

# Hızlı başlangıç

> Anahtar oluşturun, ilk isteğinizi gönderin ve yanıtı okuyun.

<Steps>
  <Step title="API anahtarı oluşturun">
    Firma yöneticisi hesabıyla [app.banka.pro](https://app.banka.pro/api-anahtarlari) üzerinde **API anahtarları → Yeni anahtar** adımlarını izleyin.

    * **Tanım:** Anahtarı tanımanızı sağlayan ad (ör. "Muhasebe entegrasyonu").
    * **Erişim bitişi:** Anahtarın geçerli olduğu son gün.
    * **IP kısıtı:** İsteğe bağlı. Doluysa yalnız bu adreslerden gelen istekler kabul edilir.
    * **Yetkiler:** Entegrasyonun ihtiyaç duyduğu en dar yetki kümesi. Ayrıntılar için [Kimlik doğrulama](/kimlik-dogrulama#yetkiler).

    Kaydettiğinizde **Anahtar kimliği (kullanıcı adı)** ve **Secret key (parola)** gösterilir.

    <Warning>
      Secret key yalnız bu ekranda bir kez gösterilir. Hemen bir parola kasasına ya da sunucunuzun gizli değişkenlerine kaydedin. Kaybederseniz aynı sayfadan yenileyebilirsiniz; eski secret key o anda geçersiz olur.
    </Warning>
  </Step>

  <Step title="İlk isteği gönderin">
    Anahtar kimliği kullanıcı adı, secret key parola olarak HTTP Basic ile gönderilir. Aşağıdaki istek firmanın banka hesaplarını listeler (`Hesaplar` yetkisi gerekir).

    <CodeGroup>
      ```bash cURL theme={null}
      curl https://api.banka.pro/v1/bank-accounts \
        -u "$BANKAPRO_API_KEY_ID:$BANKAPRO_API_SECRET"
      ```

      ```python Python theme={null}
      import os
      import requests

      response = requests.get(
          "https://api.banka.pro/v1/bank-accounts",
          auth=(os.environ["BANKAPRO_API_KEY_ID"], os.environ["BANKAPRO_API_SECRET"]),
          timeout=30,
      )
      response.raise_for_status()
      accounts = response.json()["data"]
      ```

      ```javascript Node.js theme={null}
      const credentials = Buffer.from(
        `${process.env.BANKAPRO_API_KEY_ID}:${process.env.BANKAPRO_API_SECRET}`,
      ).toString("base64");

      const response = await fetch("https://api.banka.pro/v1/bank-accounts", {
        headers: { Authorization: `Basic ${credentials}` },
      });
      const { data: accounts } = await response.json();
      ```

      ```php PHP theme={null}
      <?php
      $ch = curl_init('https://api.banka.pro/v1/bank-accounts');
      curl_setopt_array($ch, [
          CURLOPT_USERPWD => getenv('BANKAPRO_API_KEY_ID') . ':' . getenv('BANKAPRO_API_SECRET'),
          CURLOPT_RETURNTRANSFER => true,
      ]);
      $body = json_decode(curl_exec($ch), true);
      $accounts = $body['data'];
      ```
    </CodeGroup>
  </Step>

  <Step title="Yanıtı okuyun">
    Başarılı yanıtlar her zaman `success`, `data` ve `meta` alanlarını taşır. Liste uçlarında `meta` sayfalama bilgisini de içerir.

    ```json 200 OK theme={null}
    {
      "success": true,
      "data": [
        {
          "id": "64f000000000000000000101",
          "name": "Merkez TRY Hesabı",
          "bankName": "Örnek Banka",
          "bankCode": "00010",
          "iban": "TR000000000000000000000000",
          "currency": "TRY",
          "balance": "125000.50",
          "balanceKnown": true
        }
      ],
      "meta": {
        "requestId": "9cc0d3d1-1e63-4c90-b08f-90b6332e70ca",
        "timestamp": "2026-09-08T20:00:00.000Z",
        "page": 1,
        "pageSize": 25,
        "total": 1,
        "totalPages": 1
      }
    }
    ```

    Örnek kısaltılmıştır; bütün alanlar [API referansında](/api-reference/banka-hesaplari/listele) yer alır. Tutarların neden metin olduğunu ve `balance: null` değerinin anlamını [Veri kuralları](/veri-kurallari) sayfası açıklar.
  </Step>
</Steps>

## Sonraki adımlar

<CardGroup cols={2}>
  <Card title="Yanıtlar ve hatalar" icon="triangle-exclamation" href="/yanitlar-ve-hatalar">
    Hata zarfı, hata kodları ve `x-request-id`.
  </Card>

  <Card title="Artımlı eşitleme" icon="arrows-rotate" href="/artimli-esitleme">
    Hareketleri sisteminize kayıpsız ve tekrar etmeden aktarın.
  </Card>
</CardGroup>


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