Difference between revisions of "NPS-SHARE"

From NP Tracker projects
Jump to navigation Jump to search
(message)
(Usage)
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
{{#seo:
 +
|title=API
 +
|titlemode=append
 +
|keywords=API, NPS-SHARE, Sharing intel, Crime-fighting,
 +
|description=API interface to share and test incidents on clients platform - supplied for free to the crime-fighting community
 +
}}
 
[[File:Datasheet220.png|200px|thumb|right|Datasheet220 NPS-SHARE. Sharing intel initiative]]
 
[[File:Datasheet220.png|200px|thumb|right|Datasheet220 NPS-SHARE. Sharing intel initiative]]
{{warning|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 RESTfull API into their apps.}}
 
== Interface ==
 
== Interface ==
 
This is a [[REST API]] endpoint using HTTP GET.<br>
 
This is a [[REST API]] endpoint using HTTP GET.<br>
 
Available to any device/server on the internet.
 
Available to any device/server on the internet.
 
== 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 for third-party partners please contact us at [email protected] to set up an account.<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 advance help and examples on using this endpoint.
 
=== Parameters ===
 
=== Parameters ===
Line 19: Line 25:
 
[[File:NPS-SHARE JSON.png|400px|thumb|right|NPS-SHARE JSON output]]
 
[[File:NPS-SHARE JSON.png|400px|thumb|right|NPS-SHARE JSON output]]
 
=== report ===
 
=== report ===
 +
boolean value:
 +
* <i>true</i>: There is a existing NP Tracker vehicle lookout report. See url for a link to the lookout report.
 +
* <i>false</i>: There is no lookout report for this vehicle currently in the NP Tracker system.
 
=== plate ===
 
=== plate ===
 +
The first plate that was detected in the submitted incident (message).
 
=== url ===
 
=== url ===
 +
URL to the lookout report for the detected plate.

Revision as of 09:52, 13 February 2021

Datasheet220 NPS-SHARE. Sharing intel initiative

Note This is the developer's corner to aid in integrating our RESTfull 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 for third-party partners please contact us at [email protected] to set up an account.
See our API documentation page for advance help and examples on using this endpoint.

Parameters

message

URI encoded a message of the incident you need to test and share with the NP Tracker project.
Please note that the incident will be logged in the NP Tracker suspect and suspicious database if it contains a vehicle registration number.

token

Contact us at [email protected] to create an access token and define your free details that users will see ones a plate from your incident are looked up on NP Tracker.

Output

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

NPS-SHARE JSON output

report

boolean value:

  • true: There is a existing NP Tracker vehicle lookout report. See url for a link to the lookout report.
  • false: There is no lookout report for this vehicle currently in the NP Tracker system.

plate

The first plate that was detected in the submitted incident (message).

url

URL to the lookout report for the detected plate.