Per usare la nostra API serve già un po' di esperienza con le API e come funzionano. Questo articolo spiega cos'è l'API di Teamtailor e come iniziare a usarla.
Cos'è l'API di Teamtailor e cosa fa?
La nostra API aperta di Teamtailor segue la specifica JSON API e si può usare per importare, modificare ed esportare informazioni da e verso il tuo account Teamtailor. Puoi fare varie azioni, come prendere una lista di offerte, aggiornare un'offerta, modificare un utente o anche crearne uno nuovo.
Teamtailor mette a disposizione diverse regioni per il trattamento e l’archiviazione dei dati. L’URL dell’API che userai nelle chiamate dipende dalla regione dove si trova il tuo account.
Regione Europa (Irlanda): api.teamtailor.com
Regione Nord America (Oregon): api.na.teamtailor.com
Regione Asia-Pacifico (Australia): api.au.teamtailor.com
Per iniziare
Per usare la nostra API, devi creare una chiave API da Impostazioni → Integrazioni → Chiavi API nel tuo account Teamtailor. Nota che questa pagina è accessibile solo per gli utenti con accesso all'amministratore dell'azienda.
Qui puoi sia creare nuove chiavi che eliminare quelle esistenti. Una volta creata, la chiave API non si può modificare, solo eliminare.
Per creare una chiave API fare clic su + Nuova chiave API nell'angolo in alto a destra.
Ci sono tre diversi tipi di chiavi, con diverse autorizzazioni e scopi. Tutti questi sono spiegati nella nostra documentazione qui e sono i seguenti:
Autorizzazioni:
Pubblico - accesso a tutti i dati pubblici disponibili sul sito di carriera
Interna - dati pubblici + dati interni (per esempio, offerte interne/non pubblicate, dipartimenti, sedi)
Admin - accesso a tutto in un account
Tipi:
Leggi - solo recupera informazioni e 'legge' esse
Scrivi - solo crea nuove informazioni
Leggi/Scrivi - può fare entrambe le cose
Esempio di caso d'uso
Se, per esempio, vuoi ottenere una lista di offerte tramite la nostra API e ti interessano solo quelle pubblicate, conviene usare una chiave con permessi di Accesso Pubblico, che ti dà accesso ai dati pubblici sul sito carriera, come le offerte pubblicate. Se invece vuoi vedere tutte le sedi, pubbliche e non, ti serve una chiave con almeno permessi di Accesso Interno.
Alcuni dati sono molto protetti per motivi di sicurezza (es. le informazioni sui candidati) e si possono accedere solo con una chiave a permessi di Amministratore. Se è così, questo è sempre indicato nella documentazione dell'API.
Assistenza
Tutti gli endpoint disponibili sono descritti nella nostra documentazione, con tutto il necessario per eseguire le azioni e esempi testabili se vuoi.
Se hai domande generali sulla documentazione API, puoi scriverci a support@teamtailor.com, però tieni presente che non offriamo supporto per l’implementazione dell’API.
Se qualcosa non è elencato nella documentazione, probabilmente non è disponibile per l’implementazione. Script personalizzati o ulteriori integrazioni possono essere combinati con le richieste disponibili nei nostri script API pubblici, tuttavia, come procedere è completamente a discrezione del cliente.
🤖 Questo articolo è stato tradotto utilizzando l’IA. Facci sapere se qualcosa non ti sembra corretto.