Proxy Listeleri

API anahtarınızla HTTP proxy havuzuna erişebilirsiniz. qevron, proxy'leri Webshare üzerinden düzenli olarak (varsayılan saatte bir) çeker ve anahtarınıza sunar. Tüm uç noktalar GET'tir ve API anahtarı ile doğrulanır.

Opt-in erişim

Erişim isteğe bağlıdır (opt-in): bir anahtarın proxy alabilmesi için izinli modelleri arasında havuz adını (ör. proxy) açıkça listelemesi gerekir. Havuz adını içermeyen anahtarlar proxy almaz.

Tüm proxy listesi

GET/v1/proxies

Anahtarınızın erişebildiği tüm proxy havuzunu döndürür.

curl https://app.qevron.ai/v1/proxies \
  -H "Authorization: Bearer $QEVRON_API_KEY"

Yanıt

{
  "object": "list",
  "count": 100,
  "data": [
    {
      "host": "1.2.3.4",
      "port": 8080,
      "username": "kullanici",
      "password": "parola",
      "proxy_url": "http://kullanici:parola@1.2.3.4:8080"
    }
  ]
}

Alan	Açıklama
host	Proxy IP adresi.
port	Proxy portu.
username	Proxy kullanıcı adı.
password	Proxy parolası.
proxy_url	Kimlik bilgisi gömülü, doğrudan kullanılabilir URL (http://kullanici:parola@host:port).

Düz metin biçimi

Araçlara doğrudan beslemek için ?format=text ile ham host:port:kullanici:parola satırları alın:

curl "https://app.qevron.ai/v1/proxies?format=text" \
  -H "Authorization: Bearer $QEVRON_API_KEY"

1.2.3.4:8080:kullanici:parola
5.6.7.8:8080:kullanici:parola

Tek proxy (rotasyon)

GET/v1/proxies/rotate

Her çağrıda sırayla (round-robin) tek bir proxy döndürür.

curl https://app.qevron.ai/v1/proxies/rotate \
  -H "Authorization: Bearer $QEVRON_API_KEY"

{
  "host": "1.2.3.4",
  "port": 8080,
  "username": "kullanici",
  "password": "parola",
  "proxy_url": "http://kullanici:parola@1.2.3.4:8080"
}

• ?pool=<ad> — birden fazla havuza erişiminiz varsa belirli bir havuzu seçer.
• ?format=text — tek bir host:port:kullanici:parola satırı döndürür.
• Anahtarınızın erişebildiği proxy yoksa 404 no_proxy_available döner.

Kullanım

proxy_url alanını herhangi bir HTTP istemcisine verebilirsiniz:

PROXY=$(curl -s https://app.qevron.ai/v1/proxies/rotate \
  -H "Authorization: Bearer $QEVRON_API_KEY" | jq -r .proxy_url)
curl --proxy "$PROXY" https://api.ipify.org

TIP

Proxy listesi sunucu tarafında düzenli olarak yenilenir; uzun ömürlü işlerde periyodik olarak /v1/proxies veya /v1/proxies/rotate çağırarak güncel havuzu kullanın.