Ö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.
- Hacim ve süreyle
quote_energy(veyaquote_bandwidth) çağırın. - Kullanıcıya tekliften gelen
total_trxdeğerini gösterin. - Aynı hacim ve süreyle,
max_price_trx= teklifintotal_trxdeğeri olacak şekildebuy_energyçağırın.
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çlaridempotency_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_trxartı 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.
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:
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.