Att använda vårt API kräver förkunskaper och erfarenhet av API:er och hur man arbetar med dem. Den här artikeln förklarar vad Teamtailor API är och hur du kommer igång.
Vad är Teamtailor API och vad gör det?
Vårt Teamtailor open API följer JSON API-specifikationen och kan användas för att importera, redigera och exportera information från/till ett Teamtailor-konto. Det kan handla om allt från att hämta en lista med jobb, uppdatera ett jobb, uppdatera en användare eller till och med skapa en användare.
Teamtailor erbjuder olika regioner för databehandling och lagring. Den API-URL du använder i dina API-anrop beror på vilken region ditt konto är lagrat i.
Europa (Irland) region: api.teamtailor.com
Nordamerika (Oregon) region: api.na.teamtailor.com
Asien-Stillahavsområdet (Australien) region: api.au.teamtailor.com
Kom igång
För att kunna använda vårt API måste en API-nyckel skapas i Inställningar → Integrationer → API-nycklar på ditt Teamtailor-konto. Observera att denna sida endast är tillgänglig för användare med Företagsadmin behörighet.
Här kan du både skapa nya nycklar och ta bort befintliga. Tänk på att när en API-nyckel skapats kan den inte redigeras, bara tas bort.
För att skapa en API-nyckel, klicka på + Ny API-nyckel uppe i högra hörnet.
Det finns tre olika typer av nycklar, med olika behörigheter och omfattningar. Dessa förklaras alla i vår dokumentation här och är följande:
Behörigheter:
Offentlig - ger tillgång till all offentlig data som finns tillgänglig på karriärsidan
Intern – offentliga + interna data (t.ex. olistade/internt jobb, avdelningar, platser)
Admin - tillgång till allt i ett konto
Typer:
Läsa - hämtar och "läser" bara information
Skriva - skapar endast ny information
Läsa/Skriva - kan göra båda delar
Exempel på användningsfall
Om du till exempel hämtar en lista med jobb via vårt API och bara vill ha en lista över publicerade jobb är det bra att använda en Offentlig läs-nyckel eftersom den ger tillgång till offentlig data på karriärsidan, som publicerade jobb. Vill du istället kunna hämta en lista över alla platser, offentliga eller ej, behöver du en nyckel med minst Intern läsbehörighet.
Viss data är mycket begränsad av säkerhetsskäl (t.ex. kandidaters information/data) och kan endast nås med en nyckel som har Admin-omfattning/behörighet. Om så är fallet anges detta alltid i API-dokumentationen.
Support
Dokumentationen beskriver alla tillgängliga slutpunkter och vad som behövs för varje åtgärd, med exempel som kan testas vid behov.
Har du allmänna frågor om API-dokumentationen är du välkommen att kontakta vår support på support@teamtailor.com, men observera att vi inte erbjuder support för API-implementation.
Om något inte finns med i dokumentationen är det troligen inte möjligt att implementera. Anpassade skript eller ytterligare integrationer kan kombineras med de förfrågningar som finns i våra offentliga API-skript, men hur man gör det är helt upp till kunden.
🤖 Den här artikeln är översatt med hjälp av AI. Meddela oss om något verkar fel.