Récupérer les Cvs de vos candidats

Vous pouvez récupérer le(s) CV(s) de vos candidats grâce à l'API.

Requête

Cette méthode permet de récupérer le(s) CV(s) de vos candidats :

GET /company/{companyID}/files/expire?key={Clé_CV}&extension={Extension_CV}&token={Clé_API}

Pour récupérer les CVs des candidats vous aurez besoin de:

• votre clé API (ou token)
• la clé CV
• l'extension du CV

La clé CV et l'extension peuvent être récupéré de différentes façons:

• via le webhook "nouveau candidat" dans la propriété "cv"
• via la récupération de candidat

Important

La Clé API est valable 365 jours et expire automatiquement. Nous déclenchons une alerte 15 jours avant leur expiration. Vous pouvez créé votre clé API et retrouver ces informations à cette adresse : https://app.flatchr.io/board/settings/advanced/api

Limitation du débit

Cette route API est soumise à une limitation de débit de 1 requête par seconde et par compagnie.

Si plusieurs requêtes sont envoyées pour une même compagnie dans un intervalle inférieur à une seconde, les requêtes excédentaires peuvent être rejetées avec une réponse HTTP 429 Too Many Requests.

Nous recommandons aux clients API de :

• limiter leurs appels à 1 requête par seconde par compagnie ;
• mettre en place une stratégie de retry avec backoff en cas de réponse 429 ;
• éviter les appels concurrents pour une même compagnie sur cette route.

Exemple via le webhook "nouveau candidat"

"cv": {
  "fileable_id": 3935678,
  "fileable_type": "candidates",
  "id": 3929083,
  "url": "flatchr.s3.eu-west-1.amazonaws.com/candidates/2024/01/c18f5238-a774-4609-8d59-f022a8f781db/ivern-elsa.pdf",
  "key": "candidates/2024/01/c18f5238-a774-4609-8d59-f022a8f781db/ivern-elsa",
  "type": "CV",
  "created_at": "2023-12-12T15:58:43.942Z",
  "updated_at": "2024-01-09T12:23:39.544Z",
  "extension": "pdf"
}

Paramètres

Paramètre	In	Type	Obligatoire	Description	Exemple
companyId	path	string	✔️	Identifiant de l'entreprise	Wy3EOp2NP3p1KMq8
key	query	string	✔️	Clé unique de votre CV disponible via le webhook	candidates/2024/01/c18f5238-a774-4609-8d59-f022a8f781db/ivern-elsa
extension	query	string	✔️	Extension du document	pdf
token	query	string	✔️	Token permettant d'accéder à l'API	xxxxxxxxxx

Exemple de requête

curl -X GET https://api.flatchr.io/company/2zNDRr9BMnYqXyEK/files/expire?key=candidates/2024/01/c18f5238-a774-4609-8d59-f022a8f781db/ivern-elsa&extension=pdf&token=XXXXXXX