Bienvenido a CryptoBot Python
CryptoBot Python es una biblioteca cliente no oficial y amigable para la API de Crypto Bot. Proporciona modelos tipados y clientes síncronos/asíncronos para facturas, transferencias, checks, saldos, tasas de cambio, estadísticas y manejo de webhooks.
Características Destacadas
Cliente de API síncrono construido sobre
httpxCliente de API asíncrono construido sobre
httpxModelos de respuesta dataclass (
Invoice,Transfer,Check,Balance,ExchangeRate,Currency,AppStats)Seguridad basada en Enum para activos, estados, estados de checks y nombres de botones
Soporte de mainnet/testnet con timeout y reintentos configurables
Iteradores de paginación para facturas, transferencias y checks
Listener de webhook FastAPI con verificación de firma y protección opcional contra repetición
Errores de API estructurados a través de
CryptoBotError(code,name)
Ejemplo Rápido
import os
from cryptobot import CryptoBotClient
from cryptobot.models import Asset
client = CryptoBotClient(api_token=os.environ["CRYPTOBOT_API_TOKEN"])
app = client.get_me()
print(app.name)
invoice = client.create_invoice(
asset=Asset.USDT,
amount=5.25,
description="Coffee order #42",
)
print(invoice.invoice_id, invoice.bot_invoice_url)
Contenido
Guía del Usuario
- Instalación
- Uso
- Ejemplos del Mundo Real
- Configuración Compartida
- Escáner de Facturas Asíncrono
- Checkout de Comercio Electrónico
- Flujo de Trabajo de Pagos
- Rastreador de Donaciones
- Cumplimiento de Pedidos por Webhook
- Airdrop con Checks Criptográficos
- Panel de Estadísticas de la Aplicación
- Libro Mayor de Transferencias
- Prueba Rápida de Testnet
- Próximos Pasos
Guías de Producción
- Temas Avanzados
- Guía de Seguridad de Webhooks
- Modelo de Amenazas
- Verificación de Firma
- Recomendado: Usar
Listener - Verificación Manual (Aplicación FastAPI Personalizada)
- Protección contra Repetición
- Endurecimiento del Despliegue
- Ejemplo de Proxy Reverso (Nginx)
- Procesamiento Basado en Cola
- Pruebas Locales
- Prueba de Firma con Pytest
- Lista de Verificación de Seguridad
- Referencias
- Guía de Solución de Problemas
- Errores de Autenticación
- Discrepancia entre Mainnet y Testnet
- Fallos de Validación de Monto
- El Estado de la Factura No se Actualiza
- Problemas de Transferencia
- Problemas de Timeout y Conexión
- Fallos de Firma de Webhook
- Webhooks No Recibidos
- Errores de Análisis de Enum
- Errores de Límite de Tasa
- Prueba Rápida de Testnet
- Obtener Ayuda
Referencia de la API