Cómo generar el API Token

El API Token de la API de integración REST está en el registro del usuario, en Demander Web. Solo un usuario con el grupo Usuário Api puede usarse en esta integración.

Dónde ver el ApiToken

Abra Usuários y entre en el registro.

El campo ApiToken aparece cuando el grupo Usuário Api está seleccionado en Grupos de usuários. Sin ese grupo, el campo queda oculto.

El valor no se escribe. Use Gerar para crear un token nuevo. El candado muestra u oculta el valor. El icono al lado del título copia el token.

Cómo registrar

1. En Usuários, cree un usuario o abra uno que ya existe.
2. En Tipo, elija Empresa.
3. Si aparece el campo Empresa, complételo. Quien registra ya siendo usuario del tipo Empresa no ve ese campo: el usuario queda en la empresa de quien está registrando.
4. En Grupos de usuários, seleccione Usuário Api.
5. Haga clic en Gerar en el campo ApiToken.
6. Guarde.

No es posible agregar otros grupos de usuario cuando se agrega el grupo Usuário Api.

Al generar un token nuevo y guardar, el token anterior deja de valer. La integración que todavía usa el token antiguo deja de autenticarse hasta recibir el nuevo.

Limitaciones del usuario

El grupo Usuário Api solo vale para el tipo Empresa. Quien registra ya siendo usuario del tipo Empresa no ve el campo Empresa: el usuario queda en la empresa de quien está registrando. En los demás registros, la empresa debe estar completa. Fuera del tipo Empresa, el registro no se guarda.

Con el grupo seleccionado, el ApiToken es obligatorio. Sin token, el registro no se guarda.

Este usuario no inicia sesión en Demander Web, en el App Demander ni en el App Separação. El mensaje es: “Este usuário é exclusivo da Api Rest e não acessa o Demander Web nem o aplicativo.”

El usuario debe estar activo. Un usuario inactivo no se autentica en la API.

Uso en la API REST

En la llamada, informe la empresa del usuario y su ApiToken:

• idEmpresa — código de la empresa del usuario
• x-api-token — ApiToken, en el encabezado de la solicitud

Ejemplo en la descripción general de la API REST.

Preguntas frecuentes

¿El API Token vale para varias empresas?

No. El token es del usuario, y el usuario del grupo Usuário Api queda vinculado a una sola empresa. Un socio no usa el mismo token para otras empresas.