Primeros paso con la API B2B
La API B2B de Fierro permite a los socios comerciales integrar funcionalidades clave de nuestra plataforma en sus propios sistemas. A través de esta API, podrá acceder a nuestro catálogo, consultar disponibilidad de libros y realizar integraciones personalizadas.
Para comenzar, visite la documentación en
https://b2b.fierro.com.ar/api/schema/docs/. Aquí encontrará todos los endpoints documentados, con una descripción de los atributos y métodos disponibles. Además, los métodos GET incluyen la opción "Try it out", que le permite realizar pruebas directamente desde la interfaz.
Antes de realizar pruebas o integraciones, es necesario contar con un token de autenticación.
Método de autenticación
Para interactuar con la API, necesitará un usuario válido proporcionado por nuestro equipo de soporte.
Tokens de autenticación
Token de acceso: este es el token que deberá incluir en cada llamada a la API. Tiene un tiempo de validez limitado (24 horas), por lo que deberá renovarlo diariamente.
Token de refresco: este token le permite generar nuevos tokens de acceso sin necesidad de volver a autenticarse con usuario y contraseña. Su validez es de 7 días, después de lo cual deberá autenticarse nuevamente para obtener un nuevo par de tokens.
Ejemplos de llamadas:
Usando Curl:
curl -X GET \
-H 'Authorization: Bearer <AccessToken>' \
-H 'accept: application/json' \
Usando request con python:
headers = {
"Authorization": "Bearer <AccesToken>"
}
response = requests.get(url, headers=headers)
Entorno de staging B2B
Este entorno es una instancia del servicio B2B destinada exclusivamente a pruebas. Su funcionamiento es idéntico al entorno de producción (solo varia el dominio del sitio), por lo que puede realizar las pruebas necesarias contra la API utilizando su documentación:
https://b2b-staging.fierro.com.ar/api/schema/docs/.
Tenga en cuenta que el proceso de autenticación y registro es el mismo que en producción. Además, es necesario contar con un usuario habilitado por nuestro equipo de soporte.