Joindre des fichiers
Ajouter à un lead envoyé un rapport, des photos : notre service client les a sous les yeux en rappelant.
Une fois le lead envoyé, joignez-y vos fichiers avec la référence que nous vous avons rendue : rapport d'intervention, devis, photos. Notre service client les voit sur la fiche du lead, et n'a pas à redemander ce qui y figure.
curl -X POST "https://api.kelkun.app/lead-providers/leads/V0YDH/attachments" \
-H "x-api-key: <votre clé>" \
-F "file=@rapport-recherche-de-fuite.pdf"Un fichier par appel, en multipart/form-data, dans le champ file. Pour plusieurs fichiers, un appel par fichier.
| Contrainte | Valeur |
|---|---|
| Types acceptés | PDF, JPEG, PNG, WebP, HEIC |
| Taille | 15 Mo au plus par fichier |
| Nombre | 20 fichiers au plus par lead |
Le type se lit dans l'envoi, ou à défaut dans l'extension du nom : un rapport.pdf envoyé en application/octet-stream est accepté.
Notre réponse
Un 201, avec le fichier tel que nous l'avons enregistré :
{
"id": "42bad25e-f4a7-4753-8d0e-d9c769d805f4",
"file_name": "rapport-recherche-de-fuite.pdf",
"mime_type": "application/pdf",
"size": 482113
}Vous ne pouvez joindre de fichier qu'aux leads envoyés avec votre clé. Un doublon vous a rendu la référence du lead d'origine : vos fichiers rejoignent ce lead-là.
Les refus
| HTTP | error | Cas |
|---|---|---|
| 400 | FILE_REQUIRED | Aucun fichier dans le champ file |
| 404 | LEAD_NOT_FOUND | Aucun lead de cette référence n'a été envoyé avec votre clé |
| 409 | ATTACHMENT_LIMIT_REACHED | Le lead a déjà 20 fichiers |
| 413 | FILE_TOO_LARGE | Plus de 15 Mo |
| 415 | UNSUPPORTED_FILE_TYPE | Ni PDF, ni JPEG, PNG, WebP ou HEIC |
Référence
Authentification
x-api-key La clé d'API que Kelkun vous a transmise.
Dans: header
Paramètres de chemin
La référence du lead, rendue à son envoi.
Corps de la requête
multipart/form-data
Types TypeScript
Le type à reprendre dans votre code TypeScript.
Corps de la réponse
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/lead-providers/leads/V0YDH/attachments" \ -F file="string"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "file_name": "rapport-recherche-de-fuite.pdf", "mime_type": "application/pdf", "size": 482113}