Yeni! |Tek API çağrısı, temiz veri. Kazıyıcı gerekmez.10,000 ücretsiz token alın →

Geliştirici platformu

FineProxy API ve MCP

Proxy işlemlerini kodunuzdan otomatikleştirin veya bir yapay zekâ ajanı bağlayın. Nelerin desteklendiğini, koruma önlemlerinin nerede uygulandığını ve sağlayıcı değiştirmeden önce mevcut bir entegrasyonun nasıl denetleneceğini öğrenin.

REST API49 OpenAPI işlemi
MCP sunucusu49 ajan aracı
ErişimKapsamı sınırlı API anahtarları

Tek platform, otomasyon için iki yol

API ve MCP, kapsamı sınırlı aynı FineProxy anahtarlarını kullanır ve aynı müşteri iş akışlarını sunar. Bunları kimin işleteceğine göre seçim yapın: uygulamanız veya bir yapay zekâ ajanı.

REST · OpenAPI 3.1

FineProxy'yi uygulamanıza entegre edin

Belgelenmiş HTTP uç noktalarını bir backend'den, script'ten, CI görevinden, şirket içi panelden veya no-code iş akışından kullanın. Güncel istemci spesifikasyonu kontrol panelinde mevcuttur.

Kodunuzun şunları yapması gerektiğinde en uygunudur:
  • Yapay zekâ modeli olmadan deterministik iş akışları çalıştırmak
  • İstek ve yanıt yapılarını OpenAPI'ye göre doğrulamak
  • Yeniden denemeleri, kuyrukları, günlükleri ve dağıtımı kendiniz yönetmek
API dokümantasyonunu açın

JSON-RPC 2.0 · Streamable HTTP

Bir yapay zekâ ajanına kontrollü erişim verin

Cursor, Claude, VS Code, Cline, n8n veya başka bir MCP istemcisini FineProxy sunucusuna bağlayın. Ajan, API anahtarının kapsamlarınca izin verilen araçlara erişir.

Bir ajanın şunları yapmasını istediğinizde en uygunudur:
  • Envanteri, hizmetleri, kullanımı ve destek geçmişini incelemek
  • Onaylanmış hizmet işlemleri için fiyat teklifi almak ve bunları gerçekleştirmek
  • Arızaları teşhis etmek ve önerilen değişiklikleri açıklamak
Kontrol panelinde MCP kurulumunu açın

Geçişten önce mevcut bir entegrasyonu denetleyin

Bir Markdown dosyası indirin, deponuzla birlikte bir kodlama ajanına ekleyin ve hazırlanmış denetim istemini çalıştırın. İlk inceleme salt okunurdur: uyumluluğu, gerekli adaptörleri, engelleri ve değiştirilmesi gereken kodu tam olarak belirler.

Salt okunur geçiş denetimi istemi
Ekli FineProxy Agent Pack'i okuyun ve bu depoyu inceleyin.

İlk incelemede kodu değiştirmeyin.

Mevcut proxy sağlayıcısının yapılandırıldığı veya çağrıldığı her yeri bulun. Her iş akışını belgelenmiş FineProxy yetenekleriyle karşılaştırın. Şunları raporlayın:
1. Tam uyumlu iş akışları.
2. Adaptör veya veri dönüşümü gerektiren iş akışları.
3. Desteklenmeyen veya belirsiz davranışlar.
4. Gerekli FineProxy API izinleri.
5. Değişecek dosyalar ve kod yolları.
6. Kimlik doğrulama ve secret saklama değişiklikleri.
7. Geri alma seçeneği içeren aşamalı geçiş planı.
8. Geçişten önce gereken entegrasyon testleri.

Uç noktalar uydurmayın. Agent Pack veya güncel OpenAPI spesifikasyonu tarafından doğrulanmayan her şeyi soru olarak işaretleyin.

Denetimde doğrulanması gerekenler

  1. 01Mevcut sağlayıcının nerede başlatıldığı ve çağrıldığı
  2. 02Kimlik doğrulama ve secret saklama farklılıkları
  3. 03Hizmet satın alma, yenileme, iptal ve IP güncelleme akışları
  4. 04Proxy listesi biçimleri, protokoller, bağlantı noktaları ve yetkilendirme yöntemleri
  5. 05Ülke seçimi, izin verilen IP listeleri ve bağlantı limitleri
  6. 06Sayfalama, yeniden denemeler, idempotency, hatalar ve hız limiti yönetimi
  7. 07Faturalandırma, kullanım analitiği, destek ve webhook bağımlılıkları
  8. 08Kodu değiştirmeden dosya bazında geçiş ve test planı

Uç nokta düzeyinde uygulama için, ajana kontrol panelinizden indirdiğiniz güncel OpenAPI dosyasını da verin. Agent Pack bilinçli olarak hiçbir kimlik bilgisi veya özel hesap verisi içermez.

Neleri otomatikleştirebilirsiniz

Herkese açık katman, her uç noktayı tekrarlamak yerine eksiksiz iş akışlarını açıklar. Tek tek istekleri uygularken güncel OpenAPI spesifikasyonunu kullanın.

01

Satın alma ve sağlama

Güncel stokları keşfedin, ülkelere göre kesin bir dağılım hesaplayın ve kontrol paneli cüzdanından sipariş verin.

  • Mevcut ülkeleri ve güncel IP envanterini listeleyin
  • Fon harcamadan çok ülkeli bir paket için fiyat teklifi alın
  • Fiyat koruması ve idempotency anahtarıyla satın alın
02

Hizmet yönetimi

Plan talep edilen işlemi desteklediğinde, destek talebi beklemeden etkin hizmetleri yönetin.

  • Hizmetleri yenileyin, askıya alın, geri yükleyin veya iptal edin
  • IP'leri değiştirin veya ekleyin ve kimlik bilgilerini güncelleyin
  • Otomatik yenilemeyi, izin verilen IP listelerini ve bağlantı eklentilerini yönetin
03

Analitik ve tanılama

Yükü, güvenilirliği ve hedef davranışını araştırmak için hesap ve hizmet telemetrisini kullanın.

  • Kullanıma genel bakış verilerini ve zaman serilerini okuyun
  • En sık erişilen hedefleri ve hata kategorilerini inceleyin
  • Tanılama ve operasyonel öneriler alın
04

Faturalandırma ve destek

Proxy işlemlerini bunları çevreleyen finans ve destek iş akışlarına bağlayın.

  • Faturaları okuyun ve fatura PDF'lerini indirin
  • Cüzdan yatırma işlemi başlatın ve durumunu kontrol edin
  • Destek talepleri oluşturun, okuyun, yanıtlayın ve kapatın
05

Proxy erişimi

Uygulamaların satın alınan proxy'ler üzerinden bağlanmak için ihtiyaç duyduğu ayarları alın.

  • Dönen proxy bağlantı yapılandırmasını okuyun
  • Hizmet kullanıcı adını ve şifresini değiştirin
  • İzin verilen IP listesinde IP başına bağlantı limitlerini yönetin
06

Olaylar ve hesap

Harici sistemleri senkronize tutun ve güvenlikle ilgili hesap bilgilerini inceleyin.

  • Webhook'ları ve teslimat işlemlerini yapılandırın
  • Profil verilerini, çağıranın IP'sini ve giriş geçmişini okuyun
  • Dar kapsamlı izinlerle API anahtarlarını yönetin

Platformun yapmayacağı işlemler

FineProxy otomasyonu bilinçli olarak sınırlandırılmıştır. Erişim; anahtar, hizmet planı, güncel envanter ve açık güvenlik kontrolleri tarafından belirlenir.

Verilen kapsamların dışında erişim yok

API anahtarı gerekli izni içermiyorsa bir araç veya uç nokta kaynağı okuyamaz ya da değiştiremez.

wallet:spend olmadan harcama yok

Finansal kapsam mevcut değilse satın alma, yenileme ve ücretli IP güncelleme işlemleri kullanılamaz.

Sessizce gerçekleştirilen yıkıcı işlem yok

Geri alınamaz işlemler açık bir onay bayrağı gerektirir. Bunlar bir okuma isteğinin yan etkisi olarak gerçekleşemez.

MCP üzerinden kaynak koduna erişim yok

FineProxy MCP müşteri hesabını yönetir. Bir script'i denetlemek için kodlama ajanınıza ayrıca o script'e veya depoya erişim verilmelidir.

Desteklenmeyen envanter garantisi yok

Ülke kullanılabilirliği ve adetler güncel stoklara göre kontrol edilir. Otomasyon, mevcut olmayan envanteri sipariş edemez.

Etkin olmayan iş ortakları için iş ortağı API'si yok

İş ortağı spesifikasyonu ve raporlama uç noktaları yalnızca hesap etkin iş ortağı statüsüne sahipse gösterilir.

Bir ajanı dakikalar içinde bağlayın

Kontrol panelinde bu iş için ayrı bir API anahtarı oluşturun, yalnızca ajanın ihtiyaç duyduğu kapsamları seçin ve MCP yapılandırmasını istemcinize ekleyin. Gerçek anahtarı bir secret veya ortam değişkeninde saklayın.

mcp.json
{
  "mcpServers": {
    "fineproxy": {
      "url": "https://fineproxy.org/account_new/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer fb_YOUR_API_KEY"
      }
    }
  }
}

OpenAPI 3.1

Uygulama için güncel spesifikasyonu kullanın

Kontrol paneli; özenle hazırlanmış OpenAPI 3.1 istemci spesifikasyonunu, istek örneklerini, yanıt şemalarını ve oluşturulan istemci kod parçacıklarını görüntüler. Etkin iş ortakları ayrıca ayrı bir iş ortağı spesifikasyonuna erişir.

Etkileşimli API referansını görüntüleyin

İşe yarayan en küçük izin kümesini seçin

Okuma ve yazma erişimi ayrıdır. Keşif ve geçiş denetimleri için salt okunur kapsamlarla başlayın; ardından yalnızca ihtiyaç duyan iş akışına yazma veya finansal erişim ekleyin.

customer:read

Müşteri profilini ve hesap bilgilerini okuyun.

customer:write

Müşteri bilgilerini güncelleyin.

wallet:read

Cüzdan bakiyesini ve cüzdan verilerini görüntüleyin.

wallet:deposit

Cüzdan yatırma işlemleri oluşturun ve izleyin.

wallet:spend

Otomasyonun cüzdan bakiyesini harcamasına izin verin.

services:read

Hizmetleri, proxy ayarlarını ve hizmet durumunu görüntüleyin.

services:write

Hizmetleri ve eklentileri oluşturun veya değiştirin.

tickets:read

Destek taleplerini ve mesajlarını okuyun.

tickets:write

Destek talepleri oluşturun, yanıtlayın, güncelleyin veya kapatın.

catalog:read

Ürünleri, seçenekleri, ülkeleri ve güncel stokları okuyun.

usage:read

Hizmet kullanımını ve tanılama analizlerini okuyun.

webhooks

Webhook abonelikleri oluşturun ve yönetin.

Korunması gereken varsayılan güvenlik ayarları

  • Her uygulama veya ajan için ayrı bir API anahtarı oluşturun; böylece her biri bağımsız olarak iptal edilebilir.
  • Denetime salt okunur kapsamlarla başlayın. services:write veya wallet:spend kapsamını ancak önerilen planı inceledikten sonra ekleyin.
  • Anahtarları ortam değişkenlerinde veya bir secret yöneticisinde saklayın; kaynak koduna, istemlere, ekran görüntülerine veya commit edilmiş MCP yapılandırmasına asla eklemeyin.
  • Satın alımlarda teklif edilen beklenen toplamı kullanın. Fiyat değişirse işlem sessizce daha fazla ücret almak yerine reddedilir.
  • Zaman aşımına uğrayan finansal bir isteği yeniden denerken aynı idempotency anahtarını kullanın; böylece aynı işlem için iki kez ücret alınamaz.
  • Olayları kritik bir iş akışına dahil etmeden önce webhook imzalarını ve teslimat geçmişini inceleyin.

Önce görünürlük sağlayın, ardından kontrol verin

Salt okunur bir denetim, finansal erişim veya yazma erişimi vermeden geçişin mümkün olup olmadığını gösterir. Plan onaylandıktan sonra dar kapsamlı bir üretim anahtarı oluşturun ve güncel OpenAPI spesifikasyonuna göre uygulayın.