1.1 Autenticación de Usuarios - dotworkers/dls GitHub Wiki

POST /security/auth/session/:token

Genera la sesión del usuario por dos horas que será utilizada en la mayoría de las api que requieran información del usuario correspondiente. Se necesita del cliente un enlace para validar la información del :token.

Resource URL

https://v1.api.dls.dotworkers.com/security/auth/session/:token

Parámetros
Nombre Tipo Descripción
dls-token HEADER,GET Token del cliente que realiza la solicitud.
Ejemplo: fdff8e81-c016-4b75-a518-e64e2e291af8
:token URL Token del usuario que accede al recurso del sistema, es el utilizado para obtener información.
Ejemplo: 008834be7e005c91e7657e6216606cb83893eb67
Petición de Ejemplo

curl -X POST -H "dls-token: fdff8e81-c016-4b75-a518-e64e2e291af8" 'https://v1.api.dls.dotworkers.com/security/auth/session/008834be7e005c91e7657e6216606cb83893eb67'

Una vez que se envíen los datos hacía la URL de la API, el sistema retorna el token del usuario, hacia la URL que valida la información.

Petición de Ejemplo validando token - URL Cliente
Resource URL

http://endpoint.domain.com/validate/token

Nombre Tipo Descripción
token param Token del usuario el cual servirá para obtener la información necesaria, suministrada en el ejemplo

curl -X POST -F "token=008834be7e005c91e7657e6216606cb83893eb67" 'http://endpoint.domain.com/validate/token'

Acá se debe enviar una respuesta que debe ser tipo JSON, con los datos que se muestran a continuación

Resultado de Ejemplo
{
  "Dotworkers": {
    "header": {
      "status": 200,
      "description": "OK"
    },
    "content": {
      "user": {
        "id": 728,
        "name": "Tanya Rice",
        "username": "tanya",
        "email": "[email protected]",
        "country": "VE"
      },
      "wallet": {
        "amount": 1971,
        "currency": "VEF"
      }
    }
  }
}

Si el resultado de la petición es el solicitado, el sistema generará una respuesta como se muestra a continuación:

Resultado de Ejemplo
{
  "Dotworkers": {
    "header": {
      "author": ".dev SPACE",
      "status": 200,
      "description": "OK",
      "timestamp": 1510242116
    },
    "content": {
      "token": "24eabd31-ff9f-4302-bea2-b755e3238f63",
      "spin500": "//app.v2.dls.dotworkers.com/24eabd31-ff9f-4302-bea2-b755e3238f63/spin500/default",
      "diceDuel": "//app.v2.dls.dotworkers.com/24eabd31-ff9f-4302-bea2-b755e3238f63/diceduel/default",
      "luckyLottery": "//app.v2.dls.dotworkers.com/24eabd31-ff9f-4302-bea2-b755e3238f63/lucky-animals/lottery",
      "lucky5": "//app.v2.dls.dotworkers.com/24eabd31-ff9f-4302-bea2-b755e3238f63/lucky-animals/default"
    }
  }
}

Una vez obtenida la respuesta, se debe tomar el contenido de la variable :token y conectarse a la URL de la interfaz que se muestra a continuación

URL Interfaz

https://app.v2.dls.dotworkers.com/:token/spin500/default

Y con eso, el usuario ya tiene una sesión activa para poder utilizar el sistema.

⚠️ **GitHub.com Fallback** ⚠️