Machine Payments Protocol (MPP)

Realiza solicitudes pay-per-use de TwexAPI con HTTP 402, Tempo USDC y recibos de pago.

Machine Payments Protocol (MPP)

TwexAPI soporta el Machine Payments Protocol (MPP) para solicitudes pay-per-use seleccionadas. Un cliente MPP puede pagar una solicitud elegible con Tempo USDC en lugar de enviar una API key de TwexAPI.

MPP es útil para agentes, scripts y servicios que necesitan pagar solo por las solicitudes que hacen. No reemplaza la autenticación con API key en endpoints que no están listados abajo.

Operación soportada

Operación	Qué hace	Método de pago	Precio
`POST /twitter/advanced_search/page`	Devuelve una página basada en cursor de resultados avanzados de búsqueda de Twitter.	Tempo USDC	USD 0.0001 por página

El servidor sigue siendo la autoridad para la oferta de pago actual. Lee el desafío WWW-Authenticate: Payment devuelto para una solicitud en lugar de codificar en duro un monto, destinatario o formato de credencial de pago.

Cómo funciona el pago

Envía una solicitud normal a un endpoint habilitado para MPP sin API key.
El servidor responde con 402 Payment Required y un desafío WWW-Authenticate: Payment.
Tu cliente MPP paga la solicitud Tempo USDC descrita por ese desafío y reintenta con una credencial Authorization: Payment.
Una respuesta liquidada incluye un header Payment-Receipt. Verifica tanto el estado HTTP como el cuerpo de respuesta; un recibo solo confirma que el pago fue liquidado.

Desafío de pago

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

El valor request del desafío contiene la instrucción de pago actual. Trátalo como datos opacos para el cliente MPP; no analices ni construyas un pago desde un ejemplo en caché.

Reintento pagado y recibo

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 y API keys

Elige	Cuándo encaja
MPP	Necesitas una solicitud anónima pay-per-use a una operación soportada.
API key	Necesitas acceso a la superficie completa de TwexAPI, créditos a nivel de cuenta o endpoints que no publican una oferta MPP.

Los pagos MPP usan una wallet Tempo financiada con USDC. Mantén la clave privada de la wallet en una variable de entorno y nunca la hagas commit en control de código fuente, logs o transcripciones de chat.

Próximos pasos

MPP quickstart — instala el cliente, configura una wallet Tempo y realiza una solicitud de búsqueda pagada.
API overview — usa autenticación con API key y explora el catálogo más amplio de endpoints de TwexAPI.