Récupération d'une pièce jointe
Description
Récupère une pièce jointe (message, CV, lettre de motivation, ...) liée à une candidature.
Limites d'appels
En plus des règles générales, une même piece jointe ne peut être récupérée que 3 fois en 1h. Pensez à sauvegarder votre fichier une fois réceptionné.
Endpoint
GET https://api.mytalentplug.com/jam/v1/attachment/:attachmentId/:attachmentDate
Authentification
- Requise : Oui
- Type : Bearer Authentication
- Exemple d’en-tête :
Authorization: Bearer <token>
Requête
Paramètres de route
| Nom du paramètre | Type | Requis | Par défaut | Format | Exemple | Description |
|---|---|---|---|---|---|---|
attachmentId | string | Oui | — | UUID | a1b2c3d4-e5f6-7890-abcd-1234567890ef | Identifiant de la pièce jointe |
attachmentDate | string | Oui | — | ISO 8601 | 2025-01-01T00:00:00Z | Date de réception de la pièce jointe |
info
L'identifiant et la date de la pièce jointe sont obtenus via la requête de récupération des candidatures. Consultez cette page.
Réponse
Réponse 200 (succès)
Le fichier demandé a été récupéré avec succès. Il est renvoyé sous forme d’un tableau d’octets (byte array) dans le corps de la réponse. Les en-têtes HTTP accompagnant cette réponse fournissent les métadonnées nécessaires pour interpréter correctement le fichier retourné (type MIME, taille, nom du fichier).
Exemple de headers
| En-tête | Description |
|---|---|
Content-Type | Type MIME du fichier (ex: application/pdf, image/png, ...) |
Content-Length | Taille du fichier en octets. |
Content-Disposition | URL encodé. Contient le nom du fichier (ex: inline%3B%20filename%3DCV.pdf) |
Réponses d’erreur
| Code HTTP | Message | Description |
|---|---|---|
400 | Bad Request | Paramètre invalide (ex : identifiant au mauvais format) |
401 | Unauthorized | Jeton d’accès manquant ou invalide |
403 | Forbidden | Accès refusé |
429 | Too Many Requests | Trop de requêtes en un temps donné |
500 | Internal Server Error | Le serveur a rencontré un problème inattendu |
Exemple
{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
"title": "Bad Request",
"status": 400,
"detail": "Validation failed: \n -- AttachmentId: must be a valid GUID Severity: Error",
"traceId": "0HNC7SAR415OR:00000001",
"requestId": "00-95aa80055a8d08c5e5199dd7ce12c863-328e160c32605b83-00"
}
Exemple de requête avec curl
curl -X GET 'https://api.mytalentplug.com/jam/v1/attachment/a1b2c3d4-e5f6-7890-abcd-1234567890ef/2025-01-01T00:00:00Z' \
-H 'Authorization: Bearer <token>'