Guia Rapida - Comience con Sword API

Bienvenido a la guía rápida de la API de SWORD

La API de Sword está compuesta por dos endpoints: El primero nos ayuda a obtener la anomalía de cualquier dispositivo en base a las características de entrada (UserAgent - Fingerprint - IP - Cookie).

El segundo se utiliza para añadir un dispositivo en caso de que no exista y si es de confianza.

Autenticación

ℹ️ Todas las solicitudes deben incluir un encabezado llamado Authorization, seguido de una cadena de autorización HTTP de tipo Basic, por ejemplo:

Para el usuariouser con contrasena password se debe generar una cadena de texto Base64 de la forma user:password precedida por la palabra Basic como se ve acontinuacion: Basic dXNlcjpwYXNzd29yZA==

Las credenciales de la API se proporcionan en la página de configuración de Masiv y son gestionadas por el equipo de la plataforma.

Códigos de respuesta

Lista de los posibles códigos de respuesta HTTP/S que puede generar el sistema.

Code Name Description
200 OK La solicitud tuvo éxito.
400 Bad Request El servidor no puede o no va a procesar la solicitud debido a algo que se percibe como un error del cliente (normalmente ocurre cuando el cuerpo de la solicitud no incluye los parámetros requeridos)
500 Internal Server Error El servicio se ha encontrado con una situación que no sabe cómo manejar

Endpoints, requests and responses

Sword Orchestrator URL:

<aside> 🔗 **https://api-sword-service.masivapp.com/v1**

</aside>

POST - /scandeviceprofile

POST - /informationregister

Versiones de la API

Sword Orchestrator API esta en su primera version V1.