KelkunDéveloppeurs

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.

ContrainteValeur
Types acceptésPDF, JPEG, PNG, WebP, HEIC
Taille15 Mo au plus par fichier
Nombre20 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

HTTPerrorCas
400FILE_REQUIREDAucun fichier dans le champ file
404LEAD_NOT_FOUNDAucun lead de cette référence n'a été envoyé avec votre clé
409ATTACHMENT_LIMIT_REACHEDLe lead a déjà 20 fichiers
413FILE_TOO_LARGEPlus de 15 Mo
415UNSUPPORTED_FILE_TYPENi PDF, ni JPEG, PNG, WebP ou HEIC

Référence

POST
/lead-providers/leads/{reference}/attachments
x-api-key<token>

La clé d'API que Kelkun vous a transmise.

Dans: header

Paramètres de chemin

reference*string

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}

Sur cette page