Machine Payments Protocol (MPP)
Effectuez des requêtes TwexAPI à l'usage avec HTTP 402, Tempo USDC et reçus de paiement.
Machine Payments Protocol (MPP)
TwexAPI prend en charge le Machine Payments Protocol (MPP) pour certaines requêtes à l’usage. Un client MPP peut payer une requête éligible avec Tempo USDC au lieu d’envoyer une clé API TwexAPI.
MPP est utile pour les agents, scripts et services qui doivent payer uniquement les requêtes qu’ils effectuent. Il ne remplace pas l’authentification par clé API sur les endpoints non listés ci-dessous.
Opération prise en charge
| Opération | Description | Mode de paiement | Prix |
|---|---|---|---|
POST /twitter/advanced_search/page |
Renvoie une page de résultats de recherche Twitter avancée basée sur un curseur. | Tempo USDC | 0,0001 USD par page |
Le serveur reste l’autorité pour l’offre de paiement actuelle. Lisez le défi WWW-Authenticate: Payment renvoyé pour une requête au lieu de coder en dur un montant, un destinataire ou un format de justificatif.
Fonctionnement du paiement
- Envoyez une requête normale à un endpoint compatible MPP sans clé API.
- Le serveur répond avec
402 Payment Requiredet un défiWWW-Authenticate: Payment. - Votre client MPP paie la requête Tempo USDC décrite par ce défi et réessaie avec un justificatif
Authorization: Payment. - Une réponse réglée inclut un en-tête
Payment-Receipt. Vérifiez le statut HTTP et le corps de réponse ; un reçu confirme uniquement que le paiement a été réglé.
Défi de paiement
HTTP/2 402 Payment Required
WWW-Authenticate: Payment id="abc...", realm="api.twexapi.io", method="tempo", intent="charge", request="eyJhbW91bnQiOi..."La valeur request du défi contient l’instruction de paiement actuelle. Traitez-la comme des données opaques pour le client MPP ; ne parsez pas et ne construisez pas un paiement à partir d’un exemple mis en cache.
Nouvelle tentative payée et reçu
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/jsonMPP et clés API
| Choisir | Quand c’est adapté |
|---|---|
| MPP | Vous avez besoin d’une requête anonyme à l’usage pour une opération prise en charge. |
| Clé API | Vous avez besoin d’accéder à l’ensemble TwexAPI, aux crédits au niveau du compte ou aux endpoints qui ne publient pas d’offre MPP. |
Les paiements MPP utilisent un portefeuille Tempo approvisionné en USDC. Conservez la clé privée du portefeuille dans une variable d’environnement et ne la commitez jamais dans le code source, les journaux ou les transcriptions de chat.
Étapes suivantes
- Démarrage rapide MPP — installez le client, configurez un portefeuille Tempo et effectuez une requête de recherche payante.
- Vue d’ensemble de l’API — utilisez l’authentification par clé API et parcourez le catalogue élargi des endpoints TwexAPI.