Pascal (Lazarus/Delphi)

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/) Pascal (Lazarus/Delphi)

program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.Rest,
  Chilkat.JsonObject;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  rest: TRest;
  bAutoReconnect: Boolean;
  jsonResponseStr: string;
  json: TJsonObject;
  numBatteries: Integer;
  i: Integer;

begin
  success := False;

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

  rest := TRest.Create;

  //  Connect using TLS.
  bAutoReconnect := True;
  success := rest.Connect('uk1.ukvehicledata.co.uk',443,True,bAutoReconnect);
  if (success <> True) then
    begin
      WriteLn(rest.LastErrorText);
      Exit;
    end;

  //  Replace UKVD-API-KEY with your actual API KEY,
  //  which looks something like "abcdb1234-0abc-1235-abcf-1234c3d1abcd"
  rest.Authorization := 'ukvd-ipwhitelist UKVD-API-KEY';

  //  Replace "ABCDE" with a real VRM...
  rest.AddQueryParam('key_vrm','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 := rest.FullRequestNoBody('GET','/api/datapackage/vehicledata');
  if (rest.LastMethodSuccess <> True) then
    begin
      WriteLn(rest.LastErrorText);
      Exit;
    end;

  if (rest.ResponseStatusCode <> 200) then
    begin
      WriteLn('Response Status Code = ' + rest.ResponseStatusCode);
      WriteLn(jsonResponseStr);
      Exit;
    end;

  json := TJsonObject.Create;
  json.Load(jsonResponseStr);
  json.EmitCompact := False;

  //  Show the JSON response.
  WriteLn(json.Emit());

  //  A sample vehicledata response will be as shown below.
  //  To get a few bits of data from the response:
  WriteLn('RequestGuid: ' + json.StringOf('RequestGuid'));
  WriteLn('EngineNumber: ' + json.StringOf('DataItems.EngineNumber'));
  WriteLn('Vrm: ' + json.StringOf('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 := rest.FullRequestNoBody('GET','/api/datapackage/batterydata');
  if (rest.LastMethodSuccess <> True) then
    begin
      WriteLn(rest.LastErrorText);
      Exit;
    end;

  if (rest.ResponseStatusCode <> 200) then
    begin
      WriteLn('Response Status Code = ' + rest.ResponseStatusCode);
      WriteLn(jsonResponseStr);
      Exit;
    end;

  json.Load(jsonResponseStr);

  //  Show the JSON response containing battery data.
  WriteLn(json.Emit());

  //  To get a few pieces of information out of the response...
  numBatteries := json.SizeOfArray('DataItems.BatteryList');
  i := 0;
  while (i < numBatteries) do
    begin
      json.I := i;
      WriteLn('---- Battery ' + i + ':');
      WriteLn('  Type = ' + json.StringOf('DataItems.BatteryList[I].Type'));
      WriteLn('  LayoutImage = ' + json.StringOf('DataItems.BatteryList[I].LayoutImage'));
      WriteLn('  TerminalCode = ' + json.StringOf('DataItems.BatteryList[I].TerminalCode'));
      i := i + 1;
    end;

  //  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"
  //    }
  //  }


  rest.Free;
  json.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.