Difference between revisions of "NPS-API"
| 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 | + | {{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 | + | 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 | + | 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> | + | 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
 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.
Contents
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.
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.
