Documentación - Contenedor 'sociallogin'

Introducción

El contenedor sociallogin sirve para hacer login de un nuevo usuario a través de una red social.

Recurso POST

Los datos básicos de Login Social se describen a continuación
[POST] /sociallogin/[rs]
trx=1  
language=es|en 
device="pc", "mobile", "ios", "android"
human=0|1
rs=nat|fb|google|apple|huawei
user=JSONstring
code=verificationAuthorizedCode
trx es el identificador único del cliente, normalmente su id es su correo electrónico. Obligatorio.
language explicado en el capítulo Generalidades
device explicado en el capítulo Generalidades
rs es el tipo de loginsocial, dado en la url:
- rs=fb Cliente autorizado por fb
- rs=google Cliente autorizado por google
- rs=apple Cliente autorizado por apple
- rs=huawei Cliente autorizado por huawei

User:
El objeto JSON contiene distintos parámetros dependiedo del tipo de red social:
fb:
user: { "signedRequest": "_object_getting_by_authorization_client_with_fb_"}
code: null

google:
user: { "token": "_object_getting_by_authorization_client_with_google_"}
code: null

apple:
Para apple existen 2 formas de hacer el login:
1. Usando solamente el code autorización de apple:
code="_code_getting_by_authorization_client_with_apple_" user=null 2. Usando el objeto dado por la autenticación de apple directamente:
user: '{ "userIdentifier": "_paramreques_getting_by_authentication_client_with_apple_", "givenName": "_paramreques_getting_by_authentication_client_with_apple_", "familyName": "_paramreques_getting_by_authentication_client_with_apple_", "email": "_paramreques_getting_by_authentication_client_with_apple_", }' code=null 3. Usando el objeto dado por la autenticación de apple a través del appleid:
user: '{ "sub": "_paramreques_getting_by_authentication_client_with_apple_", "given_name": "_paramreques_getting_by_authentication_client_with_apple_", "family_name": "_paramreques_getting_by_authentication_client_with_apple_", "email": "_paramreques_getting_by_authentication_client_with_apple_", }' code=null

huawei:
Tenemos 2 formas de hacer login con huawei:
1. Usando el code de autorización de huawei:
code="_paramreques_getting_by_authorization_client_with_huawei_" user=null 2. Usando el objeto dado por la autenticación de huawei id:
user: '{ "sub": "_paramreques_getting_by_authentication_client_with_huawei_", "given_name": "_paramreques_getting_by_authentication_client_with_huawei_", "family_name": "_paramreques_getting_by_authentication_client_with_huawei_", "email": "_paramreques_getting_by_authentication_client_with_huawei_", "picture": "_paramreques_getting_by_authentication_client_with_huawei_", }' code=null

Si el login es correcto, entonces regresa un objeto con los datos siguientes:
{
  avatar:"https://platform-lookaside.fbsbx.com/platform/profilepic/?asid=3366254550126141&height=200&width=200&ext=1610556595&hash=AeT2VMeYZCmB5jkqXuY"
  email:"example@gmail.com"
  key:"9999999"
  lastname:"output example"
  mailstatus:"2"
  name:"name"
  sex:"X"
  socialnetwork:redsocial
  status:"REGISTER|OK"
  token:"XXX"
}
Los campos son los siguientes:
status:

En caso de que el login esta incorrecto, regresa un objeto con la estructura siguiente:
{
  "code":1001,
  "status":"Error",
  "socialnetwork":"RedSocial",
  "message":"Error: no hay usuario."
}
code: El código del error que pasó:.
- 1001: Error: no hay usuario
- 1002: Error en el registro con facebook. Favor de probar con otra red social
- 1003: Error en el registro con google. Favor de probar con otra red social
- 1004: Error en el registro con apple. Favor de probar con otra red social
- 1005: Error en el registro con huawei. Favor de probar con otra red social
- 1006: Error red social no reconocida
- 1007: Error. Tu cuenta ha sido dada de baja por un administrador de Kiwilimon. Si crees que es un error puedes contactarnos para aclarar la razón y reactivar tu cuenta
- 1008: Error Interno

estatus: Siempre "error".
mensaje: El mensaje en claro del código de error.


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