Introducción a la API

Documentación completa de pan API v1

Bienvenido a la referencia de pan API. Esta documentación describe todos los endpoints disponibles, formatos de request/response, códigos de error, y métodos de autenticación.

URL Base

Todas las requests deben hacerse a:

https://api.pan.tech/v1

Entorno de staging: Para pruebas, usa https://api-staging.pan.tech/v1. Staging usa solo testnets y está aislado de produccion.

Autenticación

Todos los endpoints requieren autenticación usando una API key. Incluye tu API key en el header Authorization:

Authorization: Bearer pan_sk_tu_api_key

Manten tu API key secreta. Nunca la expongas en código del lado del cliente o repositorios publicos. Ver guia de autenticación.

Versionado

pan API usa versionado basado en URL. La version actual es v1, incluida en la URL base. Versiones futuras usaran paths diferentes (ej. /v2/) para mantener compatibilidad hacia atras.

Formato de Requests

Todas las requests deben usar:

• Metodo: Métodos HTTP (GET, POST, etc.)
• Content-Type: application/json para bodies
• Encoding: UTF-8

Formato de Respuestas

Todas las respuestas retornan JSON:

Respuestas exitosas

Respuestas exitosas (codigos 2xx) retornan el recurso directamente:

{
  "id": "pan_wallet_abc123",
  "userId": "usuario_123",
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  ...
}

Respuestas de error

Respuestas de error (codigos 4xx, 5xx) retornan un objeto error:

{
  "error": "ERROR_CODE",
  "message": "Mensaje legible para humanos",
  "details": {
    "campo": "valor"
  }
}

Códigos HTTP

pan API usa códigos HTTP estandar:

Código	Significado	Descripción
200	OK	Request exitoso
201	Created	Recurso creado
400	Bad Request	Request inválido
401	Unauthorized	API key faltante o inválida
403	Forbidden	Límite de recursos excedido
404	Not Found	Recurso no existe
429	Too Many Requests	Rate limit excedido
500	Internal Server Error	Error del servidor
503	Service Unavailable	Servicio temporalmente no disponible

Resumen de Endpoints

Wallets

Método	Endpoint	Descripción
POST	/wallets	Crear wallet
GET	/wallets/:userId	Obtener wallet por userId
GET	/balances/:walletId	Obtener balances

Intents

Método	Endpoint	Descripción
POST	/intents	Crear intent
GET	/intents/:intentId	Obtener estado de intent

Yields

Método	Endpoint	Descripción
GET	/yields	Obtener APYs disponibles

Demo

Método	Endpoint	Descripción
POST	/demo/fund	Fondear wallet de prueba

Rate Limits

Los rate limits dependen de tu plan de suscripción:

Plan	Requests por minuto	Wallets maximas
Free	100	100
Pro	1,000	10,000
Enterprise	Custom	Ilimitadas

Cuando excedes el rate limit, recibiras un 429 Too Many Requests:

Retry-After: 60
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1642248000

Créditos

Cada request consume créditos de tu cuenta:

Endpoint	Créditos
POST /wallets	1
GET /wallets/:id	1
GET /balances/:id	1
GET /yields	1
POST /intents	5
GET /intents/:id	1

SDKs Oficiales

SDK JavaScript/TypeScript

SDK oficial con soporte TypeScript completo

Python SDK

SDK oficial con soporte async

Los SDKs son opcionales. Puedes usar cualquier cliente HTTP para interactuar con pan API. Todos los endpoints son REST estandar.

Soporte

Email

[e-mail]