Call x402 Endpoint
Call an x402 pay-per-use API endpoint. Payment is handled automatically using your connected wallet — no manual steps needed.
Action intégrée X402 portefeuille
Appeler un endpoint API x402 à paiement à l'utilisation. Le paiement est géré automatiquement à l'aide de votre portefeuille connecté — aucune étape manuelle n'est nécessaire.
Cette action peut nécessiter un connecteur de portefeuille, du gaz, un mouvement de jetons ou un effet secondaire externe. Testez avec une simulation ou un montant contrôlé avant de l'utiliser dans un workflow en production.
Au premier coup d'œil
| Champ | Valeur |
|---|---|
| Identifiant d'action | call-x402-endpoint |
| Catégorie | X402 |
| Connecteur | wallet |
| Nécessite du gaz | Non |
| Mouvement de fonds | Aucun déclaré |
| Balises | x402, payment, api, pay-per-call |
Schéma de charge utile
| Champ | Type | Requis | Description |
|---|---|---|---|
endpointId | string | Oui | L'ID de l'endpoint x402 à appeler (provenant du registre des endpoints) |
maxPrice | string | Non | Remplacement optionnel pour le prix maximum autorisé (dans l'unité la plus petite du jeton). Si non spécifié, utilise le prix maximum par défaut de l'endpoint. |
Schéma de résultat
| Champ | Type | Requis | Description |
|---|---|---|---|
status | string | Oui | Indique si la requête a réussi ou a échoué |
statusCode | number | Non | Code de statut HTTP de la réponse |
resource | object | Non | Les données de la ressource récupérée (réponse JSON parsée de l'endpoint). Accédez aux champs imbriqués avec {{nodeId.result.resource.fieldName}} |
paymentDetails | object | Non | Détails de la transaction de paiement |
requestDetails | object | Non | Détails de la requête effectuée |
responseHeaders | object | Non | En-têtes de réponse du serveur de ressource |
error | string | Non | Message d'erreur en cas d'échec |
Exemples
json{ "type": "call-x402-endpoint", "payload": { "endpointId": "x402_abc123" }, "children": [], "connector": { "type": "wallet", "id": "conn_wallet" }}
bashcurl -X POST "https://api.b3os.org/v1/actions/call-x402-endpoint/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "endpointId": "x402_abc123" }}'
Les champs de charge utile peuvent utiliser des expressions de workflow telles que {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, et {{$props.asset}} lorsque la valeur doit provenir d'un déclencheur, d'un nœud précédent ou d'une propriété de workflow réutilisable.