Difference between revisions of "NPS-API"

From NP Tracker projects
Jump to navigation Jump to search
 
Line 6: Line 6:
 
}}
 
}}
 
[[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 RESTfull API into their apps.}}
+
{{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]].
+
For a high-speed client-side application interface see our [[NPS-API Webservice]].
 
== Interface ==
 
== Interface ==
 
This is a [[REST API]] endpoint using HTTP GET.<br>
 
This is a [[REST API]] endpoint using HTTP GET.<br>
Line 13: Line 13:
 
== Usage ==
 
== Usage ==
 
To use this endpoint you will need a valid [[API Key]] available after registration on [[NPS-CLOUD]].<br>
 
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 advance help and examples on using this endpoint.
+
See our [https://api.nptracker.co.za/docs/ API documentation page] for advanced help and examples on using this endpoint.
 
=== Parameters ===
 
=== Parameters ===
 
==== cmd ====
 
==== cmd ====
Line 54: Line 54:
  
 
=== response_ms ===
 
=== response_ms ===
Show the scripts response time in milli seconds from initial request to display of results.
+
Show the script's response time in milliseconds from the initial request to the display of results.
  
 
=== plate ===
 
=== plate ===
Line 60: Line 60:
  
 
=== desc ===
 
=== desc ===
The Vehicle lookout report as per the NP Tracker dataset.<br>
+
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> pagameter.<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>'''.
 
Each message picked up will be delimited with '''<strong>**@**</strong>'''.
  

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.