# Geliştirici API ve API anahtarlarını kullanın

Sunucu tarafı anahtarı oluşturun, canlı sözleşmeyi kullanın ve satın alma işlemlerini yanlışlıkla kopyalanmadan yeniden deneyin.

2026-10-07 · TextVerified

## Anahtar oluşturun ve koruyun

Açık Geliştiriciler ve API anahtar alanı. Etiketli bir anahtar oluşturun ve görüntülenen kimlik bilgilerini güvenli bir şekilde kaydedin. Anahtarlar hesap kapsamındadır: aramalar söz konusu hesabın cüzdanını ve mağazasındaki siparişleri kullanır. Yönetici erişimi sağlamazlar veya bir istek yoluyla hesaplar arasında geçiş yapmanıza izin vermezler.

Eski bir anahtarı iptal etmek için mümkün olduğunda devre dışı bırakma, silme veya yeniden oluşturmayı kullanın. Yenileme önceki kimlik bilgilerini geçersiz kılar. Anahtarları sunucunuzda, genel tarayıcı kodunun, ekran görüntülerinin ve depoların dışında tutun.

## Canlı API sözleşmesini okuyun

TextVerified's base is `https://textverified.org/api/v1/developer`. On a partner storefront use that store's own hostname. Authentication accepts `X-API-Key` or `Authorization: Bearer YOUR_API_KEY`. Use [interactive API documentation](/api/v1/developer/docs) and the current schema rather than guessing request fields.

Satın almadan önce bakiyeyi ve hizmetleri okuyun. Hizmet listeleri `otp` ve `rent`, ülke, stok ve teklif edilen süreleri birbirinden ayırır; süreler milisaniye kullanır. Satın alma istekleri, gerçek hizmet tanımlayıcıyı, ülkeyi, süreyi ve tavan fiyatını seçer. İsteğe bağlı sağlayıcı veya açıklama alanları belgelenen işleme bağlıdır.

## Satın alma işlemlerini güvenle gerçekleştirin

Planlanan her satın alma işlemi için yeni bir `Idempotency-Key` kullanın ve bu satın alma işlemini yeniden denediğinizde aynı anahtarı kullanın. Anahtarlar 8–128 ASCII harflerini, rakamlarını, alt çizgilerini veya kısa çizgilerini kabul eder. Bir zaman aşımından sonra, başka bir sipariş başlatmaya karar vermeden önce belgelenen satın alma girişimi aramasını inceleyin. Aynı anahtar altındaki yükün değiştirilmesi çakışmaya neden olabilir.

```http
GET /api/v1/developer/balance
X-API-Key: YOUR_API_KEY
```

Bu örnek, gerçek bir kimlik bilgisi değil, yer tutucu içeren bir okuma isteğidir. Ücretli işlemler için canlı satın alma örneklerini takip edin. Sahip olunan siparişleri ve mesajları belgelenmiş uç noktaları aracılığıyla okuyun; iptal, siparişin uygunluğuna ve onayına tabidir.

## Hataları yorumlayın ve mesajları entegre edin

401, kimlik bilgilerinin eksik, devre dışı bırakılmış, değiştirilmiş veya yanlış saklandığı anlamına gelebilir. 404, kullanılamayan veya sahip olunmayan veriler anlamına gelebilir. 400 doğrulamayı, fonları veya fiyat koşullarını yansıtabilir. Belirsiz bir sunucu sonucu için, körü körüne yeni bir anahtar oluşturmak yerine satın alma anahtarını saklayın ve girişimi inceleyin.

Gelen mesaj olayları için [Webhooks](/tr/guides/webhooks)'yi kullanın. API'nin her kontrol paneli kontrolünü açığa çıkardığını varsaymayın; Her operasyon için mevcut sözleşmeyi kontrol edin.