5 Adımda API Entegrasyonu
Bu rehber sizi hesap oluşturmadan ilk API isteğinizi göndermeye kadar adım adım yönlendirir. 5 dakika içinde çalışan bir entegrasyon elde edeceksiniz.
ProxyTurk hesabı oluşturarak başlayın. Kayıt olduğunuzda otomatik olarak 500 ücretsiz kredi alırsınız. Bu kredilerle tüm API özelliklerini test edebilirsiniz.
Kayıt sayfasına gidin ve e-posta adresinizle hesap oluşturun. E-posta doğrulamasını tamamladıktan sonra dashboard'a erişim sağlayabilirsiniz.
Dashboard'a giriş yaptıktan sonra "API Keys" bölümüne gidin. "Yeni API Key Oluştur" butonuna tıklayarak bir key oluşturun.
ÖNEMLİ: API key'inizi güvenli bir yerde saklayın. Environment variable olarak kullanmanızı öneriyoruz. Git'e commit etmeyin.
API key'inizi aldıktan sonra ilk isteğinizi gönderebilirsiniz. Aşağıdaki örnekler sync modda (sonucu bekleyerek) basit bir web scraping isteği göndermektedir.
Base URL: https://api.proxyturk.com Authentication: Bearer token olarak API key'inizi gönderin.
curl -X POST https://api.proxyturk.com/v1/scrape?wait=true \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com", "formats": ["markdown"] }'Başarılı bir istek sonucunda JSON formatında yanıt alırsınız. Response içinde:
- success: İsteğin başarılı olup olmadığı (boolean) - data: Çekilen veri (endpoint'e göre değişir) - meta: İşlem süresi, kredi maliyeti gibi ek bilgiler - job_id: Async modda işi takip etmek için kullanılan ID
İlk isteğinizi başarıyla gönderdikten sonra:
- Python veya Node.js SDK kurarak geliştirme sürecinizi hızlandırın - Webhook kurulumu yaparak async sonuçları otomatik alın - Kod örnekleri sayfasından gerçek dünya senaryolarını inceleyin - Rate limit ve hata yönetimi için API Reference'ı okuyun
Dashboard'dan mevcut key'i iptal edip yeni bir key oluşturabilirsiniz. Eski key hemen devre dışı kalır.
Ücretsiz 500 kredi süresiz geçerlidir, sadece kullandıkça azalır. Zaman sınırı yoktur.
Sync mod (?wait=true) sonuç hazır olana kadar bağlantıyı açık tutar (max 60 sn). Async mod hemen bir job_id döner, sonucu polling veya webhook ile alırsınız.