From 7d577d971f8d7a02675fcd931f526972837e277f Mon Sep 17 00:00:00 2001 From: Gulshan Khurana <67651578+gulshankhurana@users.noreply.github.com> Date: Tue, 3 Sep 2024 20:58:32 +0100 Subject: [PATCH 1/4] Added DVLA Vehicle Enquiry Service Readme --- .../ReadME.md | 28 +++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 independent-publisher-connectors/Proposal - DVLA Vehicle Enquiry Service (UK)/ReadME.md diff --git a/independent-publisher-connectors/Proposal - DVLA Vehicle Enquiry Service (UK)/ReadME.md b/independent-publisher-connectors/Proposal - DVLA Vehicle Enquiry Service (UK)/ReadME.md new file mode 100644 index 0000000000..efa74776f3 --- /dev/null +++ b/independent-publisher-connectors/Proposal - DVLA Vehicle Enquiry Service (UK)/ReadME.md @@ -0,0 +1,28 @@ +# DVLA Vehicle Enquiry Service + +The DVLA Vehicle Enquiry Service (UK) provides vehicle details of a specified vehicle. It uses the UK vehicle registration number as input to search and provide details of the vehicle. + +# Publishers: Gulshan Khurana, Pranav Khurana + +## Prerequisites + +You will need the following to proceed: +* A Microsoft Power Apps or Power Automate plan with custom connector feature +* An API key obtained [here](https://register-for-ves.driver-vehicle-licensing.api.gov.uk/) + +## Supported Operations + +The connector supports the following operation: +* `Vehicle Details`: Get vehicle details of a specified UK registered vehicle. + +## Obtaining Credentials + +An API key is required for this connector to work. You can sign up for free with an account on DVLA's website [here](https://register-for-ves.driver-vehicle-licensing.api.gov.uk/) + +## Known issues and limitations + +There are no known issues with this connector. + +## Deployment Instructions + +Upload the connector and create a connection using the API key from the prerequisites. From 2971ce3ef9e0b37935865ec68a6d83067c639889 Mon Sep 17 00:00:00 2001 From: Gulshan Khurana <67651578+gulshankhurana@users.noreply.github.com> Date: Sat, 7 Sep 2024 12:57:35 +0100 Subject: [PATCH 2/4] Removed 'Proposal' prefix --- .../ReadME.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename independent-publisher-connectors/{Proposal - DVLA Vehicle Enquiry Service (UK) => DVLA Vehicle Enquiry Service (UK)}/ReadME.md (100%) diff --git a/independent-publisher-connectors/Proposal - DVLA Vehicle Enquiry Service (UK)/ReadME.md b/independent-publisher-connectors/DVLA Vehicle Enquiry Service (UK)/ReadME.md similarity index 100% rename from independent-publisher-connectors/Proposal - DVLA Vehicle Enquiry Service (UK)/ReadME.md rename to independent-publisher-connectors/DVLA Vehicle Enquiry Service (UK)/ReadME.md From 5c86fd4598c3e779a1cfaf2f4cecc41d9860fb0d Mon Sep 17 00:00:00 2001 From: Gulshan Khurana <67651578+gulshankhurana@users.noreply.github.com> Date: Sat, 7 Sep 2024 12:59:29 +0100 Subject: [PATCH 3/4] Added the apiProperties and apiDefinition swagger files --- .../apiDefinition.swagger.json | 292 ++++++++++++++++++ .../apiProperties.json | 23 ++ 2 files changed, 315 insertions(+) create mode 100644 independent-publisher-connectors/DVLA Vehicle Enquiry Service (UK)/apiDefinition.swagger.json create mode 100644 independent-publisher-connectors/DVLA Vehicle Enquiry Service (UK)/apiProperties.json diff --git a/independent-publisher-connectors/DVLA Vehicle Enquiry Service (UK)/apiDefinition.swagger.json b/independent-publisher-connectors/DVLA Vehicle Enquiry Service (UK)/apiDefinition.swagger.json new file mode 100644 index 0000000000..78d68ce9aa --- /dev/null +++ b/independent-publisher-connectors/DVLA Vehicle Enquiry Service (UK)/apiDefinition.swagger.json @@ -0,0 +1,292 @@ +{ + "swagger": "2.0", + "info": { + "title": "DVLA Vehicle Enquiry Service", + "description": "Check details of UK registered vehicles using registration number (number plate)", + "version": "1.0", + "contact": { + "name": "Gulshan Khurana, Pranav Khurana", + "url": "https://www.linkedin.com/in/gulshankhurana/", + "email": "gulshankhurana@outlook.com" + } + }, + "host": "driver-vehicle-licensing.api.gov.uk", + "basePath": "/", + "schemes": [ + "https" + ], + "consumes": [], + "produces": [], + "paths": { + "/vehicle-enquiry/v1/vehicles": { + "post": { + "responses": { + "200": { + "description": "default", + "schema": { + "type": "object", + "properties": { + "artEndDate": { + "type": "string", + "description": "artEndDate", + "title": "ART End Date" + }, + "co2Emissions": { + "type": "integer", + "format": "int32", + "description": "co2Emissions", + "title": "CO2 Emission" + }, + "colour": { + "type": "string", + "description": "colour", + "title": "Colour" + }, + "engineCapacity": { + "type": "integer", + "format": "int32", + "description": "engineCapacity", + "title": "Cylinder Capacity" + }, + "fuelType": { + "type": "string", + "description": "fuelType", + "title": "Fuel Type" + }, + "make": { + "type": "string", + "description": "make", + "title": "Make" + }, + "markedForExport": { + "type": "boolean", + "description": "markedForExport", + "title": "Export Marker", + "enum": [ + "true", + "false" + ] + }, + "monthOfFirstRegistration": { + "type": "string", + "description": "monthOfFirstRegistration", + "title": "Month of First Registration" + }, + "motStatus": { + "type": "string", + "description": "motStatus", + "title": "MOT Status" + }, + "registrationNumber": { + "type": "string", + "description": "registrationNumber", + "title": "Registration Number" + }, + "revenueWeight": { + "type": "integer", + "format": "int32", + "description": "revenueWeight", + "title": "Revenue Weight" + }, + "taxDueDate": { + "type": "string", + "description": "taxDueDate", + "title": "Tax Due Date" + }, + "taxStatus": { + "type": "string", + "description": "taxStatus", + "title": "Tax Status" + }, + "typeApproval": { + "type": "string", + "description": "typeApproval", + "title": "Vehicle Type Approval" + }, + "wheelplan": { + "type": "string", + "description": "wheelplan", + "title": "Wheelplan" + }, + "yearOfManufacture": { + "type": "integer", + "format": "int32", + "description": "yearOfManufacture", + "title": "Year of Manufacture" + }, + "euroStatus": { + "type": "string", + "description": "euroStatus", + "title": "Euro Status" + }, + "realDrivingEmissions": { + "type": "string", + "description": "realDrivingEmissions", + "title": "Real Driving Emissions" + }, + "dateOfLastV5CIssued": { + "type": "string", + "description": "dateOfLastV5CIssued", + "title": "Date of Last V5 Certificate (Logbook) Issued" + } + } + } + }, + "400": { + "description": "default", + "schema": { + "type": "object", + "properties": { + "errors": { + "type": "array", + "items": { + "type": "object", + "properties": { + "status": { + "type": "string", + "description": "status", + "title": "Status" + }, + "code": { + "type": "string", + "description": "code", + "title": "Code" + }, + "title": { + "type": "string", + "description": "title", + "title": "Title" + }, + "detail": { + "type": "string", + "description": "detail", + "title": "Detail" + } + } + }, + "description": "errors" + } + } + } + }, + "404": { + "description": "default", + "schema": { + "type": "object", + "properties": { + "errors": { + "type": "array", + "items": { + "type": "object", + "properties": { + "status": { + "type": "string", + "description": "status", + "title": "Status" + }, + "code": { + "type": "string", + "description": "code", + "title": "Code" + }, + "title": { + "type": "string", + "description": "title", + "title": "Title" + }, + "detail": { + "type": "string", + "description": "detail", + "title": "Detail" + } + } + }, + "description": "errors" + } + } + } + } + }, + "summary": "Get Vehicle Details", + "description": "Get Vehicle Details by using Vehicle Registration Number", + "operationId": "GetVehicleDetailsbyVRN", + "parameters": [ + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "type": "object", + "properties": { + "registrationNumber": { + "type": "string", + "description": "registrationNumber", + "title": "Vehicle Registration Number" + } + } + } + } + ], + "x-ms-openai-data": { + "openai-enabled": true, + "operations": [ + { + "operationId": "GetVehicleDetailsbyVRN", + "x-ms-require-user-confirmation": false, + "parameters": [ + { + "name": "body", + "type": "upsert", + "properties": [ + { + "name": "required", + "value": false, + "type": "upsert" + }, + { + "name": "x-ms-explicit-input", + "value": true, + "type": "upsert" + } + ] + } + ] + } + ] + } + } + } + }, + "x-ms-connector-metadata": [ + { + "propertyName": "Website", + "propertyValue": "https://www.gov.uk/government/organisations/driver-and-vehicle-licensing-agency" + }, + { + "propertyName": "Privacy policy", + "propertyValue": "https://www.gov.uk/help/privacy-notice" + }, + { + "propertyName": "Categories", + "propertyValue": "Commerce;Data" + } + ], + "definitions": {}, + "parameters": {}, + "responses": {}, + "securityDefinitions": { + "api_key": { + "type": "apiKey", + "in": "header", + "name": "x-api-key" + } + }, + "security": [], + "tags": [], + "x-ms-openai-manifest": { + "humanName": "Get Vehicle Details", + "modelDescription": "This is a plugin to get Vehicle Details of a UK registered vehicle by using its Vehicle Registration Number (number plate) held by the the Driver and Vehicle Licensing Agency (DVLA) in the UK.", + "contactEmail": "gulshankhurana@outlook.com", + "legalUrl": "https://contact.dvla.gov.uk/terms_and_conditions?locale=en" + } +} \ No newline at end of file diff --git a/independent-publisher-connectors/DVLA Vehicle Enquiry Service (UK)/apiProperties.json b/independent-publisher-connectors/DVLA Vehicle Enquiry Service (UK)/apiProperties.json new file mode 100644 index 0000000000..9c8d2911a6 --- /dev/null +++ b/independent-publisher-connectors/DVLA Vehicle Enquiry Service (UK)/apiProperties.json @@ -0,0 +1,23 @@ +{ + "properties": { + "connectionParameters": { + "api_key": { + "type": "securestring", + "uiDefinition": { + "displayName": "x-api-key", + "description": "The x-api-key for this api", + "tooltip": "Provide your x-api-key", + "constraints": { + "tabIndex": 2, + "clearText": false, + "required": "true" + } + } + } + }, + "iconBrandColor": "#da3b01", + "capabilities": [], + "publisher": "Gulshan Khurana, Pranav Khurana", + "stackOwner": "Driver & Vehicle Licencing Agency" + } +} \ No newline at end of file From f33c5b65245121fa74d6dd288e722a64b30e7fc2 Mon Sep 17 00:00:00 2001 From: Gulshan Khurana <67651578+gulshankhurana@users.noreply.github.com> Date: Thu, 12 Sep 2024 14:48:18 +0100 Subject: [PATCH 4/4] Update apiProperties.json updated publisher info --- .../DVLA Vehicle Enquiry Service (UK)/apiProperties.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/independent-publisher-connectors/DVLA Vehicle Enquiry Service (UK)/apiProperties.json b/independent-publisher-connectors/DVLA Vehicle Enquiry Service (UK)/apiProperties.json index 9c8d2911a6..e8d3b9b04f 100644 --- a/independent-publisher-connectors/DVLA Vehicle Enquiry Service (UK)/apiProperties.json +++ b/independent-publisher-connectors/DVLA Vehicle Enquiry Service (UK)/apiProperties.json @@ -17,7 +17,7 @@ }, "iconBrandColor": "#da3b01", "capabilities": [], - "publisher": "Gulshan Khurana, Pranav Khurana", + "publisher": "Gulshan Khurana and Pranav Khurana", "stackOwner": "Driver & Vehicle Licencing Agency" } -} \ No newline at end of file +}