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

# Sorun giderme: kimlik doğrulama ve API anahtarları

> 401, 403 veya 422 yanıtına hangi doğrulama denetiminin yol açtığını bulun ve anahtar, mod veya IP listesini düzeltin.

# Sorun giderme: kimlik doğrulama ve API anahtarları

Orbit'e yapılan her istek kimlik bilgisi, süre ve iptal, sandbox/live modu, IP izin listesi ve yetki denetimlerinden geçer. Birden fazla denetim aynı HTTP durumunu kullanabildiği için `code` alanını okuyun.

| Kod | HTTP | Tetiklenen denetim |
| - | - | - |
| `UNAUTHORIZED` | 401 | Kullanılabilir kimlik bilgisi yok |
| `INVALID_API_KEY` | 401 | Anahtar bilinmiyor, iptal edilmiş veya kaynak IP'ye izin yok |
| `EXPIRED_TOKEN` | 401 | Anahtarın süresi dolmuş veya planlı iptal zamanı gelmiş |
| `WRONG_KEY_MODE` | 403 | Anahtar modu çalışma alanıyla uyuşmuyor |
| `IP_NOT_ALLOWED` | 403 | Kuruluş IP listesi kaynağı engelledi |
| `INSUFFICIENT_PERMISSIONS` | 403 | Rol veya kapsam rotaya izin vermiyor |
| Genel anahtarla yazma | 422 | `dv_..._pk_` anahtarı salt okunur |
| `STALE_WEBHOOK` | 401 | Webhook zaman damgası eksik veya eski |

## 401 hataları

`UNAUTHORIZED` için `X-API-Key` başlığını ve anahtarın tamamını gönderdiğinizi doğrulayın. `INVALID_API_KEY`, bilinmeyen, iptal edilmiş veya anahtarın IP listesi tarafından engellenmiş bir anahtarı gösterir. **Settings → API Keys** bölümünden yeniden kopyalayın ya da yenisini oluşturun. `EXPIRED_TOKEN`, süre veya `revoke_at` zamanının geçtiği anlamına gelir; anahtarı döndürün.

## Sandbox ve live

`dv_test_sk_` anahtarı sandbox'ta, `dv_live_sk_` anahtarı live ortamda kullanılmalıdır. Yanlış eşleşme handler çalışmadan önce `403 WRONG_KEY_MODE` döndürür. Anahtarı çağırdığınız kuruluşta oluşturun.

## IP izin listeleri

Anahtara ait liste tarafından engellenen IP kasıtlı olarak `401 INVALID_API_KEY` döndürür. Kuruluş listesi ise `403 IP_NOT_ALLOWED` döndürür. Orbit'in gördüğü genel çıkış IP'sini belirleyin ve güvenlik ayarlarına bu IP'yi veya CIDR aralığını ekleyin.

## Genel anahtarlar ve SAML/SCIM

Genel anahtarlar salt okunurdur. `messages:write` gibi yazma işlemleri için backend üzerinde gizli anahtar kullanın. SAML kullanıcısı kuruluşa ait olmalı, SCIM ise yapılandırılmış rol üst sınırını aşmamalıdır.

Gizli anahtarı desteğe göndermeyin. Kodu, `request_id` değerini ve yalnızca anahtar önekini paylaşın.


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