Machine Payments Protocol (MPP)

HTTP 402, Tempo USDC ve ödeme makbuzları ile kullanım başına TwexAPI istekleri yapın.

Machine Payments Protocol (MPP)

TwexAPI, seçili kullanım başına istekler için Machine Payments Protocol (MPP) destekler. Bir MPP istemcisi, TwexAPI API anahtarı göndermek yerine uygun bir isteği Tempo USDC ile ödeyebilir.

MPP; agent’lar, betikler ve yalnızca yaptıkları istekler için ödeme yapması gereken servisler için uygundur. Aşağıda listelenmeyen uç noktalarda API anahtarı kimlik doğrulamasının yerini almaz.

Desteklenen işlem

İşlem	Ne yapar	Ödeme yöntemi	Fiyat
`POST /twitter/advanced_search/page`	Gelişmiş Twitter aramasının imleç tabanlı bir sayfasını döndürür.	Tempo USDC	Sayfa başına USD 0,0001

Sunucu güncel ödeme teklifinin otoritesidir. Tutarı, alıcıyı veya ödeme kimlik bilgisi formatını sabitlemek yerine istek için dönen WWW-Authenticate: Payment zorlamasını okuyun.

Ödeme nasıl çalışır

API anahtarı olmadan MPP etkin bir uç noktaya normal istek gönderin.
Sunucu 402 Payment Required ve WWW-Authenticate: Payment zorlamasıyla yanıt verir.
MPP istemciniz zorlamada açıklanan Tempo USDC isteğini öder ve Authorization: Payment kimlik bilgisiyle yeniden dener.
Yerleşmiş yanıtta Payment-Receipt başlığı bulunur. HTTP durumunu ve yanıt gövdesini birlikte kontrol edin; makbuz yalnızca ödemenin yerleştiğini doğrular.

Ödeme zorlaması

HTTP/2 402 Payment Required
WWW-Authenticate: Payment id="abc...", realm="api.twexapi.io", method="tempo", intent="charge", request="eyJhbW91bnQiOi..."

Zorlamadaki request değeri güncel ödeme talimatını içerir. MPP istemcisi için opak veri olarak ele alın; önbelleğe alınmış bir örnekten ödeme oluşturmayın veya ayrıştırmayın.

Ücretli yeniden deneme ve makbuz

POST /twitter/advanced_search/page HTTP/2
Host: api.twexapi.io
Authorization: Payment eyJjaGFsbGVuZ2UiOnsi...
Content-Type: application/json

{"searchTerms":["openai"],"sortBy":"Latest"}

HTTP/2 200 OK
Payment-Receipt: eyJzdGF0dXMiOiJzdWNjZXNzIiwi...
Content-Type: application/json

MPP ve API anahtarları

Seçim	Ne zaman uygun
MPP	Desteklenen bir işlem için anonim, kullanım başına istek gerekiyorsa.
API anahtarı	TwexAPI yüzeyinin tamamına, hesap düzeyinde kredilere veya MPP teklifi yayınlamayan uç noktalara erişim gerekiyorsa.

MPP ödemeleri USDC ile fonlanmış bir Tempo cüzdanı kullanır. Cüzdan özel anahtarını ortam değişkeninde tutun; kaynak denetimine, günlüklere veya sohbet transkriptlerine asla commit etmeyin.

Sonraki adımlar

MPP quickstart — istemciyi kurun, Tempo cüzdanını yapılandırın ve ücretli arama isteği yapın.
API overview — API anahtarı kimlik doğrulamasını kullanın ve daha geniş TwexAPI uç nokta kataloğuna göz atın.