(@) Esta API es recomendada por Wobe
¡Hola!, te damos la bienvenida a la documentación oficial de Wobe ID, que no se debe confundir con Wobe Accounts. Wobe ID es el sistema de cuentas de Wobe Git, el host de Git oficial de Wobe. Usar Wobe ID es más seguro que Wobe Accounts, pero es más difícil de configurar.
Diferencias
Wobe Accounts: El sistema de cuentas de Wobe, puede ser integrado a tu sitio web tambien pero no es compatible con Oauth2, este tiene una base de datos NoSQL basica para guardar cosas por cada usuario que se loguee a tu app.
Wobe ID: Es la cuenta que usan las personas para loguearse a Wobe Git, el host de Git de Wobe. Cuenta con Oauth2 y es más seguro, pero más difícil de configurar y no tiene base de datos, solo sirve para autenticación.
Para empezar, primero debes de crear una aplicación. Para ello accede a Wobe Git en git.wobe.qzz.io y crea una cuenta si no tienes una. Luego ve a el icono de tu perfil > Ajustes > Aplicaciones > Crear una nueva aplicacion Oauth2.
En el formulario especifica el nombre de tu app y abajo escribes la URL a la que se redirigirá el usuario cuando se loguee. Si quieres especificar varias, escriba una en cada línea.
A la app se le otorgara un ID de cliente y un Client Secret que DEBES guardar para poder validar a los usuarios y NUNCA lo compartas. Ahora tu app esta lista para empezar a recibir logins, puedes probarlo en https://git.wobe.qzz.io/login/oauth/authorize?client_id=ID&redirect_uri=REDIRECCION&response_type=code&state=123456. Debes reemplazar los valores ID y REDIRECCION con tus valores reales.
Ahora ya tu app puede recibir logins, ¡Bien hecho!, ahora haremos que tu app los entienda.
Tu app debe de enviar un parámetro POST para obtener el token del usuario (Preferiblemente desde un backend para ocultar tu Client Secret).
POST https://git.wobe.qzz.io/login/oauth/access_token
Content-Type: application/x-www-form-urlencoded
client_id=TU_ID&
client_secret=TU_SECRETO&
code=CODIGO_RECIBIDO&
grant_type=authorization_code&
redirect_uri=TU_REDIRECCION
Con el token puedes acceder a información del perfil:
GET https://git.wobe.qzz.io/api/v1/user
Authorization: Bearer TU_ACCESS_TOKEN_AQUÍ
Vas a recibir una respuesta algo así:
JSON
{
"id": 1,
"username": "Luciano",
"full_name": "Luciano",
"email": "Luciano@wobe.is-a.dev",
"avatar_url": "https://..."
}
¡Y listo! Ya tienes los datos del usuario para que lo autentiques sin que se tenga que crear una cuenta nueva en tu servicio, más comodidad para el usuario.
¡Muy bien!, esta era la ultima página de la sección APIs de la documentación.