Saltar al contenido principal

Usar Webservices

Actito te permite interactuar con sus datos a través de una API de tipo REST. Esta API te permite realizar diversas operaciones de creación, actualización y eliminación.

Esta página te proporciona información sobre el funcionamiento y las restricciones de esta API.

Métodos utilizados en los servicios web​

Las operaciones disponibles a través de los servicios web de Actito se agrupan en 5 métodos, cada uno con sus propias funcionalidades: GET, PUT, POST, PATCH y DELETE.

El método GET​

Este método recupera una representación de los recursos en los que se basa la solicitud. Es un método de solo lectura, lo que significa que aplicarlo a un recurso no cambia el estado del recurso. Por lo tanto, es un método seguro.

Principalmente se utiliza para extraer información de Actito, ya sea para procesarla en otros sistemas (perfiles, campañas existentes, ...) o para obtener información estructural con el fin de facilitar la implementación de otros métodos (obtener la estructura de una base de datos, ...)

El método POST​

Este método permite crear un recurso en la colección de recursos utilizando los datos proporcionados en el cuerpo de la solicitud.

Se utiliza principalmente para la creación de nuevos elementos, pero a veces también puede utilizarse para su actualización.

El método PUT​

Este método permite reemplazar la representación de un recurso utilizando los datos proporcionados en el cuerpo de la solicitud, o crear un nuevo recurso si aún no existe.

Se utiliza principalmente para la actualización de elementos, pero su comportamiento implica que también puede utilizarse para activar recursos, actualizando su estado.

El método PATCH​

Este método se utiliza para realizar una actualización parcial de un recurso existente. A diferencia del método PUT, que reemplaza todo el recurso, las rutas PATCH son útiles para actualizar solo parámetros específicos de un recurso sin afectar a los demás parámetros.

El método DELETE​

Este método elimina todas las representaciones de un recurso.

Puede ser utilizado para eliminar un elemento específico (cancelar la suscripción de un perfil a una suscripción) o un elemento más general (eliminar un perfil o una definición de correo electrónico).

Formato de los servicios web​

Las APIs de Actito admiten el formato JSON y el formato XML. Todos los cuerpos de respuesta y los cuerpos de las llamadas realizadas con los métodos POST, PUT y PATCH deben utilizar este formato, a menos que se especifique explícitamente lo contrario.

Si no está familiarizado con este formato, puede validar su código utilizando el siguiente sitio web: https://jsonlint.com/

Uso óptimo de los servicios web​

Para garantizar un uso óptimo de los servicios web, se han establecido ciertos límites de uso:

  • Número máximo de usuarios de servicios web por licencia: 5

  • Número máximo de llamadas por minuto: 100

  • Número máximo de llamadas masivas por día: 12

  • Número máximo de solicitudes simultáneas por licencia: 5

  • Tamaño máximo del archivo comprimido para una llamada masiva: 100 MB

Superar estos límites resultará en un error o en una disminución del rendimiento.