Det kan være en fordel at oprette jobansøgninger med Emply's offentlige API hvis du ønsker at håndtere ansøgningsprocessen i dit eget system eller fra din egen hjemmeside. Denne guide viser dig hvordan du kan opsætte dit system så ansøgningerne oprettes og styres eksternt.
Opret jobansøgninger med offentlig API
Krav
Disse krav inkluderer både den viden du skal bruge internt i din organisation, såvel som de tekniske opsætningskrav der skal bruges i Emply
Bemærk: Emply forventer at kunder selv er ansvarlige for deres viden og tekniske krav. Misbrug af den offentlige API kan resultere i ekstra omkostninger hvis Emply's ressourcer kræves til at ordne problemet.
Emply understøtter ikke ekstern opsætning af offentlig API forbrug, scripts, data opbevaring og udførselstid. Dette skal håndteres og aftales ved interne ressourcer i organisationen.
Krav til viden:
- Scripting
- REST API
- JSON
- Data opbevaring sikkerhed og lovlighed (hvis ansøgerens data opbevares uden for Emply)
Tekniske krav til Emply
Hvis du klikker på et punkt, åbnes artiklen i en ny fane. Skulle der være spørgsmål eller problemer ved opsætning, bedes du kontakte Emply support eller din implementeringsagent, som vil assistere dig med opsætningen
- Ansøgningsformular med privatpolitik element
- Jobskabelon
- Prøveeksempel job der kan bruges til at teste
- Prøveeksempel kandidat på prøveeksempel job oprettet i Emply med den korrekte ansøgningsformular
- API nøgle med den korrekte rolle opsat i Emply
Eksternt opbevaret data
For at undgå for mange anmodninger anbefaler vi at noget data er opbevaret og genbrugt i den eksterne service. Dette inkluderer:
- API nøgle (bør opbevares sikkert)
- Formular ID for ansøgningsformularen
- Vacancyid'er (for job uden udløbstid og emnebanker
- Response body template
For at få hjælp til formular ID, ledige stillinger ID og response body skabeloner, læs denne artikel og brug denne metode til at få ansøgningsdata til dit prøveeksempel job og kandidat. Ændre/fjern prøveeksemplet fra svaret i trin 3.
Test oprettelse af ansøgningen
Efter opsætningstrinene er fuldført of formular ID, ledige stillinger ID og response body skabeloner kan en test oprettelse afprøves via api.emply.com.
Naviger til POST/v1/{customer}/applications/create/{formId}/{vacancyId} endpoint, og følg disse trin:
- Autoriser din API nøgle i det øverste højre hjørne, ved at klikke på "Authorize" knappen
- Udfyld formId feltet med det korrekte formular ID
- Udfyld vacancyId med det korrekte stilling ID
- Udfyld kunde feltet med den første del af din platform URL (eksempel: test.emply.com vil have ordet "test" i dette felt)
- Klik på "Try it out" knappen
- Indsæt din respons body skabelon i respons feltet
- Udfyld den data i din skabelon du ønsker at indsende
- Klik "Execute"
Hvis du har gjort det korrekt, burde du få en kode 200 respons igen. En ny kandidat oprettes i det tilsvarende job og denne kandidat vil være synlig i "Sourced" delen af kandidat listen
Vigtige noter:
Der er nogle ting du skal have i mente når du eksternt opretter ansøgninger:
- Privatpolitikken accepteres automatisk når en kandidat oprettes igennem et API, hvis privatpolitik elementet tilføjes til ansøgningsformularen
- Når du sender en ansøgning via API'et og bruger en ansøgningsformular uden privatpolitik elementet, markeres privatpolitik ikke som accepteret
- Privatpolitikkens status er ikke synlig igennem API'et, og inkluderes derfor ikke når du opretter en respons body
- Privatpolitikken skal ikke inkluderes i POST body
- Kandidatprofilen dukker altid op i "sourced" delen af kandidat pipelinjen
- Emply automatisering der bruger "kandidat oprettet" udløser ikke ved oprettelse af kandidater via API'et