API para integraciones (Beta)

2. API de propósito general

Configuración Inicial

1. Autenticación

Todos los endpoints requieren autenticación a través de un access-token. Este access-token es personal y está asociado a un usuario de Fudo. Cada acción realizada con dicho token quedará registrada como si hubiera sido hecha por el correspondiente usuario. Por este motivo, recomendamos crear un usuario específico para el acceso a través de las APIs y así mantener los usuarios regulares separados de los usuarios para el acceso a través de la API.

Los permisos asociados al usuario también serán respetados cuando se accede a las APIs por medio de los acces-token. Si un usuario no tiene permisos para listar ventas, tampoco podrá hacerlo haciendo uso del token.


2. Creación del token

Para poder generar el token, en primer lugar es necesario solicitar a Fudo la activación del acceso mediante API. Una vez hecho esto, se podrá crear el acces-token desde la sección de usuarios. El proceso dentro de Fudo es el siguiente:
1. Ingresar a 'Administración' > 'Usuarios'

  1. Seleccionar el usuario que desee
  2. Al hacer clic sobre 'Establecer', se generará el API Secret, recuerda guardar el mismo, ya que en caso de ser solicitado y no tenerlo a disposición, deberás establecer uno nuevo.

  1. Hacer clic en 'Aceptar'.
    Por defecto, dicho acceso vence a los 10 días con lo cual debe ser renovado antes de su expiración. La renovación se puede realizar desde la misma API.

Para invalidar el token, simplemente hay que eliminarlo. 


3. Especificación

La especificación de nuestra API sigue el estándar OpenApi3. La documentación se puede ver en:

https://dev.fu.do/api