API de Dardo
Conectar Dardo con tus propios sistemas
La API te deja conectar Dardo con tus propios sistemas: emitir tarjetas desde tu punto de venta, acreditar transacciones automáticamente, o sincronizar tu base de clientes con otro software.
La API está disponible únicamente en el plan Business. Los planes Start y Grow no la incluyen. Podés ver la comparación completa en Configuración → Plan, o en ajustes de cuenta.
Cuándo conviene usarla
No todo lo que parece necesitar API se resuelve con API. Antes de escribir código, vale la pena descartar lo que ya está hecho:
| Lo que querés | Lo resuelve |
|---|---|
| Subir tu base de clientes una vez | Importar clientes, sin código |
| Bajar tus datos para analizarlos | Exportar, sin código |
| Que te avisen cuando pasa algo en Dardo | Webhooks |
| Emitir tarjetas desde tu propio sistema | API |
| Acreditar compras desde tu punto de venta | API |
Los webhooks resuelven más casos de los que uno espera, y son mucho más simples. Si lo que necesitás es reaccionar a algo que pasa en Dardo —se instaló una tarjeta, se registró una transacción— no hace falta consultar la API: Dardo le avisa a una dirección tuya cuando ocurre. Ver Webhooks.
Cómo empezar
Todos los pedidos van a https://api.dardo.ai y se autentican con el header X-API-Key. Esta es la primera llamada, que devuelve los datos de tu cuenta:
curl "https://api.dardo.ai/api/v2/profile" \
-H "X-API-Key: TU_CLAVE_API"Si te responde, ya estás listo para el resto.
Los ejemplos de código de la referencia no incluyen el header de autenticación. Se generan automáticamente a partir de la especificación y solo muestran el cuerpo del pedido. A cada uno hay que agregarle -H "X-API-Key: TU_CLAVE_API", o vas a recibir un 401.
Autenticación
Dónde sacar tu clave, cómo usarla y qué alcance tiene
Errores
Qué significa cada código de respuesta y cómo reaccionar
Límites y paginación
Cuántos pedidos podés hacer y cómo recorrer listados largos
Clientes y tarjetas
Qué datos guarda un cliente y cómo identificarlo desde otro sistema
Tipos de tarjeta
Qué operación corresponde a cada tipo de tarjeta
Operaciones y eventos
Leer el historial de transacciones y saber qué pasó en cada una
Segmentos
Los grupos de clientes que Dardo arma solo
Estadísticas
Ingresos, retorno y valor por cliente
Punto de venta
Conectar tu sistema de cobro para acreditar compras
Webhooks
Que Dardo le avise a tu sistema cuando pasa algo
La referencia completa, endpoint por endpoint, está en Referencia.
Si estás por integrar algo y no sabés por dónde arrancar, escribinos a soporte@dardo.ai contando qué querés conectar y con qué sistema. Te ayudamos a elegir entre API y webhooks, que muchas veces es la decisión que más tiempo ahorra.
Antes de integrar
Definí bien la tarjeta primero. Varios ajustes se congelan al activarla, y el formulario de emisión —qué datos pedís— es uno de ellos. Si tu integración va a mandar datos de clientes, ese formulario tiene que contemplarlos desde el principio. Ver qué queda cerrado al activar.
Probá contra una tarjeta inactiva. Se puede instalar igual, hasta diez veces, así que sirve como entorno de prueba sin tocar tu programa real.
Cuidado con borrar plantillas por API. Borrar una tarjeta activa se lleva las tarjetas ya emitidas contra ella, y no pide confirmación. Es una operación sin vuelta atrás.