---
title: "Machine Payments Protocol (MPP)"
description: "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)](https://mpp.dev) 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

1. API anahtarı olmadan MPP etkin bir uç noktaya normal istek gönderin.
2. Sunucu `402 Payment Required` ve `WWW-Authenticate: Payment` zorlamasıyla yanıt verir.
3. MPP istemciniz zorlamada açıklanan Tempo USDC isteğini öder ve `Authorization: Payment` kimlik bilgisiyle yeniden dener.
4. 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
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

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

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

```http
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](/mpp/quickstart) — istemciyi kurun, Tempo cüzdanını yapılandırın ve ücretli arama isteği yapın.
- [API overview](/api-reference/overview) — API anahtarı kimlik doğrulamasını kullanın ve daha geniş TwexAPI uç nokta kataloğuna göz atın.