Guía de Autenticación de la API

Nuestra API REST ofrece acceso a diversos servicios mediante un token de autenticación. A continuación, te explicamos cómo obtener este token, sus beneficios y el acceso que proporciona.

Cómo Obtener el Token

Solicitud de Autenticación: Envía una solicitud a nuestra API con tus credenciales (nombre de usuario, contraseña y clave de API).

Validez: Al autenticarse correctamente, recibirás un token válido por 24 horas. Pasado este tiempo, deberás renovarlo para continuar utilizando la API.

Acceso con el Token

El token permite acceder a todos los servicios y recursos de la API, incluyendo:

Marcas: Consulta de todas las marcas disponibles.

Categorías: Organización de productos en categorías.

Productos: Información completa sobre cada producto, incluyendo precios y disponibilidad.

Imágenes: Acceso seguro a las URLs de imágenes de productos.

Fichas Técnicas: Consulta de especificaciones técnicas detalladas.

Órdenes: Creación y gestión de órdenes de compra.

Estimador de Envío: Estimación de costos de envío (solo en producción).

Estado de Pedidos: Seguimiento de órdenes enviadas (solo en producción).

Nota: El acceso al modo Sandbox o modo Producción es gestionado automáticamente por el token proporcionado. No necesitas credenciales diferentes, ya que el token contiene la información necesaria para determinar el modo de operación.

Beneficios de Utilizar el Token

El token garantiza un acceso seguro y controlado, ofreciendo los siguientes beneficios:

Seguridad: Solo los usuarios autenticados pueden acceder a datos sensibles.

Autorización: Permite un acceso personalizado según los permisos de cada usuario.

Flexibilidad: Durante su validez, permite realizar múltiples solicitudes sin autenticarse repetidamente.

Importante: Una vez expirado el token (después de 24 horas), será necesario renovarlo para mantener el acceso continuo a los servicios de la API.

Request

Body Params application/json

usuario

string

required

Añadir Usuario de accesso. Proporcionado por BDI.

password

string

required

Añadir Contraseña de usuario. Proporcionado por BDI.

api_key

string

required

Token de Acceso Global. Proporcionado por BDI.

Example

{
    "usuario": "Usuario",
    "password": "PasswordUsuario",
    "api_key": "Token Proporcionado"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

result

string

optional

Mensaje de resultado exitoso

data

object

optional

Objeto que contiene el token

tempToken

string

optional

Token temporal

expires_in

integer

optional

Tiempo de Expiración ( 24 hrs )

Example

{
    "result": "success",
    "data": {
        "tempToken": "Proporciona un token temporal que dura 24hrs",
        "expires_in": 86400
    }
}

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Token de Accesso General

Guía de Autenticación de la API#

Cómo Obtener el Token#

Acceso con el Token#

Beneficios de Utilizar el Token#

Request

Request samples

Responses

Guía de Autenticación de la API

Cómo Obtener el Token

Acceso con el Token

Beneficios de Utilizar el Token