NPS-DLNAM

From NP Tracker projects
Revision as of 09:16, 31 May 2023 by NPTracker (talk | contribs) (Checks)
Jump to navigation Jump to search

Note This is the developer's corner to aid in integrating our RESTful API into their apps.


Interface

This is a REST API endpoint using HTTP GET.
Available to any device/server on the internet.

Usage

To use this endpoint you will need a valid API Key available after registration on NPS-CLOUD.
See our API documentation page for advanced help and examples on using this endpoint.


Parameters

scan

The HEX encoded string of the Namibia Drivers Licence (SADL) PDF-417 barcode.
This HEX string shall begin with A000000248010002...
Please see our example application on | GitHub for an example of how to convert from the PDF417 decoded binary format scan to the expected HEX value.

token

This is your NPS-CLOUD account access token (API Key) available under the NPS-API menu in your NPS-CLOUD account.

Output

We provide a JSON formatted output of the results available from this API endpoint.

NPS-DLNAM JSON output

User_IP

Client's IP address that was used to send the enquiry from.

Name

Driver's full name

Surname

Driver's surname

DOB

Driver's date of birth

IDNo

Driver's ID Number

IssuedBy

Issued state

LicNo

Drivers licence number

Issued

Date the card was first issued

ValidFrom

Date the card was issued/renewed

ValidTo

Date the licence will expire

Code

Driver's licence vehicle codes the driver is allowed to operate. ie Bike & car/truck types...

Licence1

The first licence vehicle code the driver may operate.

Unlock

Returns a true report if the user is allowed to inquire the drivers license details.
Return false if, for instance, the user's token credits have run out.

Version

The version of the API endpoint.

TokensLeft

Current token credits left for the API account.

Checks

VehRestr

Not enough data to decode this currently returning "-"

UserRestr

Not enough data to decode this currently returning "-"

expired

The boolean value will be false if ValidTo date is past today's date else return true

age

The driver's age based on his ID number

gender

The driver's gender is based on his ID number