Aller au contenu
Documentation développeursRéférence de l'APIVéhicules

Supprimer un véhicule

Supprime l'un de vos véhicules.

DELETEhttps://runner.cargoduo.com/v1/vehicles/{id}

Les préréglages sont en lecture seule. Gratuit : aucun crédit n'est débité.

Authentification

Clé API Bearer avec l'autorisationresources:writeEn savoir plus

Paramètres de chemin

NomTypeObligatoireDescription
idstringobligatoire
string
Oui

ID d'un préréglage ou de l'un de vos véhicules (veh_…).

Exemple de requête

curl -X DELETE "https://runner.cargoduo.com/v1/vehicles/veh_118" \
  -H "Authorization: Bearer $CARGODUO_API_KEY"

Exemple de réponse

200 OK · Deleted
{
  "id": "veh_118",
  "object": "vehicle",
  "deleted": true
}

Réponses

  • 200OKSupprimé.
    NomTypeObligatoireDescription
    idstring
    string
    Non
    objectstring
    string
    Non
    vehicletemplateproject
    deletedboolean
    boolean
    Non

    Toujours true.

  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • unauthorizedClé API absente, mal formée ou inconnue.
    • key_revokedLa clé a été révoquée.
    • key_expiredLa clé a dépassé sa date d'expiration.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur
  • 403Forbiddenpreset_read_onlyip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • preset_read_onlyLes préréglages ne peuvent être ni modifiés ni supprimés.
    • ip_not_allowedL'adresse IP appelante ne figure pas dans la liste des adresses IP autorisées de la clé.
    • subscription_inactiveL'organisation n'a aucun abonnement actif incluant l'API.
    • account_inactiveL'organisation est suspendue ou n'a aucun propriétaire dont le compte est actif.
    • scope_missingIl manque à la clé une autorisation requise par cet endpoint.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur
  • 404Not foundvehicle_not_found
    • vehicle_not_foundAucun véhicule avec cet ID parmi les préréglages ou les véhicules de votre organisation.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur
  • 429Too many requestsrate_limited
    • rate_limitedTrop de requêtes dans la minute, l'heure ou la journée en cours (par clé ou par organisation), ou plus de 60 échecs d'authentification par minute depuis votre adresse IP.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur
  • 500Internal server errorinternal_error
    • internal_errorUne erreur s'est produite de notre côté.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur
  • 503Service unavailableapi_disabled
    • api_disabledL'API est temporairement désactivée (maintenance) ou désactivée pour l'organisation.
    NomTypeObligatoireDescription
    errorErrorBodyobligatoire
    ErrorBody
    Oui
    Tous les codes d'erreur