Search Adaface test library by skills or roles
⌘ K
Product

Integration Partner API

Vi har skapat Integration Partner API för att göra det möjligt för våra partners att sömlöst integrera Adaface-bedömningar i sitt arbetsflöde. Detta dokument beskriver de tekniska detaljerna för hur man implementerar integrationen.

Arbetar med Adaface för att implementera integrationen

En Adaface-kontoansvarig kommer att arbeta med en integrationspartner under hela integrationsprocessen för sömlös introduktion till integrationen. Om du inte har en kontoansvarig än, vänligen skriv till [email protected], så tar vi kontakt inom 24 timmar.

Arbetsflöde

Med hjälp av våra integrations-API:er kan marknadsplatspartner skapa en engagerande upplevelse för kompetensbedömning för gemensamma kunder.

  1. Efter att ha mottagit API-nyckeln för en gemensam kund från Adaface-kontoansvarig kan en integrationspartner använda List Tests API-slutpunkt för att hämta listan över bedömningar som är tillgängliga för att skicka till kandidater för just den kunden.
  2. Integration Partner är öppen för att använda UX som passar bäst i deras plattform så att gemensamma kunder kan skicka en bedömning till en viss kandidat. Partner kan använda vårt Send Test API-slutpunkt för att informera oss om kandidatdetaljer och den begärda bedömningen som ska skickas. Adaface skickar automatiskt en e-postinbjudan till kandidaten och returnerar ett spårbart unikt Adaface-id för inbjudan.
  3. När kandidaten har slutfört bedömningen är resultaten tillgängliga på Test Status API-slutpunkten. Integrationspartner förväntas polla vårt API för att veta när bedömningen är klar. Alternativt, om integrationspartnern har ett PUSH API, laddar Adaface upp resultaten på detta givna API direkt när kandidaten har slutfört bedömningen. För att ställa in ett PUSH API-flöde, informera din Adaface-kontoansvarig.

API

Bas API-id

Vi skapar separata API-slutpunkter för varje partner så att det är sömlöst att anpassa API:et om det behövs. Få ditt "partnerId" från din Adaface-kontoansvarig.

Lista Tests API

 GET: https://www.adaface.com/app/api/integrations/<partnerId>/list_tests HEADERS: Authorization: Basic <unique customer key>

Anta att "pinkfloyd" är den unika nyckeln som Adaface-chefen gav till vår gemensamma kund som ger den till partners team eller input till partners instrumentpanel. Säg, ditt unika partner-ID som vi gav dig är "rambo". Då blir begäran

 curl 'https://www.adaface.com/app/api/integrations/rambo/list_tests' -H "Authorization: Basic pinkfloyd"

Svaret på denna API-begäran är en JSON-array där varje enskilt arrayelement har nedanstående schema:

 { "partner_test_id": <testId> "partner_test_name": <testName> }

Du kan använda den här listan i ditt användargränssnitt/UX för den gemensamma kunden att välja en viss bedömning som är tillgänglig för dem. Exempel på svar:

 [ { "partner_test_id": "cool-dragon-23", "partner_test_name:: "Software Engineer Test" }, { "partner_test_id": "small-mouse-33", "partner_test_name": "Javascript Developer Test" } ]

Skicka test-API

 POST: https://www.adaface.com/app/api/integrations/<partnerId>/send_test HEADERS: authorization: Basic <unique customer key> BODY: { partner_test_id: <testId that mutual client chose. available from list tests api>, candidate: { first_name: <first name of candidate>, last_name: <last name of candidate>, phone_number: <phone number of candidate>, email: <email id of candidate. Required> } }

Låt oss säga att den ömsesidiga klienten valde att skicka "Software Engineer Test" (kontrollera exempelsvaret från List Tests API ovan) till en kandidat med e-post-ID som "[email protected]" och namnet som "John Doe" där den unika kundnyckeln är "pinkfloyd" " och partnerId är "rambo". Så här ser begäran ut:

 curl -X POST 'https://www.adaface.com/app/api/integrations/rambo/send_test' -H "Authorization: Basic pinkfloyd" { "partner_test_id": "cool-dragon-23", "candidate": { "first_name": "John", "last_name": "Doe", "email": "[email protected]" } }

Svar på denna API-förfrågan är ett objekt med en nyckel "partner_interview_id". Partners förväntas spara detta internt för att hämta resultaten senare. (Valfritt kan du ge oss en PUSH-url så att vi skickar resultaten till din slutpunkt istället. Prata med din bedömningspartner för sådan integration). Exempel på svar:

 { "partner_inteview_id": "12345678" }

Testa status API

 GET: https://www.adaface.com/app/api/integrations/<partnerId>/test_status?partner_interview_id=<partnerInterviewId> HEADERS: Authorization Basic <unique customer key>

Du kan fråga vårt teststatus-API för att veta status för det skickade testet. Här är svaret på en sådan begäran:

 { "status": <status> // one of "pending", "completed" or "expired", "results_url": <url> // unique link for full detailed scorecard. present only when status is "completed" }

Om din UX kräver mer information om resultaten som "score", "maxScore" etc, prata med din Adaface-chef så skickar vi mer metadata. För interview_id "12345678", antar partnerId som "rambo" och kundnyckel som "pinkfloyd". Här är exempel på begäran och svaret:

 curl 'https://www.adaface.com/app/api/integrations/rambo/test_status?partner_interview_id=12345678' -H "Authorization: Basic pinkfloyd"
 { "status": "completed", "results_url": "https://www.adaface.com/app/scorecard/87654321" }

Testning

För testning kommer Adaface Account Manager att förse integrationspartner med ett Adaface-testkonto samt testkunds API-nyckel (tillsammans med partner-id).

Frågor?

Vänligen kontakta oss på [email protected] för eventuella frågor eller speciella önskemål.

P.S. Gå med i dina kamrater.
Prenumerera på nyhetsbrevet för hypergrowth.
Prenumerera på
Kontrollera andra populära inlägg
Design effektiva test Guider om hur man anställer Hyresindustrin trender Populära anställningspraxis Löneinsikt Tekniska uppdateringar och framsteg Diverse

Vi utvärderade flera av sina konkurrenter och fann Adaface att vara den mest övertygande. Bra standardbibliotek av frågor som är utformade för att testa för passform snarare än memorisering av algoritmer.

swayam profile image
Swayam
CTO, Affable
Använd det mest kandidatvänliga bedömningsverktyget
PROVA GRATIS

(100% GRATIS för att komma igång, inget kreditkort krävs)

Villkor Integritet Förtroendehandbok