Sample code for 30+ languages & platforms
Unicode C

UK Vehicle Data VRM Lookup

See more REST Examples

Demonstrates how to query the UK Vehicle Data VRM online API's. (See https://ukvehicledata.co.uk/)

Chilkat Unicode C Downloads

Unicode C
#include <C_CkRestW.h>
#include <C_CkJsonObjectW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkRestW rest;
    BOOL bAutoReconnect;
    const wchar_t *jsonResponseStr;
    HCkJsonObjectW json;
    int numBatteries;
    int i;

    success = FALSE;

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

    rest = CkRestW_Create();

    // Connect using TLS.
    bAutoReconnect = TRUE;
    success = CkRestW_Connect(rest,L"uk1.ukvehicledata.co.uk",443,TRUE,bAutoReconnect);
    if (success != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkRestW_Dispose(rest);
        return;
    }

    // Replace UKVD-API-KEY with your actual API KEY,
    // which looks something like "abcdb1234-0abc-1235-abcf-1234c3d1abcd"
    CkRestW_putAuthorization(rest,L"ukvd-ipwhitelist UKVD-API-KEY");

    // Replace "ABCDE" with a real VRM...
    CkRestW_AddQueryParam(rest,L"key_vrm",L"ABCDE");

    // Add the Content-Type HTTP request header.
    // success = rest.AddHeader("Content-Type","application/json; charset=UTF-8");

    // This request gets vehicle data.
    // See below for a request to get battery data.
    jsonResponseStr = CkRestW_fullRequestNoBody(rest,L"GET",L"/api/datapackage/vehicledata");
    if (CkRestW_getLastMethodSuccess(rest) != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkRestW_Dispose(rest);
        return;
    }

    if (CkRestW_getResponseStatusCode(rest) != 200) {
        wprintf(L"Response Status Code = %d\n",CkRestW_getResponseStatusCode(rest));
        wprintf(L"%s\n",jsonResponseStr);
        CkRestW_Dispose(rest);
        return;
    }

    json = CkJsonObjectW_Create();
    CkJsonObjectW_Load(json,jsonResponseStr);
    CkJsonObjectW_putEmitCompact(json,FALSE);

    // Show the JSON response.
    wprintf(L"%s\n",CkJsonObjectW_emit(json));

    // A sample vehicledata response will be as shown below.
    // To get a few bits of data from the response:
    wprintf(L"RequestGuid: %s\n",CkJsonObjectW_stringOf(json,L"RequestGuid"));
    wprintf(L"EngineNumber: %s\n",CkJsonObjectW_stringOf(json,L"DataItems.EngineNumber"));
    wprintf(L"Vrm: %s\n",CkJsonObjectW_stringOf(json,L"DataKeys.Vrm"));

    // {
    //   "RequestGuid": "xxxxxxxx-cc72-4b63-xxxxxxxxxxxx",
    //   "StatusCode": 0,
    //   "StatusMessage": "Success",
    //   "PackageId": "xxxxxxxx-a4bc-4a84-af22-xxxxxxxxxxxx",
    //   "PackageVersion": 1,
    //   "DataKeys": {
    //     "Vrm": "ABCDE"
    //   },
    //   "DataItems": {
    //     "DriveAxle": "4x2",
    //     "Exported": "False",
    //     "DriverSeatPosition": "RHD",
    //     "EngineNumber": "LN910940728622",
    //     "Class": "Sport",
    //     "ImportedNorthernIreland": "False",
    //     "HistoryPreviousKeeperAcquisitionDate": "2013-01-12",
    //     "RoadFundLicenseSixMonth": "�126.50",
    //     "EnginePowerBhp": "262",
    //     "SpecDateRangeFrom": "1987-10-01",
    //     "RegistrationDateUK": "1994-08-03",
    //     "SoundLevelDriveBy": "0",
    //     "RoadFundLicenseTwelveMonth": "�235.00",
    //     "RoadFundLicenseBand": "Not available",
    //     "Vrm": "J5YVK",
    //     "TrimCode": "BA",
    //     "Derivative": "S4",
    //     "EngineSizeCc": "2174",
    //     "EngineCylinderCount": "4",
    //     "HistoryLatestV5cIssueDate": "2015-05-12",
    //     "Category": "Car",
    //     "HistoryPreviousKeeperCount": "9",
    //     "ConditionScrapped": "False",
    //     "EngineValveCount": "16",
    //     "WeightUnladen": "0",
    //     "RoadFundLicenseRenewalDate": "2017-04-01",
    //     "Model": "Esprit",
    //     "SpecDateRangeTo": "2003-06-01",
    //     "RoadFundLicenseCurrentStatus": "Tax not due",
    //     "BuildYear": "1994",
    //     "BuildDate": "1994-12-31",
    //     "VinLast4": "1448",
    //     "GearCount": "5",
    //     "SeatCount": "2",
    //     "Make": "Lotus",
    //     "Vin": "SCC082910RHA61448",
    //     "ColourChangeCount": "0",
    //     "DriveType": "Rear Wheel Drive",
    //     "WeightGross": "0",
    //     "EngineCode": "N/A",
    //     "EnginePowerKw": "193",
    //     "SoundLevelEngineSpeed": "0",
    //     "ConditionUnscrapped": "False",
    //     "HistoryPreviousKeeperDisposalDate": "2014-04-26",
    //     "EngineAlignment": "Longitudinal",
    //     "Imported": "False",
    //     "BodyType": "Coupe",
    //     "EnginePosition": "Mid",
    //     "TransmissionType": "Manual",
    //     "WeightFullyLaden": "0",
    //     "SoundLevelStationary": "0",
    //     "FuelType": "Petrol",
    //     "Colour": "YELLOW",
    //     "EngineSizeLitre": "2.2",
    //     "RegistrationDate": "1994-08-03",
    //     "Co2Emissions": "000",
    //     "WeightMaxTowingUnbraked": "0",
    //     "HistoryCurrentKeeperAcquisitionDate": "2015-04-25",
    //     "WeightMaxTowingBraked": "0",
    //     "DoorCount": "2",
    //     "EngineCylinderConfig": "Inline",
    //     "EngineFuelDelivery": "Turbo Injection"
    //   }
    // }

    // -----------------------------------------------------------------------------------
    // Now get battery data...
    jsonResponseStr = CkRestW_fullRequestNoBody(rest,L"GET",L"/api/datapackage/batterydata");
    if (CkRestW_getLastMethodSuccess(rest) != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkRestW_Dispose(rest);
        CkJsonObjectW_Dispose(json);
        return;
    }

    if (CkRestW_getResponseStatusCode(rest) != 200) {
        wprintf(L"Response Status Code = %d\n",CkRestW_getResponseStatusCode(rest));
        wprintf(L"%s\n",jsonResponseStr);
        CkRestW_Dispose(rest);
        CkJsonObjectW_Dispose(json);
        return;
    }

    CkJsonObjectW_Load(json,jsonResponseStr);

    // Show the JSON response containing battery data.
    wprintf(L"%s\n",CkJsonObjectW_emit(json));

    // To get a few pieces of information out of the response...
    numBatteries = CkJsonObjectW_SizeOfArray(json,L"DataItems.BatteryList");
    i = 0;
    while ((i < numBatteries)) {
        CkJsonObjectW_putI(json,i);
        wprintf(L"---- Battery %d:\n",i);
        wprintf(L"  Type = %s\n",CkJsonObjectW_stringOf(json,L"DataItems.BatteryList[I].Type"));
        wprintf(L"  LayoutImage = %s\n",CkJsonObjectW_stringOf(json,L"DataItems.BatteryList[I].LayoutImage"));
        wprintf(L"  TerminalCode = %s\n",CkJsonObjectW_stringOf(json,L"DataItems.BatteryList[I].TerminalCode"));
        i = i + 1;
    }

    // The battery data looks like this:
    // {
    //   "RequestGuid": "xxxxxxxx-5030-4b3d-a2ed-xxxxxxxxxxxx",
    //   "StatusCode": 0,
    //   "StatusMessage": "Success",
    //   "PackageId": "xxxxxxxx-9ec2-4fd3-9247-xxxxxxxxxxxx",
    //   "PackageVersion": 1,
    //   "DataKeys": {
    //     "Vrm": "ABCDE"
    //   },
    //   "DataItems": {
    //     "BatteryList": [
    //       {
    //         "Type": "Primary",
    //         "UkRef": "075",
    //         "LayoutCode": "0",
    //         "LayoutImage": "http://cdn.ukvehicledata.co.uk/battery/layout/0.png",
    //         "TerminalCode": "T1",
    //         "TerminalImage": "http://cdn.ukvehicledata.co.uk/battery/terminal/T1.png",
    //         "HoldDownCode": "B13",
    //         "HoldDownImage": "http://cdn.ukvehicledata.co.uk/battery/holddown/B13.png"
    //       }
    //     ],
    //     "BatteryCount": "1"
    //   }
    // }


    CkRestW_Dispose(rest);
    CkJsonObjectW_Dispose(json);

    }