Introduction
Bienvenue dans la documentation de l'API public de Tut Tut ! Cette documentation fournit toutes les informations nécessaires pour intégrer et utiliser notre API.
À propos de Tut Tut
Tut Tut est un service de livraison entre particuliers.
Nous faisons « matcher » vos demandes de livraison avec les véhicules de particuliers : les cotransporteurs.
Notre API permet aux développeurs de se connecter à notre service pour créer/gérer vos demandes de livraisons.
Comment utiliser notre API
Avant de pouvoir vous connecter et utiliser notre api, vous devez d’abord vous rendre sur notre site et créer un compte professionnel.
Votre compte doit obligatoirement être configuré en prélèvement et être considéré comme partenaire.
Nos différentes routes
Authentification
Cette route va vous permettre de récupérer votre token d’authentification.
Exemple d'appel
{
"username": "JDupont",
"password": "iYD(OAk!58@"
}
Réponse 200
{
"id": 1,
"token": "ea7gs4Arrfgs5...",
"lastname": "John",
"firstname": "Doe",
"avatar": null,
"roles": [
"ROLE_USER"
]
}
Réponse 400
{
"status": 400,
"code": "001",
"message": "Les paramètres sont incorrects ou insuffisants"
}
Réponse 403
{
"status": 403,
"code": "003",
"message": "L'authentification a échoué"
}
{
"status": 403,
"code": "040",
"message": "Oups ! Un compte particulier ou coursier existe déjà avec cet email. Veuillez utiliser une autre adresse mail ou créer un compte commerçant"
}
Requête
POST https://api.tut-tut.com/api/v1.1/utilisateur/login?username=&password=
Paramètres de requête
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
username | ✔️ | string | Votre nom d'utilisateur |
password | ✔️ | string | Votre mot de passe |
Devis
Cette route va nous permettre de créer une demande de devis et de retourner le prix de la livraison.
Exemple d'appel
{
"orderNumber": "987654",
"retailer": "9876543210",
"codeEnseigne": "1234",
"deliveryDateTimeMinimum": "2023-09-15T14:00:00Z",
"deliveryDateTimeMaximum": "2023-09-15T16:00:00Z",
"instructions": "Instructions de test génériques",
"customer": {
"firstName": "Jean",
"lastName": "Dupont",
"phoneNumber": "0123456789",
"email": "[email protected]"
},
"deliveryAddress": {
"full": "17 Rue de la Liberté, 75001 Paris, France",
"roadNumber": "17",
"road": "Rue de la Liberté",
"zipCode": "75001",
"city": "Paris",
"country": "FR",
"hasElevator": false,
"floor": 2,
"doorCode": "4321",
"latitude": 48.856613,
"longitude": 2.352222
},
"orderDetails": [
{
"ean": "67890",
"quantity": 2,
"label": "Chaise",
"type": "TYPOLOGY_GENERIC",
"serviceInstructions": "Fragile",
"width": {
"unit": "cm",
"value": 3
},
"height": {
"unit": "cm",
"value": 13
},
"weight": {
"unit": "kg",
"value": 2
},
"length": {
"unit": "cm",
"value": 3
}
}
],
"sendSMStoCustomer": true
}
Réponse 201
{
"quoteId": 1,
"price": {
"value": 9.0,
"currency": "EUR"
}
}
Réponse 205
{
"status": 205,
"code": "056",
"message": "Nous avons rencontré un problème lors du calcul de la taille de votre commande"
}
Réponse 401
{
"status": 401,
"code": "063",
"message": "Désolé, cette adresse est réservé à un de nos partenaire"
}
{
"status": 401,
"code": "052",
"message": "Désolé, cette demande de livraison n'entre pas dans le périmètre couvert par Tut tut"
}
{
"status": 401,
"code": "053",
"message": "Les dates de collecte et de livraison ne correspondent pas au service instantané de Tut Tut (Recommandé: la récupération et la livraison doivent commencer le même jour)"
}
{
"status": 401,
"code": "054",
"message": "Les heures de collecte et de livraison ne correspondent a aucun créneau commun Tut tut (Recommandé: Choisir une horaire commune le plus large possible)"
}
Réponse 403
{
"status": 403,
"code": "079",
"message": "Vous devez nous fournir un numéro de commande pour pouvoir l'associer à notre référence interne"
}
{
"status": 403,
"code": "071",
"message": "Le total de l'expedition dépasse le poids maximum accepté"
}
{
"status": 403,
"code": "069",
"message": "La typologie des produits est vide, inconnue ou non prise en charge par Tut tut"
}
Réponse 404
{
"status": 404,
"code": "037",
"message": "Impossible de géocoder l'adresse"
}
{
"status": 403,
"code": "038",
"message": "Votre commande ne correspond pas aux tailles de colis que Tut Tut peut prendre en charge"
}
Request
POST https://api.tut-tut.com/public/api/v1.0/public/quote
Header
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Authorization | ✔️ | string | Le token que vous récupérez après vous être authentifié avec la route login précédé du mot “Bearer” |
Body
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
orderNumber | ✔️ | string | Numéro de commande |
retailer | ✔️ | string | Numéro de retailer (à configurer) |
codeEnseigne | ✔️ | string | Numéro de d’enseigne (à configurer) |
deliveryDateTimeMinimum | ✔️ | string | Créneau début de livraison |
deliveryDateTimeMaximum | ✔️ | string | Créneau de fin de livraison |
instructions | ✔️ | string | Instruction générale |
customer | ✔️ | [objet] | Informations du Client |
- firstName | ✔️ | string | Nom |
- lastName | ✔️ | string | Prénom |
- phoneNumber | ✔️ | string | Numéro de téléphone |
string | |||
deliveryAddress | ✔️ | [objet] | Adresse de livraison |
- full | string | Adresse complète | |
- roadNumber | string | Numéro de rue | |
- road | string | Rue | |
- zipCode | string | Code postal | |
- city | string | Ville | |
- country | string | Pays (seulement 2 caractères) | |
- hasElevator | booléen | Ascenceur | |
- floor | int | Etage | |
- doorCode | string | Code porte | |
- latitude | ✔️ | float | Latitude |
- longitude | ✔️ | float | Longitude |
orderDetails | ✔️ | {[Liste d'objets]} | Détail des colis |
- ean | string | Numéro Ean du colis | |
- quantity | int | Quantité | |
- label | string | Libellé | |
- type | string | Type (TYPOLOGY_GENERIC, TYPOLOGY_FRESH, TYPOLOGY_FROZEN, TYPOLOGY_FRAGILE) | |
- serviceInstructions | string | Instructions pour le colis | |
- width | [objet] | Largeur | |
- unit | string | Unité (mm, cm, m) | |
- value | int | Valeur | |
- height | [objet] | Hauteur | |
- unit | string | Unité (mm, cm, m) | |
- value | int | Valeur | |
- weight | [objet] | Poids | |
- unit | string | Unité (kg) | |
- value | int | Valeur | |
- length | [objet] | Longueur | |
- unit | string | Unité (mm, cm, m) | |
- value | int | Valeur | |
sendSmsToCustomer | booléen | Autorisation d’envoi de SMS (si vous souhaitez que l’on en envoie un pour vous) |
Livraison
Cette route va nous permettre de créer une livraison à partir d’un devis ou non.
Exemple d'appel
{
"quoteId": "1",
"orderNumber": "987654",
"retailer": "9876543210",
"codeEnseigne": "1234",
"deliveryDateTimeMinimum": "2023-09-15T14:00:00Z",
"deliveryDateTimeMaximum": "2023-09-15T16:00:00Z",
"instructions": "Instructions de test génériques",
"customer": {
"firstName": "Jean",
"lastName": "Dupont",
"phoneNumber": "0123456789",
"email": "[email protected]"
},
"picking": {
"info": {
"libelle": "Décathlon Paris",
"email": "[email protected]",
"phone": "0123456789",
"siret": "01541415121514"
},
"address": {
"full": "17 rue de la republique, 84000 Avignon, France",
"roadNumber": "17",
"road": "rue de la republique",
"zipCode": "84000",
"city": "Avignon",
"country": "FR",
"hasElevator": false,
"floor": 2,
"doorCode": "4321",
"latitude": 43.835369,
"longitude": 4.580038
}
},
"deliveryAddress": {
"full": "17 Rue de la Liberté, 75001 Paris, France",
"roadNumber": "17",
"road": "Rue de la Liberté",
"zipCode": "75001",
"city": "Paris",
"country": "FR",
"hasElevator": false,
"floor": 2,
"doorCode": "4321",
"latitude": 48.856613,
"longitude": 2.352222
},
"orderDetails": [
{
"ean": "67890",
"quantity": 2,
"label": "Chaise",
"type": "TYPOLOGY_GENERIC",
"serviceInstructions": "Fragile",
"width": {
"unit": "cm",
"value": 3
},
"height": {
"unit": "cm",
"value": 13
},
"weight": {
"unit": "kg",
"value": 2
},
"length": {
"unit": "cm",
"value": 3
}
}
],
"sendSMStoCustomer": true
}
Réponse 201
{
"referenceNumber": "123456789",
"deliveryId": 1,
"statut": "UNASSIGNED",
"deliveryDateTimeMinimum": "2023-09-15T14:00:00Z",
"deliveryDateTimeMaximum": "2023-09-15T16:00:00Z"
}
"Attention si vous utilisez un numéro de commande déjà utilisé avec notre outil,
la commande ne sera pas créée et vous recevrez un retour comme ci dessous."
{
"referenceNumber": "123456789",
"deliveryId": 1,
"statut": "<statut>",
"deliveryDateTimeMinimum": "2023-09-15T14:00:00Z",
"deliveryDateTimeMaximum": "2023-09-15T16:00:00Z"
}
Réponse 205
{
"status": 205,
"code": "056",
"message": "Nous avons rencontré un problème lors du calcul de la taille de votre commande"
}
Réponse 401
{
"status": 401,
"code": "063",
"message": "Désolé, cette adresse est réservé à un de nos partenaire"
}
{
"status": 401,
"code": "025",
"message": "Le compte Stripe est inconnu ou mal configuré"
}
{
"status": 401,
"code": "054",
"message": "Les heures de collecte et de livraison ne correspondent a aucun créneau commun Tut tut (Recommandé: Choisir une horaire commune le plus large possible)"
}
{
"status": 401,
"code": "053",
"message": "Les dates de collecte et de livraison ne correspondent pas au service instantané de Tut Tut (Recommandé: la récupération et la livraison doivent commencer le même jour)"
}
{
"status": 401,
"code": "052",
"message": "Désolé, cette demande de livraison n'entre pas dans le périmètre couvert par Tut tut"
}
Réponse 403
{
"status": 403,
"code": "070",
"message": "Le numéro de téléphone fourni n’est pas conforme"
}
{
"status": 403,
"code": "079",
"message": "Vous devez nous fournir un numéro de commande pour pouvoir l'associer à notre référence interne"
}
{
"status": 403,
"code": "071",
"message": "Le total de l'expedition dépasse le poids maximum accepté"
}
{
"status": 403,
"code": "069",
"message": "La typologie des produits est vide, inconnue ou non prise en charge par Tut tut"
}
Réponse 404
{
"status": 404,
"code": "037",
"message": "Impossible de géocoder l'adresse"
}
{
"status": 404,
"code": "038",
"message": "Votre commande ne correspond pas aux tailles de colis que Tut Tut peut prendre en charge"
}
Request
POST https://api.tut-tut.com/public/api/v1.0/public/valideQuote
Header
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Authorization | ✔️ | string | Le token que vous récupérez après vous être authentifié avec la route login précédé du mot “Bearer” |
Body
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
quoteId | string | Numéro de devis | |
orderNumber | ✔️ | string | Numéro de commande |
retailer | ✔️ | string | Numéro de retailer (à configurer) |
codeEnseigne | ✔️ | string | Numéro de d’enseigne (à configurer) |
deliveryDateTimeMinimum | ✔️ | string | Créneau début de livraison |
deliveryDateTimeMaximum | ✔️ | string | Créneau de fin de livraison |
instructions | ✔️ | string | Instruction générale |
customer | ✔️ | [objet] | Informations du Client |
- firstName | ✔️ | string | Nom |
- lastName | ✔️ | string | Prénom |
- phoneNumber | ✔️ | string | Numéro de téléphone |
string | |||
picking> | [objet] | Retrait | |
- info | [objet] | information du PDV | |
- libelle | string | Libellé | |
string | |||
- phone | string | Numéro de téléphone | |
- siret | string | Numéro de siret | |
- address | [objet] | Adresse | |
- full | string | Adresse complète | |
- roadNumber | string | Numéro de rue | |
- road | string | Rue | |
- zipCode | string | Code postal | |
- city | string | Ville | |
- country | string | Pays (seulement 2 caractères) | |
- hasElevator | booléen | Ascenceur | |
- floor | int | Etage | |
- doorCode | string | Code porte | |
- latitude | float | Latitude | |
- longitude | float | Longitude | |
deliveryAddress | ✔️ | [objet] | Adresse de livraison |
- full | string | Adresse complète | |
- roadNumber | string | Numéro de rue | |
- road | string | Rue | |
- zipCode | string | Code postal | |
- city | string | Ville | |
- country | string | Pays (seulement 2 caractères) | |
- hasElevator | booléen | Ascenceur | |
- floor | int | Etage | |
- doorCode | string | Code porte | |
- latitude | ✔️ | float | Latitude |
- longitude | ✔️ | float | Longitude |
orderDetails | ✔️ | {[Liste d'objets]} | Détail des colis |
- ean | string | Numéro Ean du colis | |
- quantity | int | Quantité | |
- label | string | Libellé | |
- type | string | Type (TYPOLOGY_GENERIC, TYPOLOGY_FRESH, TYPOLOGY_FROZEN, TYPOLOGY_FRAGILE) | |
- serviceInstructions | string | Instructions pour le colis | |
- width | [objet] | Largeur | |
- unit | string | Unité (mm, cm, m) | |
- value | int | Valeur | |
- height | [objet] | Hauteur | |
- unit | string | Unité (mm, cm, m) | |
- value | int | Valeur | |
- weight | [objet] | Poids | |
- unit | string | Unité (kg) | |
- value | int | Valeur | |
- length | [objet] | Longueur | |
- unit | string | Unité (mm, cm, m) | |
- value | int | Valeur | |
sendSmsToCustomer | ✔️ | booléen | Autorisation d’envoi de SMS (si vous souhaitez que l’on en envoie un pour vous) |
Démarrer une livraison
Cette route va vous permettre de démarrer une livraison.
Réponse 200
{
"message": "L’expédition a bien été démarré.",
"deliveryId": "1",
"referenceNumber": "123456789",
"statut": "<statut>",
"deliveryDateTimeMinimum": "2023-09-15T14:00:00Z",
"deliveryDateTimeMaximum": "2023-09-15T16:00:00Z"
}
Réponse 401
{
"status": 401,
"code": "020",
"message": "Erreur de sécurité."
}
{
"status": 401,
"code": "052",
"message": "Le client demandé n’existe pas dans notre base de donnée en tant que partenaire"
}
{
"status": 401,
"code": "063",
"message": "Désolé, cette adresse est réservé à un de nos partenaire"
}
Réponse 403
{
"status": 403,
"code": "068",
"message": "L’expédition que vous essayez de modifier n’existe pas"
}
{
"status": 403,
"code": "004",
"message": "L’expédition n’est plus disponible"
}
{
"status": 403,
"code": "060",
"message": "Vous ne pouvez pas modifier cette expédition pour le moment, veuillez nous contacter"
}
Requête
PATCH https://api.tut-tut.com/public/api/v1.0/public/start/{codeEnseigne}/{referenceNumber}
Header
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Authorization | ✔️ | string | Le token que vous récupérez après vous être authentifié avec la route login précédé du mot “Bearer” |
Paramètres de requête
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
codeEnseigne | ✔️ | string | Numéro de l’enseigne de l’expédition |
referenceNumber | ✔️ | string | Numéro référence de la livraison |
Terminer une livraison
Cette route va vous permettre de terminer une livraison.
Réponse 200
{
"message": "L’expédition a bien été terminée.",
"deliveryId": "1",
"referenceNumber": "123456789",
"statut": "<statut>",
"deliveryDateTimeMinimum": "2023-09-15T14:00:00Z",
"deliveryDateTimeMaximum": "2023-09-15T16:00:00Z"
}
Réponse 401
{
"status": 401,
"code": "020",
"message": "Erreur de sécurité."
}
{
"status": 401,
"code": "052",
"message": "Le client demandé n’existe pas dans notre base de donnée en tant que partenaire"
}
{
"status": 401,
"code": "063",
"message": "Désolé, cette adresse est réservé à un de nos partenaire"
}
Réponse 403
{
"status": 403,
"code": "068",
"message": "L’expédition que vous essayez de modifier n’existe pas"
}
{
"status": 403,
"code": "004",
"message": "L’expédition n’est plus disponible"
}
{
"status": 403,
"code": "060",
"message": "Vous ne pouvez pas modifier cette expédition pour le moment, veuillez nous contacter"
}
Requête
DELETE https://api.tut-tut.com/public/api/v1.0/public/finish/{codeEnseigne}/{referenceNumber}
Header
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Authorization | ✔️ | string | Le token que vous récupérez après vous être authentifié avec la route login précédé du mot “Bearer” |
Paramètres de requête
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
codeEnseigne | ✔️ | string | Numéro de l’enseigne de l’expédition |
referenceNumber | ✔️ | string | Numéro référence de la livraison |
Modifier une livraison
Cette route va vous permettre de modifier une livraison.
Exemple d'appel
{
"deliveryDateTimeMinimum": "2023-09-15T14:00:00Z",
"deliveryDateTimeMaximum": "2023-09-15T16:00:00Z",
"instructions": "Instructions de test génériques",
"customer": {
"firstName": "Jean",
"lastName": "Dupont",
"phoneNumber": "0123456789"
}
}
Réponse 200
{
"message": "L’expédition a bien été modifié.",
"deliveryId": "1",
"referenceNumber": "123456789",
"statut": "<statut>",
"deliveryDateTimeMinimum": "2023-09-15T14:00:00Z",
"deliveryDateTimeMaximum": "2023-09-15T16:00:00Z"
}
Réponse 401
{
"status": 401,
"code": "020",
"message": "Erreur de sécurité."
}
{
"status": 401,
"code": "063",
"message": "Désolé, cette adresse est réservé à un de nos partenaire"
}
Réponse 403
{
"status": 403,
"code": "068",
"message": "L’expédition que vous essayez de modifier n’existe pas"
}
{
"status": 403,
"code": "004",
"message": "L’expédition n’est plus disponible"
}
{
"status": 403,
"code": "060",
"message": "Vous ne pouvez pas modifier cette expédition pour le moment, veuillez nous contacter"
}
Requête
PATCH https://api.tut-tut.com/public/api/v1.0/public/update/{codeEnseigne}/{referenceNumber}
Header
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Authorization | ✔️ | string | Le token que vous récupérez après vous être authentifié avec la route login précédé du mot “Bearer” |
Paramètres de requête
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
codeEnseigne | ✔️ | string | Numéro de l’enseigne de l’expédition |
referenceNumber | ✔️ | string | Numéro référence de la livraison |
Body
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
deliveryDateTimeMinimum | string | Date de livraison | |
deliveryDateTimeMaximum | string | Créneau de début de livraison | |
instructions | string | Instruction générale | |
customer | [objet] | Informations du client | |
- firstName | string | Nom | |
- lastName | string | Prénom | |
- phoneNumber | string | Numéro de téléphone |
Supprimer une livraison
Cette route va vous permettre de supprimer une livraison.
Réponse 200
{
"referenceNumber": "123456789",
"deliveryId": "1",
"message": "L’expédition a bien été supprimée."
}
Réponse 205
{
"status": 205,
"code": "28",
"message": "Vous ne pouvez plus annuler une livraison dont la date est dépassée, Veuillez nous contacter."
}
{
"status": 205,
"code": "59",
"message": "Vous avez dépassé l’heure autorisée pour annuler cette expédition, veuillez nous contacter."
}
Réponse 401
{
"status": 401,
"code": "020",
"message": "Erreur de sécurité."
}
{
"status": 401,
"code": "063",
"message": "Désolé, cette adresse est réservé à un de nos partenaire"
}
Réponse 403
{
"status": 403,
"code": "068",
"message": "L’expédition que vous essayez de modifier n’existe pas"
}
{
"status": 403,
"code": "004",
"message": "L’expédition n’est plus disponible"
}
{
"status": 403,
"code": "055",
"message": "Vous ne pouvez pas supprimer une course au status en cours ou terminé."
}
Requête
DELETE https://api.tut-tut.com/public/api/v1.0/public/delete/{codeEnseigne}/{referenceNumber}
Header
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Authorization | ✔️ | string | Le token que vous récupérez après vous être authentifié avec la route login précédé du mot “Bearer” |
Paramètres de requête
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
codeEnseigne | ✔️ | string | Numéro de l’enseigne de l’expédition |
referenceNumber | ✔️ | string | Numéro référence de la livraison |
Webhooks
Nos livraisons disposent de différents statuts :
- UNASSIGNED (non réservée)
- TEAM_ASSIGNED (réservée)
- IN_PROGRESS (démarée)
- DELIVERED (terminée)
- DELIVERY_CANCELLED (Supprimée) Si une expédition est relachée, le statut UNASSIGNED vous sera envoyé. Si une expédition se termine sans que le colis soit livré (destinataire absent etc..), le statut ABANDONED sera renvoyé
Si vous souhaitez avoir un retour lorsque votre livraison change de statut, contactez-nous pour configurer vos différents endpoints pour recevoir en temps réel les changements apportés sur vos livraisons.
L’url que l’on utilisera pour envoyer un retour contiendra le code enseigne.
Exemple: votre-url/status/32 (32 est un exemple de code enseigne)
Pour pouvoir recevoir les retours, il faut nous fournir une api key que l’on pourra utiliser dans les requêtes. Cette ApiKey sera utilisée dans notre header avec la key “x-api-key”.
Nous communiquons différentes informations à travers les additonalInfos (litige, retard, pas de destinataire).
Réponse Réservée
{
"deliveryId": 1,
"referenceNumber": "123456789",
"statut": "TEAM_ASSIGNED",
"deliveryDateTimeMinimum": "2023-09-15T14:00:00Z",
"deliveryDateTimeMaximum": "2023-09-15T16:00:00Z",
"additionalInfos": ["Informations sur l’expéditon"]
}
Réponse En cours
{
"deliveryId": 1,
"referenceNumber": "123456789",
"statut": "IN_PROGRESS",
"deliveryDateTimeMinimum": "2023-09-15T14:00:00Z",
"deliveryDateTimeMaximum": "2023-09-15T16:00:00Z",
"additionalInfos": ["Informations sur l’expéditon"]
}
Réponse Terminée
{
"deliveryId": 1,
"referenceNumber": "123456789",
"statut": "DELIVERED",
"deliveryDateTimeMinimum": "2023-09-15T14:00:00Z",
"deliveryDateTimeMaximum": "2023-09-15T16:00:00Z",
"additionalInfos": ["Informations sur l’expéditon"]
}
Réponse Supprimée
{
"deliveryId": 1,
"referenceNumber": "-discard-123456789",
"statut": "DELIVERY_CANCELLED",
"additionalInfos": ["Informations sur l’expéditon"],
}
Réponse Relachée
{
"deliveryId": 1,
"referenceNumber": "123456789",
"statut": "UNASSIGNED",
"deliveryDateTimeMinimum": "2023-09-15T14:00:00Z",
"deliveryDateTimeMaximum": "2023-09-15T16:00:00Z",
"additionalInfos": ["Informations sur l’expéditon"]
}
Réponse Modifiée
{
"deliveryId": 1,
"referenceNumber": "123456789",
"statut": "<statut>",
"deliveryDateTimeMinimum": "2023-09-15T14:00:00Z",
"deliveryDateTimeMaximum": "2023-09-15T16:00:00Z",
"additionalInfos": ["Informations sur l’expéditon"]
}
Réponse Abandonnée
{
"deliveryId": 1,
"referenceNumber": "123456789",
"statut": "ABANDONNED",
"deliveryDateTimeMinimum": "2023-09-15T14:00:00Z",
"deliveryDateTimeMaximum": "2023-09-15T16:00:00Z",
"additionalInfos": ["Informations sur l’expéditon"]
}
Référentiel
Tableau des tailles de colis
Voici le tableau qui correspond aux différentes dimensions que nous acceptons pour les colis.
id | Libellé | Description | Largeur (m) | Longueur (m) | Hauteur (m) | Volume (m³) | Poids maximum (kg) |
---|---|---|---|---|---|---|---|
1 | S | Rentre dans un sac à dos | 0,4 | 0,4 | 0,4 | 0,04 | 10 |
2 | M | Rentre dans un coffre de voiture | 0,9 | 0,9 | 0,9 | 0,25 | 250 |
3 | L | Rentre dans uen voiture sièges baissés | 1,5 | 1,5 | 1,5 | 1,1 | 500 |
4 | XL | Nécessite un fourgon ou un utilitaire | 2,2 | 2,2 | 2,2 | 5 | 800 |
5 | Sur-mesure | Sur mesure |
Codes HTTP
Voici des tableaux récapitulant les codes HTTP utilisés par l'API publique de Tut-Tut.
2xx - Succès
Code | Description |
---|---|
200 | Requête traitée avec succès. La réponse dépendra de la méthode de requête utilisée. |
201 | Requête traitée avec succès et création d’un document. |
205 | Requête traitée avec succès, la page courante peut être effacée. |
4xx - Erreur du client HTTP
Code | Description |
---|---|
400 | La syntaxe de la requête est erronée. |
401 | Une authentification est nécessaire pour accéder à la ressource. |
403 | L'authentification a été acceptée mais que les droits d'accès ne permettent pas au client d'accéder à la ressource. |
404 | Ressource non trouvée. |