API Dökümantasyonu

JetProxy.tr API, proxy havuzlarınızı programatik olarak yönetmenizi sağlar. Aşağıdaki dökümantasyon; kimlik doğrulama, temel uç noktalar, kullanım limitleri ve örnek yanıtları içerir. Not: Buradaki anahtar ve adresler örnek amaçlıdır.

Temel bilgiler

• Base URL: https://api.jetproxy.tr/v1
• Format: JSON
• Protokol: HTTPS (TLS 1.2+)

Authentication

Tüm istekler Authorization başlığında bir API anahtarı gerektirir. Anahtarınızı kurumsal panelden oluşturabilirsiniz.

# Örnek istek başlığı
Authorization: Bearer JP_live_xxx...xxx
Content-Type: application/json

Örnek endpointler

Proxy listesi alma

// 200 OK
{
  "data": [
    { "id": "px_8f21", "host": "tr.jetproxy.tr", "port": 10001, "type": "residential", "country": "TR" }
  ],
  "total": 50,
  "page": 1
}

IP değişim isteği

// 200 OK
{
  "id": "px_8f21",
  "rotated": true,
  "new_ip": "188.43.12.77",
  "next_rotation_in": 600
}

Session oluşturma

// İstek gövdesi
{
  "type": "sticky",
  "country": "tr",
  "ttl": 1800
}

// 201 Created
{
  "session_id": "sess_a1b2",
  "endpoint": "tr.jetproxy.tr:10500",
  "expires_in": 1800
}

Kullanım limitleri

• Varsayılan: 60 istek / dakika
• Liste uç noktaları: sayfa başına en fazla 200 kayıt
• Aşım durumunda 429 Too Many Requests döner
• Limitler kurumsal pakete göre yükseltilebilir

Hata formatı

{
  "error": {
    "code": "rate_limited",
    "message": "İstek limiti aşıldı."
  }
}

Not: Bu dökümantasyon tanıtım amaçlıdır. Üretim entegrasyonu ve anahtar talebi için kurumsal destek ekibimizle iletişime geçin.