Difference between revisions of "NPS-API"

From NP Tracker projects
Jump to navigation Jump to search
 
(29 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
{{#seo:
 +
|title=API
 +
|titlemode=append
 +
|keywords=NPS-API, API, Vehicle database, Twitter, NP Tracker suspect vehicles, NP Tracker, Suspect vehicle, Crime-fighting, Crime, numberplate, number plate
 +
|description=API interface to do vehicle lookups and vehicle type checks on the NP Tracker database
 +
}}
 
[[File:Datasheet250.png|200px|thumb|right|Datasheet250 NPS-API NP Tracker suspect vehicle API interface]]<br>
 
[[File:Datasheet250.png|200px|thumb|right|Datasheet250 NPS-API NP Tracker suspect vehicle API interface]]<br>
 +
{{API|1=This is the developer's corner to aid in integrating our RESTful 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.<br>
 +
Available to any device/server on the internet.<br>
 +
== Usage ==
 +
To use this endpoint you will need a valid [[API Key]] available after registration on [[NPS-CLOUD]].<br>
 +
See our [https://api.nptracker.co.za/docs/ API documentation page] for advanced 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 <i>str</i> vehicle registration numberplate.
 +
===== demo =====
 +
===== ping =====
 +
 +
===== nps =====
 +
Test the supplied <i>str</i> vehicle registration numberplate.
 +
===== mute =====
 +
Mute the <i>str</i> vehicle registration numberplate and <strong>DON't</strong> provide a lookout report for this plate.
 +
===== unmute =====
 +
Unmute the <i>str</i> 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.<br>
 +
 +
==== history ====
 +
Only show reports not exceeding the provided value in months.<br>
 +
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.
 +
[[File:NP-API JSON.png|400px|thumb|right|NPS-API JSON output]]
 +
=== id ===
 +
Echo the supplied id parameter in the JSON result back to the calling program.
 +
 +
=== response_ms ===
 +
Show the script's response time in milliseconds from the initial request to the display of results.
 +
 +
=== plate ===
 +
The vehicle number plate the report will relate to.
 +
 +
=== desc ===
 +
The Vehicle lookout report is as per the NP Tracker dataset.<br>
 +
Report length can be trimmed to a specified length with the <u>trim</u> parameter.<br>
 +
Each message picked up will be delimited with '''<strong>**@**</strong>'''.
 +
 +
=== 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.

Latest revision as of 09:38, 31 May 2023

Datasheet250 NPS-API NP Tracker suspect vehicle API interface


Note This is the developer's corner to aid in integrating our RESTful 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 advanced 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 script's response time in milliseconds from the initial request to the display of results.

plate

The vehicle number plate the report will relate to.

desc

The Vehicle lookout report is as per the NP Tracker dataset.
Report length can be trimmed to a specified length with the trim parameter.
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.