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

# Moove API Keys

> Moove API için kapsamlı bir API anahtarı oluşturun, bir kez kopyalayın ve işiniz bittiğinde kalıcı olarak iptal edin.

Bir anahtar oluşturun, bir kez kopyalayın, Moove API'yi çağırmak için kullanın.

<Info>
  **Yalnızca web**, [moove.xyz/dashboard/api-keys](https://www.moove.xyz/dashboard/api-keys) adresinde. Mobil karşılığı yoktur.
</Info>

## API anahtarı nasıl oluşturulur?

<Steps>
  <Step title="Yönet → API anahtarları'nı açın">
    Web gösterge panelinde.
  </Step>

  <Step title="Ad verin">
    Altı ay sonra tanıyacağınız bir şey — hangi hizmet ya da ortam için olduğu.
  </Step>

  <Step title="Bir ajan seçin">
    **Moove Receive Agent** var olan ajandır. O ajanın ihtiyaç duyduğu kapsamlara açılır.
  </Step>

  <Step title="Anahtarı kopyalayın">
    <Warning>
      Düz metin anahtar oluşturma anında **bir kez** gösterilir. Şimdi kopyalayın ve gizli anahtar yöneticinizde saklayın. Kopyalamadan pencereyi kapatırsanız anahtar kullanılamaz olur — bir yenisini oluşturun.
    </Warning>
  </Step>
</Steps>

Temel URL `https://api.moove.xyz`'dir.

## Ham kapsamlar değil, Moove Agents

Bir izin dizesi değil, bir **ajan** seçersiniz. "Moove Receive Agent" bir işletmecinin üzerine düşünebileceği birimdir; `payment_link:create` değildir.

| Ajan                    | Durum     | Verdiği kapsamlar                          |
| ----------------------- | --------- | ------------------------------------------ |
| **Moove Receive Agent** | **Etkin** | `payment_link:create`, `payment_link:read` |
| Moove Send Agent        | Yakında   | —                                          |
| Moove Swap Agent        | Yakında   | —                                          |
| Moove Ramp Agent        | Yakında   | —                                          |

Yakında gelecek üç ajan devre dışı görünür. Birini seçmek hiçbir şey vermeyen bir anahtar üretirdi, bu yüzden seçici buna izin vermez.

## Bir API anahtarının yapabilecekleri ve yapamayacakları

<Note>
  Bir anahtar **sizin daraltılmış hâlinizdir**. Hesabınız gibi davranır ve yalnızca sizin yapabildiklerinizin bir alt kümesini yapabilir.

  **Hiçbir uç nokta para hareket ettirmez.** Bir ödeme bağlantısı her zaman kendi varsayılan cüzdanınıza, o cüzdanın tokeniyle mutabakat yapar — çağıran bir hedef belirtemez. Sızan bir anahtar *size* ödeyen talepler oluşturabilir. Başka kimseye ödeyemez.
</Note>

Bir anahtar başka bir anahtar da üretemez. Anahtar yönetimi yalnızca oturumla kimlik doğrular, dolayısıyla ele geçirilmiş bir anahtar kendi yetkisini yükseltemez.

## Bir anahtarı nasıl güvende tutarım?

<Warning>
  * Gizli anahtar yöneticisinde ya da bir ortam değişkeninde saklayın. Asla sürüm kontrolünde değil.
  * Asla bir isteme, sohbete, konu kaydına ya da ekran görüntüsüne yapıştırmayın.
  * Hizmet başına ayrı anahtar kullanın; böylece birini iptal etmek diğerlerini düşürmez.
  * Şüphelendiğiniz her anahtarı iptal edin. Yenisini oluşturmak saniyeler sürer.
</Warning>

## Kaç anahtarım olabilir?

Hesap başına **10 aktif anahtar**a kadar. On birincisini oluşturursanız istek `TOO_MANY_API_KEYS` ile reddedilir — önce artık kullanmadığınız birini iptal edin.

<Tip>
  Bu tavan, anahtarları dağıtım başına değil entegrasyon başına kapsamlamak için bir nedendir. Gerçekten çalıştırdığınız hizmet başına tek anahtar hem daha anlaşılırdır hem de bir şey değiştiğinde iptal etmesi daha kolaydır.
</Tip>

## Bir anahtarı nasıl iptal ederim?

<Steps>
  <Step title="Anahtarın menüsünü açın">
    **Yönet → API anahtarları** içinde, anahtarın satırındaki **…** menüsünü açın ve **İptal et**'i seçin.
  </Step>

  <Step title="Onaylayın">
    Onaylamak için yeniden **İptal et**'e tıklayın. Anahtar anında çalışmayı bırakır.
  </Step>
</Steps>

<Warning>
  **İptal kalıcıdır.** Geri alma yoktur. Düz metin hiçbir zaman saklanmadığı için, kayıt geri getirilse bile iptal edilmiş bir anahtar bir daha asla kullanılamaz. Bunun yerine yeni bir anahtar çıkarın.
</Warning>

## Bir anahtarı nasıl kullanırım?

Her istekte `X-API-Key` başlığıyla gönderin.

```bash theme={null}
curl -sS -X POST "https://api.moove.xyz/v1/payment-link" \
  -H "X-API-Key: $MOOVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "toAmount": "49.99" }'
```

[Authentication →](/api-reference/authentication)

## İlk çağrınızdan önce

API, ödeme alamayan bir hesap için bağlantı oluşturmayı reddeder. Bir [Moove Kullanıcı Adı](/tr-tr/brand/moove-handle) aldığınızdan ve [mutabakat tokeni](/tr-tr/concepts/settlement-and-auto-routing) olan varsayılan bir cüzdan ayarladığınızdan emin olun — yoksa `409` alırsınız.

## Sırada ne okumalı

<CardGroup cols={3}>
  <Card title="Authentication" icon="lock" href="/api-reference/authentication">
    Başlığın nasıl çalıştığı.
  </Card>

  <Card title="Moove Agentic Payments" icon="sparkles" href="/tr-tr/transact/moove-agentic-payments">
    Entegrasyonu bir yapay zekâ aracı yapsın.
  </Card>

  <Card title="Moove Payment Links API" icon="link" href="/api-reference/moove-receive/moove-payment-links">
    Uç noktaların tamamı.
  </Card>
</CardGroup>

Kapsamlı, iptal edilebilir, sizin. Paranız. Hamleniz.