Search Adaface test library by skills or roles
⌘ K
Product

Integration Partner API

Vi har oprettet Integration Partner API for at give vores partnere mulighed for problemfrit at integrere Adaface-vurderinger i deres workflow. Dette dokument beskriver de tekniske detaljer om, hvordan integrationen implementeres.

Arbejder med Adaface for at implementere integrationen

En Adaface Account Manager vil arbejde sammen med en integrationspartner gennem hele integrationsprocessen for problemfri onboarding til integrationen. Hvis du ikke har en kontoadministrator endnu, så skriv til [email protected], så kontakter vi dig inden for 24 timer.

Workflow

Ved at bruge vores integrations-API'er kan markedspladspartnere skabe en engagerende oplevelse til kompetencevurdering for fælles kunder.

  1. Efter at have modtaget API-nøglen til en fælles kunde fra Adaface-kontoadministratoren, kan en integrationspartner bruge List Tests API-slutpunkt til at hente listen over vurderinger, der er tilgængelige til at sende til kandidater for den pågældende kunde.
  2. Integration Partner er åben for at bruge UX, der passer bedst ind i deres platform, så fælles kunde kan sende en vurdering til en bestemt kandidat. Partner kan bruge vores Send Test API-slutpunkt til at fortælle os om kandidatoplysninger og den anmodede vurdering, der skal sendes. Adaface sender automatisk en e-mail-invitation til kandidaten og returnerer et sporbart unikt Adaface-id til invitationen.
  3. Når kandidaten har gennemført vurderingen, er resultaterne tilgængelige på Test Status API-slutpunktet. Integrationspartner forventes at polle vores API for at vide, hvornår vurderingen er færdig. Hvis integrationspartneren eventuelt har en PUSH API, uploader Adaface resultaterne på denne givne API straks, når kandidaten har gennemført vurderingen. For at konfigurere et PUSH API-flow skal du informere din Adaface-kontoadministrator.

API

Basis API-id

Vi opretter separate API-slutpunkter for hver partner, så det er problemfrit at tilpasse API'et, hvis det kræves. Få dit "partnerId" fra din Adaface-kontoadministrator.

List Tests API

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

Antag, at "pinkfloyd" er den unikke nøgle, som Adaface-manageren gav til vores fælles kunde, som giver den til partnerens team eller input til partneres dashboard. Lad os sige, at dit unikke partner-id, som vi gav dig, er "rambo". Så vil anmodningen være

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

Svar på denne API-anmodning er et JSON-array, hvor hvert enkelt array-element har nedenstående skema:

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

Du kan bruge denne liste i din UI/UX, så den fælles kunde kan vælge en bestemt vurdering, der er tilgængelig for dem. Eksempel 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" } ]

Send 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> } }

Lad os sige, at gensidig klient valgte at sende "Software Engineer Test" (tjek eksempelsvar fra ovenstående List Tests API) til en kandidat med e-mail-id som "[email protected]" og navn som "John Doe", hvor den unikke kundenøgle er "pinkfloyd " og partnerId er "rambo". Sådan ser anmodningen ud:

 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å denne API-anmodning er et objekt med én nøgle "partner_interview_id". Partnere forventes at gemme dette internt for at hente resultaterne senere. (Du kan eventuelt give os en PUSH url, så vi skubber resultaterne til dit slutpunkt i stedet for. Tal med din vurderingspartner for en sådan integration). Eksempel svar:

 { "partner_inteview_id": "12345678" }

Test 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 polle vores teststatus API for at kende status for den sendte test. Her er svaret på en sådan anmodning:

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

Hvis din UX kræver flere detaljer om resultaterne som "score", "maxScore" osv., så tal med din Adaface-manager, og vi sender flere metadata. For interview_id "12345678", antages partnerId som "rambo" og kundenøgle som "pinkfloyd". Her er prøveanmodningen og 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" }

Afprøvning

Til test vil Adaface Account Manager give integrationspartner en test Adaface-konto samt testkunde API-nøgle (sammen med partner-id).

Spørgsmål?

Kontakt os venligst på [email protected] for spørgsmål eller særlige ønsker.

P.S. Deltag i dine kammerater.
Abonner på nyhedsbrevet til hypergrowth.
Abonner her
Tjek andre populære indlæg
Design effektive tests Guider om, hvordan man ansætter Ansættelse af industrien tendenser Populær ansættelsespraksis Løn indsigt Teknologiske opdateringer og fremskridt Diverse

Vi vurderede flere af deres konkurrenter og fandt, at Adaface var den mest overbevisende. Fantastisk standardbibliotek med spørgsmål, der er designet til at teste for pasform snarere end memorering af algoritmer.

swayam profile image
Swayam
CTO, Affable
Brug det mest kandidatvenlige vurderingsværktøj
Prøv gratis

(100% gratis at komme i gang, intet kreditkort kræves)

Vilkår Privatliv Tillidsvejledning