NPS-API

From NP Tracker projects
Revision as of 08:00, 18 April 2019 by NPTracker (talk | contribs)
Jump to navigation Jump to search
Datasheet250 NPS-API NP Tracker suspect vehicle API interface


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


For a high speed client side application interface see our NPS-API Webservice.

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 advance help and examples on using this endpoint.

Parameters

cmd

Command to execute ie. add,demo,ping,nps,mute,unmute

add

Add a new lookout report for the supplied str vehicle registration numberplate.

demo
ping
nps

Test the supplied str vehicle registration numberplate.

mute

Mute the str vehicle registration numberplate and DON't provide a lookout report for this plate.

unmute

Unmute the str vehicle registration numberplate and provide a lookout report for this plate again.

str

Parameter to use for:

  • Number plate to test(NPS)/mute/unmute
  • Lookout report to be added ensure that the plate is in the lookout to ensure correct detection.

token

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

id

Provide a numerical value to the endpoint that will be echoed in the JSON reply.

trim

Used for trimming the desc output to the number of characters provided ensuring that lookouts will not be longer than the provided value.

history

Only show reports not exceeding the provided value in months.
This is used if you are only interested in the latest reports from the NP Tracker suspect and suspicious vehicle database.

Output

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

NPS-API JSON output

id

Echo the supplied id parameter in the JSON result back to the calling program.

response_ms

Show the scripts response time in milli seconds from initial request to display of results.

plate

The vehicle number plate the report will relate to.

desc

The Vehicle lookout report as per the NP Tracker dataset.
Report length can be trimmed to a specified length with the trim pagameter.
Each message picked up will be delimited with **@**.

last_date

The timestamp of the latest (last) report for the vehicle.

report_date

The timestamp of the first report for the vehicle.

result

Always returns a true.

version

The version of the API endpoint.