REST API · Red de prueba
De la intención a la evidencia.
Conéctate a la API gratuita de Testnet. Mantén tu integración de pagos actual; no necesitas SDK.
Obtenga una clave API
curl -X POST https://agenttrail.online/api/v1/accounts \
-H 'Content-Type: application/json' -d '{}'La respuesta contiene account_id, key_id y un api_key único. Guárdalo de forma segura. La creación de cuentas y la emisión de nuevas claves crean credenciales nuevas en cada llamada exitosa; no son puntos finales de reproducción. Este servicio de desarrollo no puede recuperar las claves perdidas. Emita claves de agente con ámbito desde la consola.
1. Registre el pago esperado
export AUDIT_KEY='<save the one-time API key securely>'
curl -X POST https://agenttrail.online/api/v1/audit/intents \
-H "Authorization: Bearer $AUDIT_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: your-stable-intent-reference' \
-d '{"agent_id":"research-01","network":"xrpl-testnet", "asset":{"type":"native","currency":"XRP"},"expected_amount":"1","recipient":"<recipient classic address>","purpose":"purchase_market_data"}'Las cantidades son cadenas decimales. Testnet y Mainnet no se pueden mezclar. El Propósito y la identidad del Agente son declaraciones, no prueba de autorización. El payer_address opcional permite la coincidencia de remitentes; sin él, no se verifica la coincidencia del pagador. Utilice context_hash para contextos de tareas confidenciales.
2. Pague externamente y luego envíe el hash.
Su propio código de pago Testnet envía el pago. Nunca envíe al servicio una semilla de billetera o una clave privada.
curl -X POST https://agenttrail.online/api/v1/audit/transactions \
-H "Authorization: Bearer $AUDIT_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: your-stable-payment-reference' \
-d '{"audit_id":"<audit_id>","network":"xrpl-testnet","tx_hash":"<64-character hash>"}'Una respuesta 202 significa que la verificación está pendiente. Vuelva a intentar escribir auditorías con el mismo Idempotency-Key y el mismo cuerpo de solicitud después de errores de transporte. Reutilizar una clave con un cuerpo diferente devuelve 409.
3. Consulta el estado, descarga y verifica
curl -H "Authorization: Bearer $AUDIT_KEY" \ https://agenttrail.online/api/v1/audit/records/<audit_id> curl -H "Authorization: Bearer $AUDIT_KEY" \ https://agenttrail.online/api/v1/audit/records/<audit_id>/report -o audit.json
El estado de pago y el estado de anclaje son independientes. Sólo anchor_validated establece un anclaje completo. Es posible que los informes descargados estén pendientes; En ese caso, la verificación independiente debe fallar claramente. Utilice la página Verificar localmente o ejecute scripts/verify_report.py desde el repositorio.
Errores y límites de soporte.
400: entrada no válida, red incorrecta o emisor deshabilitado. 401: clave no válida/revocada. 403: alcance insuficiente. 404: registro ausente o inaccesible. 409: idempotencia/conflicto de transacción o informe no listo. 413: cuerpo demasiado grande. 429: cuota excedida, vuelva a intentarlo más tarde. 503: almacenamiento/proveedor no disponible; Vuelva a intentarlo de forma segura.
Interpretación de pagos admitida: XRP directo y activos RLUSD habilitados. Los pagos parciales exitosos utilizan metadatos entregados, nunca la Cantidad solicitada. No se admiten rutas complejas, conversiones ni transacciones sin pago. Los tiempos de espera de los nodos permanecen pendientes y pueden requerir la recuperación del operador de la cola de mensajes fallidos.
Límites de prueba y privacidad
Los informes y declaraciones son privados para su cuenta. Las pruebas públicas exponen hashes e información mínima de lote/red. Un ancla demuestra la integridad de un registro suministrado, no sus reclamaciones, entrega o cobertura de cada pago. El anclaje de la plataforma utiliza un firmante Testnet restringido dedicado, presupuestos explícitos y un paso de habilitación del operador.