Documentación - Contenedor 'client'

Introducción

El contenedor client regresa la información del cliente conectado, sea por cookie o por token.

Recurso GET y POST

Los datos básicos de un cliente se obtienen consumiendo el recurso siguiente:

[GET] /client[?token=:TOKEN][&humano=:humano][&idioma=:idioma][&dispositivo=:dispositivo]
ó
[POST] /client
token=:TOKEN
humano=:humano
idioma=:idioma
dispositivo=:dispositivo

:TOKEN es el token de sesión del cliente y es opcional (entonces usa el token de la cookie de sesión, que debe de tener el mismo valor).
:humano es 1 para obtener el JSON en un formato legible.
:idioma es el idioma solicitado para recibir la información (del sitio que nos visita). Posibles valores especifícados en Generalidades.
:dispositivo es el dispositivo que nos visita. Posibles valores especifícados en Generalidades.
La cookie de sesión tiene el nombre 'SiteSesion'

Si el token o cookie es válido, regresa un objeto JSON del formato siguiente:

{
  "client": {
    "c":65714,
    "a":"Apellido",
    "n":"Nombre",
    "i":"https://cdn/imagen.jpg",
    "ruta": "/chef/23487678237",
    "p":false,
    "col":8,
    "fav":49,
    "rec":39,
    "tip":39,
    "seg":22,
    "sig":33,
    "color":"#ffffff",
    "ifondo":"https://cdn/img/static/kl-profile-bg1.png",
    "u":"2019-03-27T10:59:57.082627Z"
  },
  "dispositivo":"mobile",
  "idioma":"es",
  "geo":"CMX",
  "gep":"MX",
  "ip":"1.1.1.1",
  "lang":"es",
  "pay": {
    "currency":"MXN",
    "name":"Pesos mexicanos",
    "price":35,
    "rate":20,
    "symbol":"$"
  },
  "server":"im",
  "origin":"kiwi",
  "skin":"kiwi-id",
  "t":1559251929
}

Los campos son los siguientes:
client: El objeto que contiene los datos del cliente.
- c: La clave del cliente.
- a: El apellido del cliente.
- n: El nombre del cliente.
- i: La imagen (avatar) del cliente.
- ruta: La URL de la ruta del cliente.
- p: True si es un usuario PRO, false si no.
- col: Cantidad de colecciones.
- fav: Cantidad de favoritos.
- rec: Cantidad de recetas subidas.
- tip: Cantidad de tips subidas.
- seg: Cantidad de seguidores.
- sig: Cantidad de otros clientes que sigue.
- color: EL color para imprimir el nombre del cliente sobre la imagen ifondo.
- ifondo: La imagen de fondo del cliente.
- u: Ultima conección del cliente.
dispositivo: El dispositivo con el cual nos visita el usuario (de la solicitud).
idioma: El idioma usado por el sitio.
geo: Las 3 letras ISO del estado donde se encuentra el cliente, ubicado por IP.
gep: Las 2 letras ISO del pais donde se encuentra el cliente, ubicado por IP.
ip: La IP del cliente.
lang: El idioma por defecto del usuario, ubicado por el pais del cliente y/o el idioma del browser.
pay: Los datos para pago de suscripcion PRO:
- currency: La moneda para pagar.
- name: Nombre de la moneda.
- price: Precio de la suscripción mensual.
- symbol: El símbolo de la moneda.
server: Nombre del server que contestó la petición.
origin: Siempre "kiwi" o "crafto".
skin: Siempre "kiwi-id" o "crafto-id".
t: EL tiempo en unix timestamp de la petición.

Si el token o cookie es caduco, o si no tiene token/cookie, regresa un objeto JSON del formato siguiente:

{
  "client": null,
  "dispositivo":"mobile",
  "idioma":"es",
  "geo":"CMX",
  "gep":"MX",
  "ip":"1.1.1.1",
  "lang":"es",
  "pay": {
    "currency":"MXN",
    "name":"Pesos mexicanos",
    "price":35,
    "rate":20,
    "symbol":"$"
  },
  "server":"im",
  "origin":"kiwi",
  "skin":"kiwi-id",
  "t":1559251929
}

Los campos son los siguientes:
client: puesto a NULL.
dispositivo: El dispositivo con el cual nos visita el usuario (de la solicitud).
idioma: El idioma usado por el sitio.
geo: Las 3 letras ISO del estado donde se encuentra el cliente, ubicado por IP.
gep: Las 2 letras ISO del pais donde se encuentra el cliente, ubicado por IP.
ip: La IP del cliente.
lang: El idioma usado por el sitio, ubicado por el pais del cliente y/o el idioma del browser.
pay: Los datos para pago de suscripcion PRO:
- currency: La moneda para pagar.
- name: Nombre de la moneda.
- price: Precio de la suscripción mensual.
- symbol: El símbolo de la moneda.
server: Nombre del server que contestó la petición.
origin: Siempre "kiwi" o "crafto".
skin: Siempre "kiwi-id" o "crafto-id".
t: EL tiempo en unix timestamp de la petición.
Si el sistema esta en mantenimiento, puede regresar un estatus 503
Si accede otros métodos, puede regresar un estatus 501
Si hay un problema en el sistema, puede regresar un estatus 500

Recurso DELETE

Se puede desconectar un cliente (borrar la cookie de sesión) con el recurso siguiente:

[DELETE] /client[?token=:TOKEN]

:TOKEN es el token de sesión del cliente y es opcional (entonces usa el token de la cookie de sesión, que debe de tener el mismo valor).
La cookie de sesión tiene el nombre 'SiteSesion'

El servicio invalida la cookie de sesión del usuario en la base de datos y el usuario tendrá que conectarse de nuevo por cualquier método para obtener un nuevo token de sesión.

Si el sistema esta en mantenimiento, puede regresar un estatus 503
Si accede otros métodos, puede regresar un estatus 501
Si hay un problema en el sistema, puede regresar un estatus 500