Este documento detalla los servicios web que permiten comunicarse con Fidelitytools bajo el protocolo de comunicación REST y el formato de los mensajes JSON.
Fidelitytools es un software web de fidelización de personas y gestión de acciones de las mismas, permitiendo asociarles diversos tipos de datos que luego servirán para obtener información relevante y detallada sobre el entorno gestionado.
Para utilizar los servicios web de Fidelitytools es necesario contar con los siguientes datos provistos por los administradores de Fidelitytools:
- Token de acceso.
- Llave de acceso a los servicios web.
La cantidad de solicitudes permitidas por cliente es de 40 cada 5 segundos, es decir 8 solicitudes cada 1 segundo. Si este límite es superado, el cliente será bloqueado temporalmente y recibirá una respuesta de tipo HTTP 401 (Unauthorized) cada vez que quiera realizar una petición al servicio web. El bloqueo temporal dura 1 minuto desde el momento que fue bloqueado.
Los servicios web de Fidelitytools están divididos por módulos, donde por cada módulo se pueden realizar varias acciones.
Para utilizar cualquier servicio web de Fidelitytools es necesario contar con un token, el cual es proporcionado por primera vez por los administradores de Fidelitytools. Este token tiene una validez de un dia. Luego hay que regenerarlo para continuar consumiendo los servicios web.
Módulo Segmentación (Descripcion general)
- Registrar / Actualizar Personas
- Obtener Persona
- Obtener Personas
- Obtener Cantidad de Personas
- Obtener Actividades por Persona
Módulo Ecommerce (Descripcion general)
Módulo Catalogos (Descripcion general)
- Obtener Catalogos
- Obtener Catalogo
- Registrar / Actualizar Catalogos
- Eliminar Catalogo
- Actualizar Catalogo (Precio y Stock)
Módulo Actividades (Descripcion general)
- Obtener Tipos de Actividades
- Obtener Configuracion de un Tipo de Actividad
- Registrar / Actualizar Actividades
- Eliminar Actividades
- Obtener Actividad
- Registrar Archivos por Actividad
- Obtener Actividades por Tipo