Facecode.app API

These Endpoints are used to create and get results for the facial personality analysis on the FaceCode Platform.  We use the term ‘candidate’ for a person’s image who is to be analyzed by the faceCODE engine.

Requirements:

• You need to add the param x-api-key on the header of each of the endpoints.
• You need to add the param api-key on the request section (body/query)
• You can request the value of x-api-key and api-key params.

POST

Create candidate

Open Request  

https://api.facecode.app/candidate

This endpoint is for creating candidates. You need to add the x-api-key param on the header of the request.

Request Headers

x-api-key

Content-Type application/json

Bodyraw (json)

json

{

  "api_key": "{{ApiKey}}",

  "candidate": {

    "image_url": "",

    "first_name": "",

    "last_name": "",

    "email": ""

  }

}

GET

Get the Traits of a candidate Candidate

Open Request  

https://api.facecode.app/candidate/traits

This endpoint returns the personality traits of a candidate. You need to provide the the api-key and candidate id

Request Headers

x-api-key

Request Params

api_key

candidate

GET

Get the DiSC analysis values for a Candidate

Open Request  

https://api.facecode.app/candidate/disc

This endpoint returns the DiSC Report values of one candidate. You need to provide the api-key and the Candidate Id

Request Headers

x-api-key

Request Params

api_key

candidate

GET

Get the Careers recommendations for a candidate

Open Request  

https://api.facecode.app/candidate/careers

This endpoint returns the Career Recommendations values of one candidate.  You need to provide the api-key and the Candidate Id

Request Headers

x-api-key

Request Params

api_key

candidate