POST
Upload preuve de livraison (POD)
POST /APIs/external/carrier_upload_pod.php
Description
Envoyer une photo ou une signature électronique comme preuve de livraison (POD) pour une mission. Le fichier est stocké et référencé dans la mission.
Content-Type requis : multipart/form-data
Champs du formulaire
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| otr_id | int | Oui | ID de la mission |
| file ou document | fichier | Oui | Fichier à uploader. Formats : JPEG, PNG, WEBP |
| type_document | string | Non | photo (défaut) ou signature |
| signataire_nom | string | Non | Nom du signataire (pour les signatures) |
Exemple curl
curl -X POST "https://shippinova.com/APIs/external/carrier_upload_pod.php" \ -H "X-API-KEY: votre_cle_transporteur" \ -F "otr_id=1060" \ -F "type_document=photo" \ -F "file=@/chemin/vers/photo.jpg"
Réponse (succès)
{
"success": true,
"document_id": 98,
"otr_id": 1060,
"type_document": "photo",
"filename": "pod_1060_1722200000.jpg",
"url": "/uploads/pod/pod_1060_1722200000.jpg"
}
Codes d'erreur
| Code | Signification |
|---|---|
| 401 | Clé API absente |
| 402 | Abonnement inactif (essai terminé ou abonnement résilié) |
| 403 | Clé invalide, ou clé expéditeur utilisée sur un endpoint transporteur |
| 400 | Fichier absent, format invalide, ou otr_id manquant |
| 404 | Mission introuvable pour votre société |
| 429 | Trop de requêtes (120 par minute, 20 000 par jour) ; réessayer après Retry-After |
⚠️ Seuls les formats JPEG, PNG et WEBP sont acceptés. Taille maximale selon la configuration serveur.