API de Integración Dotear

Documentación oficial para conectar sistemas externos y automatizar la gestión de productos, clientes, compras y redenciones en tu programa de fidelización.

Autenticación

Todos los endpoints requieren API Key. Inclúyela en el header Authorization: Bearer TU_API_KEY o x-api-key: TU_API_KEY.

Endpoints principales

Negocio

  • GET /api/integration/business Obtener información y estadísticas del negocio

Productos

  • GET /api/integration/products Listar productos
  • POST /api/integration/products Crear producto (soporta imagen)
  • PUT /api/integration/products Actualizar producto (soporta imagen)
  • DELETE /api/integration/products?id=PRODUCT_ID Eliminar producto

Clientes

  • GET /api/integration/customers Listar clientes del negocio
  • POST /api/integration/customers Registrar cliente

Compras

  • GET /api/integration/purchases Listar compras del negocio
  • POST /api/integration/purchases Registrar compra

Redenciones

  • GET /api/integration/redemptions Listar redenciones del negocio
  • POST /api/integration/redemptions Registrar redención de puntos

Ejemplo de uso

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

Cambia TU_API_KEY por tu valor real.

Respuestas y errores

  • 204 No Content: Eliminación exitosa
  • 401 Unauthorized: API Key inválida o ausente
  • 404 Not Found: Recurso no encontrado o no pertenece al negocio
  • 400 Bad Request: Parámetros requeridos faltantes
  • 500 Internal Server Error: Error inesperado

Soporte

¿Dudas o problemas? Contáctanos en info@dotear.com