API d'historique des enchères

Les données d'enchères ClearVin contiennent toutes les instances d'un véhicule mis en vente via une vente aux enchères de véhicules. Nos données d'enchères contiennent les spécifications du véhicule au moment de l'enchère et toutes les images associées à l'annonce.

Autorisation

Vous devrez utiliser une adresse e-mail et un mot de passe pour obtenir le jeton d'accès en utilisant cette URL :
POST https://www.clearvin.com/rest/vendor/login
La demande doit provenir d'une adresse IP enregistrée. La charge utile doit être :
{
    "email" : “[email protected]”,
    "password": "11111111"
}
Réponse
ÉLÉMENTLA DESCRIPTIONFORMAT
statusIndique si la demande a été traitée avec succès ou s'est terminée avec une erreurerror chaîne ou ok
messageContient des détails sur le résultat si le statut est errorChaîne
tokenJeton Web JSON. Le jeton expire dans 10 minutesChaîne


Si l'e-mail et le mot de passe sont corrects, le jeton sera renvoyé en réponse avec le jeton comme suit :
{
    "status": "ok",
    "token": " I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0"
}


Rapport

Après avoir reçu ce jeton, vous pouvez l'utiliser pour accéder aux rapports à l'aide de cette URL :
GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050
Pour utiliser ce point de terminaison, vous devez fournir l'en-tête HTTP avec le jeton fourni comme suit :
Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
Réponse
ÉLÉMENTLA DESCRIPTIONTYPE
statusIndique si la demande a été traitée avec succès ou s'est terminée avec une erreurerror chaîne ou ok
messageContient des détails sur le résultat si le statut est errorChaîne
Report idContient l'identifiant du rapport actuelChaîne
Report vinNiv demandéChaîne
Report reportContient des informations complètes sur le véhiculeObjet JSON

Vous pouvez également recevoir des rapports en vue html en utilisant une URL comme celle-ci :
GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050&format=html
Et fournissez les prochains en-têtes HTTP :
Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
Content-Type: text/html


Succès de l'authentification

Demande
curl -X POST \
    https://www.clearvin.com/rest/vendor/login \
    -H 'Content-Type: application/json' \
    -d '{
        "email": "[email protected]",
        "password": "yourpassword"
}
Succès de la réponse
{
    "status": "ok",
    "token": "I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0"
}
Erreur de réponse
{
    "status": "error",
    "message": "Wrong username or password"
}

Rapport

Demande
curl - X GET\ 'https://www.clearvin.com/rest/vendor/report?vin=WBAFR7C57CC811956'\ -
    H 'Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0'\ -
    H 'Content-Type: application/json'
Succès de la réponse
{
    "status": "ok",
    "result": {
        "id": "3646F9E2",
        "vin": "WBAFR7C57CC811956",
        "report": {
            "auctions": [{
                "announced_at_auction": "Jun 5, 2015",
                "make": "BMW",
                "model": "535I",
                "odometer": 26226,
                "odometer_status": "ACTUAL",
                "color": "BLACK",
                "engine": "3.0L L6  FI  DOHC 24V  F4",
                "drive": null,
                "acv": 37409,
                "repair_cost": null,
                "fuel": null,
                "cylinders": null,
                "own_doc": "CA SALVAGE CERTIFICATE",
                "primary_damage": "FRONT END",
                "secondary_damage": "LEFT SIDE",
                "location": "Anaheim",
                "sale_date": "2015-07-20",
                "sale_status": null,
                "images": ["https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891b27294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891827294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891927294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891e27294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891f27294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891c27294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891d27294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891227294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891327294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891b5b4b0e663b7b"],
                "condition": "WON'T START",
                "auctionId": "591778387",
                "vendor": "salvagebid.com",
                "title_state": "CA",
                "date": "Jul 20, 2015"
            }, {
                "announced_at_auction": "Aug 10, 2015",
                "make": "BMW",
                "model": "535I",
                "odometer": "26227",
                "odometer_status": "ACTUAL",
                "color": "BLACK",
                "engine": "3.0L 6L 6",
                "drive": "Rear-wheel drive",
                "acv": "31250.00",
                "repair_cost": "0.00",
                "fuel": "GAS",
                "cylinders": "6",
                "own_doc": "CA SALVAGE CERTIFICATE",
                "primary_damage": "PARTIAL REPAIR",
                "secondary_damage": "",
                "location": "CA - SAN BERNARDINO",
                "sale_date": "2015-09-10",
                "sale_status": "On Minimum Bid",
                "images": ["https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e6ca4931c0f33466d662f5e5252da7f23418118bc58cf287641eb574b2cac342cf355e4879cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e3da0c21b5e32156d662b550150da7f2e17dc18e756ce2d7642ec56487cf56270f759ead39cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e68f193185d3f426a6629515751da7f23488018e706932a761aba5d4c7afd3573fe59e8d79cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e6ef6931c0832433a662d02015fda7f71448918e704947e7646b9561977fa6524a40bedd59cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e63f4954e0d66183d66785f0407da7f2013de18bf51c1787614b65e4b2afe3473f655bf849cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e63a7951c5f37463a66795e5457da7f75448e18bf59c62b7612b70f4e2ef43577f659e58e9cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e62f4961f5336106a662c500455da7f75408018e605c02a761be9081e78f53270fe55ebd09cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e62a4c24c5930423e662956065eda7f7412dc18e70592247615eb5e4829f46123f75bb8d39cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e62a4c71c0d641739667d520356da7f2f44de18bc54c4257611b7561e79fe3373a45de8d59cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e68a1931c5a32176d6624025404da7f22158b18bf0694247610e95e182ca96626f35beed39cb17678"],
                "condition": "Run & Drive Verified",
                "auctionId": "29866715",
                "vendor": "autobidmaster.com",
                "title_state": "CA",
                "date": "Sep 10, 2015"
            }, {
                "announced_at_auction": "Dec 2, 2016",
                "make": "BMW",
                "model": "535I",
                "odometer": "0",
                "odometer_status": "NOT ACTUAL",
                "color": "BLACK",
                "engine": "3.0LL 6",
                "drive": "Rear-wheel drive",
                "acv": "0.00",
                "repair_cost": "0.00",
                "fuel": "GAS",
                "cylinders": "6",
                "own_doc": "CA SALVAGE CERTIFICATE",
                "primary_damage": "MECHANICAL",
                "secondary_damage": "",
                "location": "*NCS - PACIFIC REGION",
                "sale_date": "2017-02-20",
                "sale_status": "",
                "images": ["https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d48521535862f3c61b463516687f31525d5691662f158b03f357917d6c1bba0b487cf96571e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4872150046ea0971d4662453d2f31525c04c5667612dc56f305c2796f16e90b4d2af56823e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4d3205a0338a2c1484663196d283152040396662e128a00f306c32e6d17bd5f1e7fff6827e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4837c07043aa2c51b4634126a7931525204926675128b00f306c7256c40bb0b4d2da83670e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4d4215a5738a5971d4663443e2a3152065392662e468c03f351c02d3a12ee5e4e2caf3321e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4d72605523fa19448463746342f31525c50c2662e178d50f359c0793812be5c452aac3126e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d48374500363a292194637443e2d31520407cf6676178f54f352932e3d13b65c1b2bf8622de8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4d67d07566aa1c74f466243697931525453ce6676418f0cf301ce2e6c46bf084b7da86822e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4d72551533ea2914f4665123f2d3152075e96662f108f02f356c7256b45eb574b2af56774e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4d471565669a390494634196f783152510395662e12dc50f357c17e3a17be5d192cab3676e8278df1"],
                "condition": null,
                "auctionId": "42699816",
                "vendor": "autobidmaster.com",
                "title_state": "CA",
                "date": "Feb 20, 2017"
            }]
        }
    }
}