Token
  • 05 Sep 2023
  • 1 Minute to read
  • Contributors
  • Dark
    Light

Token

  • Dark
    Light

Article summary

API

Permite conectarse a los servicios de api en el módulo de SINCO SGD, para ello es indispensable realizar la autenticación en el sistema, dicha autenticación es controlada por un pretoken y un token que tiene una duración de 8 horas.

HOST

URL_SITI0/V3
Ejemplo: http://15.1.15.15/SincoPrueba_Nueva/V3/

Autenticación SINCO

Autenticación Usuario

Autenticación usuario necesita usuario y contraseña, la contraseña debe ir encriptada, haciendo uso de la libreria crypto.js (https://cryptojs.gitbook.io/)

Recuperar usuario

POST/API/Auth/Usuario

Respuestas

  • Código 200:
    El token obtenido es completo, lo cual significa que no es necesario realizar los siguientes pasos.
  • Código 300:
    El cuerpo contiene un pre-token, el cual se podrá usar en los siguientes pasos.
  • Código 404:
    Si el usuario o la contraseña no son correctos, o si el usuario no tiene empresas asignadas, retorna en el cuerpo la cantidad de intentos fallidos en caso tal que el usuario sí exista.

Example URI: POST/API/Auth/Usuario
Request
Token

  • Código 200
    Token200

  • Código 300
    Token300

  • Código 401
    Token401

  • Código 404
    Token404

  • Código 500
    Token500

Consultar empresas

Consultar empresas obtiene las empresas disponibles para el usuario por ambiente.

Obtener empresas

GET/API/Cliente/Empresas

Respuestas

Example URI: GET/API/Cliente/Empresas
Request
TokenCE

  • Código 200
    TokenCE200

  • Código 404
    TokenCE404

Consultar sucursales

Consultar sucursales obtiene las sucursales disponibles por empresa seleccionada.

Obtener sucursales

GET/API/Cliente/{IdOrigen}/Empresa/{IdEmpresa/Sucursales}

Respuestas

Example URI: GET/API/Cliente/1/Empresas/1/Sucursales

TokenCS

Request
TokenCE

  • Código 200
    TokenCS200

Solicitud token final

Solicitud token final obtiene el token final, el cual se utiliza para realizar peticiones al API.

Obtener token final

GET/API/Auth/Sesion/Iniciar/{IdOrigen}/Empresa/{IdEmpresa}/Sucursal/{IdSucursal}

Respuestas

Example URI: GET/API/Auth/Sesion/Iniciar/1/Empresa/1/Sucursal/1

TokenF

Request
TokenCE

  • Código 200
    TokenF200

  • Código 401:
    Significa que la solicitud no contiene el token en los encabezados de la solicitud o que el usuario dentro del pre-token es desconocido. Si el cuerpo de la respuesta tiene contenido, significa que existe un mensaje que el servidor envió, diferente a cuando no existe el token en el encabezado.
    TokenF401


Was this article helpful?