API para Agentes IA (x402)

Acceso programático a la base de datos legal panameña, el analizador de WhatsApp y el analizador de contratos. Pago en USDC en la red Base — sin suscripciones, sin fricción.

Base URL https://www.juridicapanama.com/api/v1

Cómo funciona x402

1

El agente envía USDC en la red Base a la dirección de la plataforma.

2

El agente llama a POST /api/v1/claim con el hash de la transacción.

3

La plataforma verifica el pago en blockchain y devuelve una API key con saldo.

4

El agente usa la key en el header Authorization: Bearer <key>.

5

Cada llamada descuenta el costo correspondiente del saldo automáticamente.

Precios por endpoint

Endpoint	Método	Precio (USDC)
/api/v1/status	GET	Gratis
/api/v1/claim	POST	Gratis
/api/v1/search	GET	$0.01 / consulta
/api/v1/analyze/quote	POST	Gratis
/api/v1/analyze	POST	$0.10 base + $0.02/min audio
/api/v1/contract/quote	POST	Gratis
/api/v1/contract	POST	$0.10 base + $0.02/página

Endpoints

POST /api/v1/claim Gratis

Intercambia un hash de transacción por una API key con saldo.

curl -X POST https://www.juridicapanama.com/api/v1/claim \
-H "Content-Type: application/json" \
-d '{"tx_hash": "0xTU_HASH"}'

GET /api/v1/search?q=<query> $0.01 USDC

Busca en la base de datos legal panameña. Devuelve hasta 5 artículos relevantes con texto completo.

curl "https://www.juridicapanama.com/api/v1/search?q=requisitos+divorcio" \
-H "Authorization: Bearer sk_abc123..."

POST /api/v1/analyze $0.10 base + $0.02/min audio

Sube un .zip exportado de WhatsApp. Transcribe audios y genera un reporte forense completo. El costo se calcula según la duración total del audio — llama a /analyze/quote primero para obtener el precio exacto.

curl -X POST https://www.juridicapanama.com/api/v1/analyze \
-H "Authorization: Bearer sk_abc123..." \
-F "file=@/path/to/whatsapp_export.zip"

POST /api/v1/contract/quote Gratis

Obtén el precio exacto antes de analizar. Envía el contrato (PDF o DOCX) y recibe el número de páginas detectadas y el costo en USDC — sin realizar ningún pago.

curl -X POST https://www.juridicapanama.com/api/v1/contract/quote \
-F "file=@/path/to/contract.pdf"

{
  "quote": {
    "page_count": 12,
    "file_type": "pdf",
    "cost_usdc": 0.34,
    "note": "Call POST /api/v1/contract with this file and sufficient balance."
  }
}

POST /api/v1/contract $0.10 base + $0.02/página

Analiza un contrato PDF o DOCX. Devuelve un reporte JSON estructurado con puntaje de riesgo, cláusulas problemáticas clasificadas por severidad y consejos de negociación.

curl -X POST https://www.juridicapanama.com/api/v1/contract \
-H "Authorization: Bearer sk_abc123..." \
-F "file=@/path/to/contract.pdf"

{
  "meta": { "page_count": 12, "file_type": "pdf", "cost_usdc": 0.34 },
  "report": {
    "risk_score": 7,
    "risk_label": "Alto",
    "summary": "Contrato de servicios con cláusulas...",
    "clauses": [ ... ],
    "key_advice": [ ... ]
  }
}

Códigos de respuesta

200 Éxito

400 Parámetro faltante o inválido

402 Saldo insuficiente o key inválida

409 El tx_hash ya fue reclamado

422 Archivo no pudo ser procesado

500 Error interno del servidor

🤝

¿Necesitas ayuda con la integración?

Escríbenos a soporte@juridicapanama.com o por WhatsApp.