API Docs

API de Integración

Conecta sistemas externos y automatiza la gestión de tu programa de fidelización con nuestra API REST.

Autenticación

Todos los endpoints requieren autenticación mediante API Key. Inclúyela en tus peticiones usando uno de estos headers:

Authorization: Bearer TU_API_KEY
x-api-key: TU_API_KEY

Endpoints disponibles

Negocio

GET
/api/integration/business

Obtener información y estadísticas

Productos

GET
/api/integration/products

Listar todos los productos

POST
/api/integration/products

Crear nuevo producto

PUT
/api/integration/products

Actualizar producto

DELETE
/api/integration/products?id=ID

Eliminar producto

Clientes

GET
/api/integration/customers

Listar clientes del negocio

POST
/api/integration/customers

Registrar nuevo cliente

Compras

GET
/api/integration/purchases

Listar compras realizadas

POST
/api/integration/purchases

Registrar nueva compra

Redenciones

GET
/api/integration/redemptions

Listar redenciones de puntos

POST
/api/integration/redemptions

Registrar redención

Ejemplo de uso

Terminal
$curl -X GET "https://dotear.com/api/integration/business" \
-H "Authorization: Bearer TU_API_KEY"

Reemplaza TU_API_KEY con tu API Key real. Puedes obtenerla desde Dashboard → API Keys.

Códigos de respuesta

200
OKPetición exitosa con datos
201
CreatedRecurso creado exitosamente
204
No ContentEliminación exitosa
400
Bad RequestParámetros requeridos faltantes o inválidos
401
UnauthorizedAPI Key inválida o ausente
404
Not FoundRecurso no encontrado
500
Server ErrorError inesperado

¿Necesitas ayuda?

Si tienes dudas sobre la integración o encuentras algún problema, nuestro equipo está aquí para ayudarte.

info@dotear.com

Tips de integración

  • •Guarda tu API Key de forma segura, nunca la expongas en el frontend.
  • •Usa HTTPS siempre para todas las peticiones a la API.
  • •Implementa reintentos con backoff exponencial para errores 5xx.
  • •Valida los datos antes de enviarlos para evitar errores 400.