Perk utiliza la API de Yokoy para la gestión de gastos. La API de Yokoy es una API REST que permite a las cuentas enviar gastos, consultar transacciones y gestionar facturas en Perk. Solo los administradores de cuenta pueden solicitar las credenciales de la API de Yokoy.
Consejo: ¿Eres nuevo en la API de Spend? Consulta Desarrollador Yokoy.
Las credenciales de la API están vinculadas al ámbito de la cuenta. Esto significa que tienen permisos para modificar datos maestros para diferentes entidades jurídicas.
Al solicitar las credenciales de la API, recibirá el ID de cliente y el secreto de cliente que se utilizan para generar un token de acceso para la API de Gastos. El token de acceso generado debe utilizarse para autenticar todas las llamadas a la API. Además, necesita el ID de la organización de su cuenta. Puede encontrar esta información en la esquina superior derecha de Herramientas para desarrolladores > Herramientas de gasto.
Para generar un token de acceso en la API, consulte Autenticación y autorizaciónLas credenciales de la API son válidas para toda la organización, independientemente de quién realice las llamadas.
Puedes generar las credenciales de la API en la pestaña Credenciales de acceso.
Generación de credenciales de API
Para generar las credenciales de la API de Yokoy:
- Ir a Herramientas para desarrolladores > Herramientas de gasto. En el credenciales de acceso pestaña, para crear nuevas credenciales de API, haga clic Generar credenciales.
-
Elegir Credenciales OAuth y haga clic Generar credenciales.
- Introduce un nombre para describir las credenciales de la API. El nombre te ayudará a identificar las credenciales. debe Debe ser único. No puedes continuar hasta que hayas introducido un nombre único. Haz clic. Próximo.
- Copia el ID de cliente y Secreto del cliente Guárdelas de forma segura (en un archivo protegido). Las credenciales son únicas e irrecuperables. Guárdelas en un lugar seguro para consultarlas posteriormente. Para continuar, debe confirmar que ha copiado el ID y la clave secreta.
Las credenciales de la API no caducan. Puede revocarlas en cualquier momento durante este periodo. Si pierde sus credenciales de la API, deberá revocar el acceso y generar nuevas credenciales.
Puede generar varias credenciales de API para usarlas en diferentes aplicaciones. Las credenciales de API no se revocan automáticamente si genera más de un conjunto de credenciales.
La página de herramientas para desarrolladores de Spend muestra todas las credenciales de API que se han generado o revocado, incluido el usuario que solicitó las credenciales y la fecha en que se solicitaron.
Revocar el acceso
Para revocar el acceso proporcionado por las credenciales de la API:
- En la página de herramientas para desarrolladores de Spend, haga clic en la acción. Revocar acceso.
- Hacer clic Revocar acceso para confirmar y eliminar el token.
Precaución: Si revoca el acceso, cualquier otra aplicación o script que utilice estas credenciales ya no podrá acceder a los datos de Spend. Como resultado, las credenciales de la API ahora aparecen en la página de herramientas para desarrolladores de Spend con el estado Revocado y el nombre del usuario que lo revocó y la fecha de revocación.