TalentApproved

3 API-anrop för att leverera ATS-bedömningspoäng till HR och teknik

3 API-anrop för att leverera ATS-bedömningspoäng till HR och teknik

Föredra ett inbyggt bedömnings-API när ditt system för kandidathantering erbjuder ett sådant. När det saknas, faller du tillbaka på en system-of-record-integration eller ett enhetligt bedömnings-API. Oavsett vilket, planera för tre kärnåtgärder: att lista tillgängliga testpaket, utlösa en bedömning för en kandidat och synkronisera resultat tillbaka via webhooks. Rikare funktioner eller tillgång till integrationen överhuvudtaget kan ligga bakom en betald nivå eller partnernivå.

Sammanfattning:

  • Inbyggda bedömnings-API:er ger den bästa rekryterarupplevelsen genom att möjliggöra filtrering och rangordning av kandidater baserat på strukturerade poäng i ATS:en.
  • När inget bedömnings-API finns tillgängligt bifogar reservintegrationer resultat som anteckningar eller filer, vilket begränsar möjligheten att filtrera eller sortera kandidatresultat.
  • Den rekommenderade integrationssekvensen innebär att lista paket, utlösa bedömningar och fånga upp resultat via webhooks, med fokus på säker identifiering och korrekt hantering av svarskoder.
  • Arbetsgivare måste validera och dokumentera bedömningsverktyg för rättvisa och juridisk efterlevnad innan driftsättning, och säkerställa att resultaten lagras med en granskningslogg och att samtycke registreras.
  • Att testa integrationen noggrant i en stagingmiljö och spåra webhook-framgång hjälper till att förhindra fel och föräldralösa resultat i den aktiva rekryteringsprocessen.
Talent Approved
Bedöm kompetenser bortom CV:t
Talent Approved hjälper arbetsgivare att skapa skräddarsydda kompetensbedömningar, granska strukturerade resultat och fatta mer välgrundade anställningsbeslut.
Utforska Talent Approved

Innehållsförteckning

Inbyggda API:er, reservintegrationer och enhetliga bedömnings-API:er

Tre integrationsmönster täcker nästan varje rekryteringsstack, och vart och ett förändrar vad dina rekryterare ser i ATS:en.

Ett inbyggt bedömnings-API är det renaste alternativet. Det exponerar testpaket, beställningar och strukturerade resultat direkt i ATS-posten, vilket innebär att rekryterare kan filtrera och rangordna kandidater efter poäng på samma sätt som de filtrerar efter steg eller källa. Ashbys utvecklardokumentation beskriver detta som standardformen: lista paket, starta en bedömning, skriv tillbaka resultaten via en webhook.

När ATS:en saknar dedikerade bedömningsendpunkter faller team tillbaka på stadie-ändringslyssnare och bifogar resultat som anteckningar, länkar eller filuppladdningar. Detta bevarar grundläggande täckning, men tar bort strukturerad poängsättning, så rekryterare förlorar möjligheten att sortera eller filtrera efter resultat i ATS:en, enligt Kombos integrationsguide.

Ett enhetligt bedömnings-API befinner sig mellan de två. Det standardiserar paket, beställningswebhooks och resultatåterskrivning över många ATS-plattformar på en gång, så att en leverantör integrerar en gång och når dussintals system istället för att bygga och underhålla en separat anslutning för var och en, som beskrivs i översikten för det enhetliga bedömnings-API:et.

  • Inbyggt API: bäst rekryterarupplevelse, kopplat till en ATS.
  • Reservintegration: bredast täckning, svagast in-ATS-poängsättning.
  • Enhetligt API: lägre långsiktig underhållsbörda för leverantörer som betjänar flera ATS:er.

Bygga integrationen: en steg-för-steg-checklista

Innan du skriver någon kod, bekräfta att ATS:en faktiskt exponerar ett bedömnings-API och hämta utvecklardokumentationen. Många plattformar publicerar bara allmänna kandidat- eller ansökningsendpunkter, och att behandla dessa som bedömningsendpunkter är ett vanligt tidigt misstag.

  1. Kartlägg identifierare först. Använd applikations-ID:t eller kandidat-UUID:t i varje anrop så att resultat bifogas rätt post istället för att bli föräldralösa, en fallgrop som flaggas i JobCannons integrationsvägledning.
  2. Välj ett autentiseringsmönster. De flesta plattformar använder API-nycklar, partnernycklar eller OAuth, och var och en kräver sin egen säkra lagring och rotationspolicy.
  3. Följ standardanropssekvensen. Lista paket med assessment.list, utlös testet med assessment.start, lyssna sedan efter en webhook som aktiveras vid slutförande och skriv tillbaka resultatet.
  4. Hantera de dokumenterade svarskoderna. Ashby API-referensen för assessment.start listar 200, 409 och 422 som typiska svar, och din integration behöver ett definierat beteende för var och en.
  5. Definiera din resultatnyttolast. Planera för totala poäng, delpoäng, tidsstämplar, bilagor och eventuella anpassade attribut som ditt team vill filtrera på senare.
  6. Planera för hastighetsgränser. Begär kvotökningar innan perioder med hög anställningsvolym så att en stor mängd kandidatinbjudningar inte utlöser 429-fel mitt under en kampanj.

Proffstips: Lagra applikations-ID:t tillsammans med varje utgående och inkommande nyttolast, även i loggar, så att en misslyckad webhook enkelt kan spåras tillbaka till en specifik kandidat.

Arbetsgivare, inte leverantörer, bär den juridiska bördan av anställningstestning. EEOC:s vägledning om anställningstester och urvalsförfaranden gör klart att urvalsverktyg måste vara validerade och jobbrelerade, och att arbetsgivare förblir ansvariga för disparate impact även när en tredje part byggde testet. Be vilken bedömningsleverantör som helst om valideringsdokumentation innan du integrerar deras verktyg i en aktiv rekryteringsprocess. Vår egen artikel om EEOC-testriktlinjer går igenom UGESP-krav mer detaljerat.

  • Begär validerings- och negativ-påverkan-dokumentation från vilken bedömningsleverantör som helst innan driftsättning.
  • Lagra bedömningsresultat med en tydlig granskningslogg och en definierad lagringsperiod, inte på obestämd tid.
  • Fråga leverantörer hur de loggar samtycke för proctoring eller webbkameraövervakning, och om en konsekvensbedömning för dataskydd är tillämplig.
  • Dokumentera din valideringsgranskning, kör en pilotmässig rättvisekontroll på tidiga resultat och håll beviserna i arkivet.

Vår spelbok för testning av negativ påverkan beskriver hur du kör den pilotanalysen och vad du ska åtgärda när siffrorna ser ojämna ut.

Välja mellan inbyggd integration, enhetligt API och anpassad lösning

Innan du förbinder dig till ingenjörstid, gå igenom en kort checklista tillsammans med dina HR- och ingenjörsledare.

  • Bekräfta vilka funktioner ATS:en stöder inbyggt kontra vilka som kräver en lösning.
  • Fråga vilken bedömningsleverantör som helst om de redan stöder din ATS, och om partneronboarding innebär en avgift eller ett prenumerationskrav, eftersom vissa plattformar låser integreringsmoduler bakom högre nivåer, enligt Coderbytes jämförelse av bedömningsplattformsintegrationer.
  • Verifiera att återskrivning inkluderar strukturerade poäng, inte bara en länk eller bilaga, så att rekryterare kan filtrera efter resultat.
  • Definiera webhook-tillförlitlighet och återförsöksförväntningar i förväg, och ange vem som äger övervakningen på båda sidor.
  • Bekräfta att leverantören kan tillhandahålla valideringsdokumentation, anti-fuskkontroller och ett databehandlingsavtal.

Proffstips: Be om en sandlådemiljö innan du skriver på något. En leverantör som inte kan demonstrera ett testwebhook som aktiveras från start till slut är inte redo för din produktionsmiljö.

Testa integrationen från start till slut och fånga fel tidigt

En stagingmiljö bör simulera hela livscykeln innan någon riktig kandidat rör den: skapa en testbeställning, utlös webhooken manuellt och bekräfta att resultatet renderas korrekt i ATS-gränssnittet, inte bara i en databaspost.

  1. Kör stagningtester som täcker paketlistning, beställningsskapande och resultatåterskrivning mot realistiska exempeldata.
  2. Spåra webhook-framgångsfrekvenser och feltrender, och bygg en avstämningsrapport som flaggar föräldralösa resultat innan de hopar sig.
  3. Använd korrelations-ID:n på varje begäran så att ett supportärende kan spåras mellan båda systemen på minuter, inte timmar.
  4. Bygg idempotent återförsökslogik så att ett återskickat webhook aldrig skapar ett dubblettsultat, och håll ett backfill-skript redo för eventuella missade händelser.
  5. Skriv en kort operativ spelbok som anger vem som varnas vid webhook-fel och hur man på ett säkert sätt kör om en fastnad beställning.

Var Talent Approved passar in i en ATS-integration

Talent Approveds plattform inkluderar en funktion som genererar rollspecifika bedömningar från jobbeskrivningar eller kompetenslistor, tillsammans med anti-fuskövervakning och AI-genererade sammanfattningar som påskyndar granskningen. På integrationssidan följer Talent Approved samma lista-, utlösnings- och återskrivningslivscykel som beskrivs ovan, och att kartlägga applikations-ID:t eller kandidat-UUID:t på varje anrop håller resultat korrekt kopplade till rätt ATS-post. Prismodellen är betala-per-användning, en avgift på 5 USD per genomförd kandidat, med ingen prenumeration krävs. Team som implementerar integrationen kan också läsa vår guide om hur omedelbara bedömningar fungerar och våra EEOC-efterlevnadsresurser för implementerings- och valideringsdetaljer.

Var Talent Approved passar in i en ATS-integration — översiktsdiagram

Vad HR-team gör fel när det gäller ATS-integration

Vad HR-team gör fel när det gäller ATS-integration — översiktsdiagram

De flesta team behandlar alla ATS API:er likadant och blir sedan förvånade när deras "bedömningsintegration" visar sig vara en stadie-ändringslyssnare utan någon strukturerad poängsättning. Lösningen är inte fler ingenjörstimmar. Det är att verifiera, redan den första dagen, om ett riktigt bedömnings-API alls existerar.

Börja med ett litet pilotprojekt på en enda öppen roll innan du rör hela din rekryteringsprocess. Titta på två saker samtidigt: om rekryterare faktiskt använder poängfiltreringen, och om tidiga resultat visar några rättvisegap mellan kandidatgrupper. När ett inbyggt bedömnings-API eller ett beprövat enhetligt API finns tillgängligt, välj det. Rekryterarupplevelse och juridisk försvarsbarhet beror båda på strukturerade, filterbara resultat, inte en lösning påklistrad på ett allmänt API.

— Jimmie

Utvecklardokumentation och regelefterlevnadsvägledning värda att bokmärka

Håll Ashbys dokumentation för bedömningsintegration, översikten för det enhetliga bedömnings-API:et och EEOC:s testvägledning nära till hands. För ingenjörsstöd på integrationssidan specialiserar sig företag som Ampersand på API- och webhook-implementeringsarbete.

Källor

Vanliga frågor

Vad betyder ATS-integration?

ATS-integration innebär att ett system för kandidathantering kopplas till ett annat verktyg, till exempel en bedömningsplattform, så att data rör sig automatiskt mellan dem istället för att kopieras manuellt. För bedömningar specifikt innebär det att lista testpaket, utlösa ett test för en kandidat och skriva tillbaka poängen till kandidatens ATS-post.

Vilka är de främsta ATS-systemen?

Det finns ingen enskild officiell ranking av de bästa ATS-plattformarna, och rätt val beror på företagets storlek, anställningsvolym och nödvändiga integrationer. Istället för att namnge specifika leverantörer bör HR-team utvärdera vilken ATS som helst utifrån om den exponerar ett dokumenterat bedömnings-API, som beskrivs i Ashbys utvecklardokumentation, snarare än att förlita sig på allmänna popularitetslistor.

Vad är skillnaden mellan ett ATS och ett CRM?

Ett ATS hanterar rekryteringsarbetsflödet för öppna tjänster och spårar kandidater från ansökan till erbjudande. Ett rekryterande CRM hanterar istället långsiktiga relationer med potentiella kandidater, inklusive personer som inte aktivt söker jobb, vilket är en annan uppgift än att spåra aktiva sökande genom en rekryteringsprocess.

Vad står ATS för?

ATS står för applicant tracking system (system för kandidathantering), den programvara HR-team använder för att publicera jobb, samla in ansökningar och flytta kandidater genom rekryteringsstegen. När det stöder ett dedikerat bedömnings-API kan det också utlösa kompetensprov och ta emot strukturerade resultat direkt på kandidatposten, enligt integrationens livscykel som beskrivs i Ashbys API-referens.