Perk utilizza l'API Yokoy per la gestione delle spese. L'API Yokoy è un'API REST che consente agli account di inviare spese, consultare transazioni e gestire fatture in Perk. Solo gli amministratori dell'account possono richiedere le credenziali API per l'API Yokoy.
Mancia: Nuovo utente della Spend API? Scopri Sviluppatore Yokoy.
Le credenziali API sono limitate all'ambito dell'account. Ciò significa che hanno permessi per modificare i dati master per diverse entità giuridiche.
Quando richiedi le credenziali API, ricevi l'ID client e il client secret, utilizzati per generare un token di accesso per l'API Spend. Il token di accesso generato deve essere utilizzato per autenticare tutte le chiamate all'API. Inoltre, è necessario l'ID organizzazione del tuo account. Puoi trovare queste informazioni nell'angolo in alto a destra in Strumenti per sviluppatori > Strumenti di spesa.
Per generare un token di accesso nell'API, vedere Autenticazione e autorizzazioneLe credenziali API sono valide per l'intera organizzazione, indipendentemente da chi invia le chiamate.
È possibile generare le credenziali API nella scheda Credenziali di accesso.
Generazione delle credenziali API
Per generare le credenziali API per l'API Yokoy:
- Vai a Strumenti per sviluppatori > Strumenti di spesaNel Credenziali di accesso scheda, per creare nuove credenziali API, fare clic Genera credenziali.
-
Scegliere Credenziali OAuth e clicca Genera credenziali.
- Inserisci un nome per descrivere le credenziali API. Il nome ti aiuterà a identificarle. Il nome dovere essere univoco. Non è possibile continuare finché non è stato inserito un nome univoco. Fare clic su Prossimo.
- Copia il ID cliente E Segreto del cliente e conservarle in modo sicuro (ad esempio in un file protetto). Le credenziali sono univoche e non recuperabili. Conservarle in un luogo sicuro per poterle consultare in seguito. Per continuare, è necessario confermare di aver copiato l'ID e il segreto.
Le credenziali API non scadono. È possibile revocarle in qualsiasi momento durante questo periodo. In caso di smarrimento delle credenziali API, è necessario revocare l'accesso e generarne di nuove.
È possibile generare più credenziali API da utilizzare in applicazioni diverse. Le credenziali API non vengono revocate automaticamente se si genera più di un set di credenziali.
La pagina degli strumenti per sviluppatori Spend mostra tutte le credenziali API generate o revocate, incluso l'utente che le ha richieste e la data in cui sono state richieste.
Revoca dell'accesso
Per revocare l'accesso fornito dalle credenziali API:
- Nella pagina Strumenti per sviluppatori di spesa, fare clic sull'azione Revoca l'accesso.
- Clic Revoca l'accesso per confermare e rimuovere il token.
Attenzione: Se revochi l'accesso, tutte le altre applicazioni o script che utilizzano queste credenziali non saranno più in grado di accedere ai dati di Spend. Di conseguenza, le credenziali API ora vengono visualizzate nella pagina degli strumenti per gli sviluppatori di Spend con lo stato Revoca e il nome dell'utente che lo ha revocato e la data di revoca.