C++

DVLA Vehicle Enquiry Service

See more _Miscellaneous_ Examples

Demonstrates how to make a call to the DVLA Vehicle Enquiry API to get vehicle details of a specified vehicle. It uses the vehicle registration number as input to search and provide details of the vehicle. C++

#include <CkHttp.h>
#include <CkJsonObject.h>
#include <CkHttpResponse.h>
#include <CkStringBuilder.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  This example assumes the Chilkat API to have been previously unlocked.
    //  See Global Unlock Sample for sample code.

    CkHttp http;

    //  Implements the following CURL command:

    //  curl -X POST https://driver-vehicle-licensing.api.gov.uk/vehicle-enquiry/v1/vehicles \
    //    -H "x-api-key: supplied API key" \
    //    -H "Accept: application/json" \
    //    -d '{"registrationNumber": "ABC1234"}'

    //  Use the following online tool to generate HTTP code from a CURL command
    //  Convert a cURL Command to HTTP Source Code

    //  Use this online tool to generate code from sample JSON:
    //  Generate Code to Create JSON

    //  The following JSON is sent in the request body.

    //  {
    //    "registrationNumber": "ABC1234"
    //  }

    CkJsonObject json;
    json.UpdateString("registrationNumber","ABC1234");

    http.SetRequestHeader("Accept","application/json");
    http.SetRequestHeader("x-api-key","supplied API key");

    CkHttpResponse resp;
    success = http.HttpJson("POST","https://driver-vehicle-licensing.api.gov.uk/vehicle-enquiry/v1/vehicles",json,"application/json",resp);
    if (success == false) {
        std::cout << http.lastErrorText() << "\r\n";
        return;
    }

    CkStringBuilder sbResponseBody;
    resp.GetBodySb(sbResponseBody);
    CkJsonObject jResp;
    jResp.LoadSb(sbResponseBody);
    jResp.put_EmitCompact(false);

    std::cout << "Response Body:" << "\r\n";
    std::cout << jResp.emit() << "\r\n";

    int respStatusCode = resp.get_StatusCode();
    std::cout << "Response Status Code = " << respStatusCode << "\r\n";
    if (respStatusCode >= 400) {
        std::cout << "Response Header:" << "\r\n";
        std::cout << resp.header() << "\r\n";
        std::cout << "Failed." << "\r\n";
        return;
    }

    //  Sample JSON response:
    //  (Sample code for parsing the JSON response is shown below)

    //  {
    //    "artEndDate": "2025-02-28",
    //    "co2Emissions": 135,
    //    "colour": "BLUE",
    //    "engineCapacity": 2494,
    //    "fuelType": "PETROL",
    //    "make": "ROVER",
    //    "markedForExport": false,
    //    "monthOfFirstRegistration": "2004-12",
    //    "motStatus": "No details held by DVLA",
    //    "registrationNumber": "ABC1234",
    //    "revenueWeight": 1640,
    //    "taxDueDate": "2007-01-01",
    //    "taxStatus": "Untaxed",
    //    "typeApproval": "N1",
    //    "wheelplan": "NON STANDARD",
    //    "yearOfManufacture": 2004,
    //    "euroStatus": "EURO 6 AD",
    //    "realDrivingEmissions": "1",
    //    "dateOfLastV5CIssued": "2016-12-25"
    //  }

    //  Sample code for parsing the JSON response...
    //  Use the following online tool to generate parsing code from sample JSON:
    //  Generate Parsing Code from JSON

    //  Chilkat functions returning "const char *" return a pointer to temporary internal memory owned and managed by Chilkat.
    //  See this example explaining how this memory should be used: const char * functions.

    const char *artEndDate = jResp.stringOf("artEndDate");
    int co2Emissions = jResp.IntOf("co2Emissions");
    const char *colour = jResp.stringOf("colour");
    int engineCapacity = jResp.IntOf("engineCapacity");
    const char *fuelType = jResp.stringOf("fuelType");
    const char *make = jResp.stringOf("make");
    bool markedForExport = jResp.BoolOf("markedForExport");
    const char *monthOfFirstRegistration = jResp.stringOf("monthOfFirstRegistration");
    const char *motStatus = jResp.stringOf("motStatus");
    const char *registrationNumber = jResp.stringOf("registrationNumber");
    int revenueWeight = jResp.IntOf("revenueWeight");
    const char *taxDueDate = jResp.stringOf("taxDueDate");
    const char *taxStatus = jResp.stringOf("taxStatus");
    const char *typeApproval = jResp.stringOf("typeApproval");
    const char *wheelplan = jResp.stringOf("wheelplan");
    int yearOfManufacture = jResp.IntOf("yearOfManufacture");
    const char *euroStatus = jResp.stringOf("euroStatus");
    const char *realDrivingEmissions = jResp.stringOf("realDrivingEmissions");
    const char *dateOfLastV5CIssued = jResp.stringOf("dateOfLastV5CIssued");
    }