Skip to main content

Autenticación (Temporal)

POST

Para interactuar con la API de T1Envios, primero debes autenticarte y obtener un token de acceso. Este token es esencial para autorizar tus solicitudes y garantiza que solo usuarios autenticados puedan acceder a los recursos.

Antes de realizar cualquier operación, es necesario obtener un token de acceso. Para obtener un token de acceso, necesitarás proporcionar tus credenciales (username y password), que corresponden a tú correo electrónico y contraseña con los que accedes a t1envios.com.

Los valores de client_id, grant_type y client_secret son preestablecidos y deben usarse como se indican en esta documentación.

Tutorial paso a paso para obtener un Token de Acceso​

Paso 1: Registro en T1Envios​

  • Primero crea una cuenta en t1envios.com.
  • Si ya tienes una cuenta, simplemente inicia sesión.

Paso 2: Obtener credenciales​

  • Una vez que tengas tu cuenta, asegúrate de tener a mano tu correo electrónico (username) y tu contraseña. Estos son necesarios para la autenticación.

Paso 3: Configurar Postman​

  1. Abrir Postman: Si no lo tienes instalado, descárgalo aquí.

  2. Crear una nueva colección: Organiza tus peticiones a la API de T1Envios creando una nueva colección.

  3. Crear una nueva petición: Dentro de tu colección, selecciona “Nueva petición” y elige el método POST.

Paso 4: Realizar una petición para obtener un token​

  1. Configurar la petición:

    • Método: POST
    • Encabezado: Content-Type: application/x-www-form-urlencoded
    • URL: https://keycloak.dev.plataformat1.com/auth/realms/claroshop-sapi-sa-cv/protocol/openid-connect/token

  2. Añadir los parámetros:

    • grant_type: password
    • client_id: t1envios
    • client_secret: f64cd365-346d-461d-95b4-91938594b84a
    • username: TU_CORREO
    • password: TU_CONTRASEÑA

  3. Enviar la petición: Haz clic en el botón "Send" para enviar la solicitud.

  4. Copiar el token: Una vez recibida la respuesta, copia el valor del access_token.

Paso 5: Incluir el token en tus solicitudes​

  1. Crear una nueva petición: Agrega otra petición en la misma colección.

  2. Añadir el encabezado de autorización:

    • Encabezado: Authorization
    • Valor: Bearer TU_ACCESS_TOKEN

  3. Configurar la petición: Define el método y la URL del endpoint que deseas utilizar.

Paso 6: Probar tu integración​

  • Realiza peticiones a los diferentes endpoints de la API de T1Envios utilizando el token de acceso obtenido.

Paso 7: Renovar el token​

  • Recuerda que los tokens tienen una duración limitada. Asegúrate de renovar tu token cuando expire utilizando el refresh_token.

Con estos pasos, deberías poder autenticarte y empezar a utilizar la API de T1Envios con éxito.

NOTAS:​

  • Asegúrate de que todos los parámetros requeridos se envíen correctamente para evitar errores en la autenticación.
  • Los valores de grant_type, client_id y client_secret son preestablecidos y no deben ser modificados.

Request​

Body

required

    grant_type stringrequired

    password

    client_id stringrequired

    t1envios

    username stringrequired

    Correo con que se registro en la pagina

    password stringrequired

    Contraseña que registro en la pagina

    client_secret stringrequired

    f64cd365-346d-461d-95b4-91938594b84a

Responses​

OK

Schema

    access_token string

    Contiene el JWT (JSON Web Token) que se utiliza para acceder a los recursos protegidos.

    expires_in integer

    Tiempo de vida en segundos del access_token.

    refresh_token string

    Token de actualización que permite obtener nuevos tokens de acceso utilizando la misma concesión de autorización.

    refresh_expires_in integer

    Tiempo de vida en segundos del refresh_token.

    token_type string

    Tipo de token, que será “bearer” en este caso.

    not-before-policy integer

    Tiempo (en segundos) antes del cual no se puede revocar el token, específico para dominio, aplicación y usuario.

    session_state string

    Representa el estado de la sesión del usuario.

    scope string

    Scopes otorgados al token, que definen el nivel de acceso.

Loading...