Skip to content

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.

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

Yanıt ​

json
{
  "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"
    }
  ]
}
AlanAçıklama
hostProxy IP adresi.
portProxy portu.
usernameProxy kullanıcı adı.
passwordProxy parolası.
proxy_urlKimlik 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:

bash
curl "https://app.qevron.ai/v1/proxies?format=text" \
  -H "Authorization: Bearer $QEVRON_API_KEY"
text
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.

bash
curl https://app.qevron.ai/v1/proxies/rotate \
  -H "Authorization: Bearer $QEVRON_API_KEY"
json
{
  "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:

bash
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.

Qevron — AI gateway. Arpanet / OpenAI / Anthropic / Gemini uyumlu.