Ana içeriğe atla

Önce teklif, sonra max_price_trx ile satın alma

Bağlı bir uygulama buy_energy ve buy_bandwidth çağrılarına max_price_trx göndermek zorundadır. Bu olmadan çağrı MAX_PRICE_REQUIRED ile başarısız olur — günlük limitin bir çağrının en fazla ne kadar tutabileceğini bilmesi gerekir.
  1. Hacim ve süreyle quote_energy (veya quote_bandwidth) çağırın.
  2. Kullanıcıya tekliften gelen total_trx değerini gösterin.
  3. Aynı hacim ve süreyle, max_price_trx = teklifin total_trx değeri olacak şekilde buy_energy çağırın.
Fiyat max_price_trx üzerine çıkarsa satın alma PRICE_CHANGED ile reddedilir ve ücret alınmaz. Yeniden teklif alın ve kullanıcıya sorun. API anahtarı için max_price_trx isteğe bağlıdır, ancak aynı nedenle kullanmanızı öneririz.

Idempotency anahtarları

Bir şey oluşturan araçlar idempotency_key alır — rotalarının Idempotency-Key başlığı. Her yeni işlem için yeni bir UUID üretin ve zaman aşımı veya kaybolan bir yanıttan sonra aynı işlemi tekrar denerken aynısını kullanın: sunucu yeniden ücret almak yerine ilk sonucu döndürür. Bir anahtar 24 saat geçerlidir ve en fazla 64 karakterdir. Aynı anahtar farklı bir istekle kullanılırsa IDEMPOTENCY_KEY_REUSED ile reddedilir; ilk isteği hâlâ işlenen bir anahtar IDEMPOTENT_REQUEST_IN_PROGRESS döndürür — bekleyin ve aynı anahtarla tekrar deneyin.

Günlük harcama limiti

Her bağlantı herhangi bir 24 saatte belirli bir tutar harcayabilir — kullanıcı onay ekranında veya Bağlı uygulamalar bölümünde başka bir tutar seçmediyse 100 TRX. Limiti yalnızca hesap sahibi kaldırabilir.
  • Harcama yapan bir çağrıdan önce sunucu, çağrının tutabileceği en yüksek tutarı ayırır: satın almalarda max_price_trx artı yeni bir adresin aktivasyonu; Smart Mode, paketler, aktivasyonlar ve Node API planlarında fiyat; stake işleminde tutar.
  • Çağrıdan sonra ayrılan tutar gerçek tutara dönüşür veya ücret alınmadıysa serbest bırakılır. Sonuç bilinmiyorsa (zaman aşımı), ayrılan tutar 24 saat kalır — limit şüphede reddetmeyi tercih eder.
  • Kendi kendine çalışan harcamalar (recurring) limitin dışındadır.
  • Paneldeki Bağlı uygulamalar her uygulamanın son 24 saatte ne harcadığını gösterir.
Sığmayan bir çağrı AGENT_SPEND_CAP ile başarısız olur:
Yanıtı kaybolan bir satın almayı tekrar denemek tutarını yeniden ayırır. Limite yakınken tekrar denemeden önce list_orders kontrol edin: ilk çağrı gerçekleşmiş olabilir.

Sipariş kaynağı

Bağlı bir uygulamanın verdiği siparişler "source": "agent" taşır — get_order, list_orders ve order.updated webhook’unda. API anahtarıyla verilen siparişler "source": "api" taşır.

Hata kodları

MCP üzerinden hata, isError: true taşıyan bir araç sonucu olarak gelir:
REST üzerinden aynı kod standart hata biçiminde gelir. Diğer tüm kodlar REST API’nin kodlarıdır — bkz. Hatalar. Süresi dolmuş veya iptal edilmiş bir belirteç, /mcp isteğinin kendisinde WWW-Authenticate: Bearer ... error="invalid_token" ile HTTP 401 alır; MCP istemcileri bu durumda belirteci yeniler veya kullanıcıdan yeniden giriş yapmasını ister.