MPP Hızlı Başlangıç

Tempo USDC ve mppx istemcisi ile TwexAPI gelişmiş arama sayfası için ödeme yapın.

MPP Hızlı Başlangıç

TwexAPI API anahtarı olmadan kullanım başına gelişmiş arama isteği yapın. Bu kılavuz HTTP 402 zorlamasını yanıtlamak, Tempo USDC ile ödemek ve isteği otomatik yeniden denemek için mppx istemcisini kullanır.

Adım 1: İstemci bağımlılıklarını kurun

npm install mppx viem

mppx MPP zorlamalarını ve ödemelerini yönetir. viem Tempo özel anahtarını istemcinin kullandığı cüzdan hesabına dönüştürür.

Adım 2: Tempo cüzdanı oluşturun ve fonlayın

Yerel bir MPP hesabı oluşturun, ardından özel anahtarını dışa aktarın:

mppx account create
mppx account export

Yazdırılan adresi Tempo üzerinde USDC ile fonlayın. Dışa aktarılan 0x... özel anahtarını ortam değişkeninde saklayın:

export TEMPO_PRIVATE_KEY="0x..."

Adım 3: MPP isteği yapın

mpp-search.ts oluşturun:

import { Mppx, tempo } from "mppx/client";
import { privateKeyToAccount } from "viem/accounts";

Mppx.create({
  methods: [
    tempo({
      account: privateKeyToAccount(
        process.env.TEMPO_PRIVATE_KEY as `0x${string}`,
      ),
    }),
  ],
});

const response = await fetch(
  "https://api.twexapi.io/twitter/advanced_search/page",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      searchTerms: ["openai"],
      sortBy: "Latest",
    }),
  },
);

if (!response.ok) {
  throw new Error(`TwexAPI request failed: ${response.status}`);
}

console.log(await response.json());

Mppx.create() fetch’i MPP 402 Payment Required zorlamasını işleyecek şekilde yapılandırır. Uygun bir uç nokta için sunucunun sağladığı Tempo teklifini öder ve aynı isteği ödeme kimlik bilgisiyle yeniden dener. Yerleşimi kaydetmeniz gerekiyorsa response.headers.get("Payment-Receipt") değerini inceleyin.

Önceki sayfadan devam ederken JSON gövdesine next_cursor iletin:

{
  "searchTerms": ["openai"],
  "sortBy": "Latest",
  "next_cursor": "cursor-from-the-previous-response"
}

Adım 4: Ham HTTP akışını uygulayın

mppx olmadan önce arama sayfasını normal isteyin:

curl -i --request POST 'https://api.twexapi.io/twitter/advanced_search/page' \
  --header 'Content-Type: application/json' \
  --data '{"searchTerms":["openai"],"sortBy":"Latest"}'

402 durumunda WWW-Authenticate: Payment zorlamasını uyumlu bir Tempo MPP uygulamasıyla işleyin. Ardından oluşturulan kimlik bilgisiyle tam isteği yeniden deneyin:

curl -i --request POST 'https://api.twexapi.io/twitter/advanced_search/page' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Payment eyJjaGFsbGVuZ2UiOnsi...' \
  --data '{"searchTerms":["openai"],"sortBy":"Latest"}'

Başarılı yanıt TwexAPI’nin olağan JSON zarfını ve Payment-Receipt yanıt başlığını içerir. Uygulamanız mutabakat gerektiriyorsa makbuzları kendi istek kayıtlarınızla birlikte saklayın.

Sonraki adımlar

• Machine Payments Protocol — desteklenen işlem, ödeme sırası ve API anahtarı karşılaştırmasını inceleyin.
• API overview — API anahtarı kimlik doğrulamasına ve tam uç nokta kataloğuna göz atın.