Razient Web Service

Customer:
The Username :
The Password :

This web service will allow you to return incidents stored in the Razient database. The webservice will return data
in json or xml format. To return records in either of these formats you have to add the extension .xml or .json to
return the format desired. The system administrator will send you an email with the user and password to be
used in order to access the web service. The system hash id also needs to be added in the request url. The
system hash id to use is: 35ra45456060ttyu5e56ddf75d34l230

The following options are allowed to invoke the webservice:

Option 1: Use this option to return all incidents within a latitude-Longitude for a
specific number of days and for given category.
This will return all incidents reported on one of the parameters bellows. For example if latitude=0 and longitude
=0 and days = 10 category = all. Will return all incidents for the past 10 days for all categories.

Request:
Latitude
Longitude
Days to Report (default 5)
Category (default all)
User
Password
Authorization Hash (prevent unauthorized use)

Response:
Incident ID
Incident Detail
(type,title,icons,date,latitude,longitude,city,state,country,address,numberkilled,url)
Incident Type
Incident Date
Latitude / Longitude
Authorization Hash

Parameters:
 Latitude : abreviature [lt] > required, double,
Validate { is Numeric }
 Longitude : abreviature [lg] > required, double,
Validate { is Numeric }

Razient - Confidential Page 1

  Days to Report : abreviature [dy] > required,numeric,
Validate { is Numeric }
 Category : abreviature [ct] > required, varchar
 User : abreviature [us] > required, varchar
 Password : abreviature [ps] > required, varchar
 Authorization Hash : abreviature [hs] > required, varchar

URL:

http://www.razient.com/Razient/service/wsauth/globalincidents/lt={latitude}/lg={long
itude}/dy={day}/ct={category}/us={user}/ps={password}/hs={hash}

Optional:
 If the value Latitude =0 and Longitude = 0,
The webservice will return all incidents for all latitudes/longitudes
 If the value dy =0 the default value to return is five days
 If ct = ALL, the webservice will return categories.

Example: (in the following example we are requesting incidents for lat=16.88820000 lon=-99.44970000 for the
past 7 days for all categories in xml format)

http://www.razient.com/Razient/service/wsauth/globalincidents/lt=16.88820000/lg=-
99.44970000/dy=7/ct=ALL/us=email@email.com/ps=1234567890/hs=35ra45456060ttyu5e56d
df75d34l230.xml

Result:

Razient - Confidential Page 2

Example Message Error: (this example shows the result obtained when an incorrect hash id is sent)

http://www.razient.com/Razient/service/wsauth/globalincidents/lt=16.88820000/lg=-
99.44970000/dy=7/ct=ALL/us=email@email.com/ps=1234567890/hs=656981afa306ddd32.xml

Result:
<globalincidents>
  <count>0</count>
  <isOk>false</isOk>
  <msg>Incorrect Hash ID</msg>
</globalincidents>

Example Message Error: (this example shows the result obtained when an incorrect user/password)

http://www.razient.com/Razient/service/wsauth/globalincidents/lt=16.88820000/lg=-
99.44970000/dy=7/ct=ALL/us=email@email.com/ps=242/hs=35ra45456060ttyu5e56ddf75d34
l230.xml

Result:

Razient - Confidential Page 3

 <globalincidents>
  <count>0</count>
  <isOk>false</isOk>
  <msg> Username or Password incorrect </msg>
</globalincidents>

Option 2: Use this option to return all details for a particular incident id
Request:
Incident ID
User
Password
Authorization Hash

Response:
Incident ID
Incident Detail
(type,title,icons,date,latitude,longitude,city,state,country,address,numberkilled,url)
Incident Type
Incident Date
Latitude / Longitude
Authorization Hash

Parameters:
 Incident ID : abreviature [id] > required, varchar
 User : abreviature [us] > required, varchar
 Password : abreviature [ps] > required, varchar
 HASH : abreviature [hs] > required, varchar

URL:
http://www.razient.com/Razient/service/wsauth/globalincident/id={id}/us={user}/ps={password}/h
s={hash}

Example: (in the following example we are requesting details for incident id=33298 in xml format)
http://www.razient.com/Razient/service/wsauth/globalincident/id=33298/us=email@email
.com/ps=1234567890/hs=35ra45456060ttyu5e56ddf75d341230.xml

Razient - Confidential Page 4

Result:

Option 3: Use this option to return all incidents for:

city/state/country/number of days/category
Request:
City
State
Country
Razient - Confidential Page 5
 Incident Type
Days to Report
User
Password
Authorization Hash

Response:
Incident ID
Incident Detail
(type,title,icons,date,latitude,longitude,city,state,country,address,numberkilled,url)
Incident Type
Incident Date
Latitude / Longitude
Authorization Hash

Parameters:
 city : abreviature [ci] > required, varchar
 state : abreviature [st] > required, varchar
 country : abreviature [co] > required, varchar
 Days to Report : abreviature [dy] > required,numeric,
Validate { is Numeric }
 Category : abreviature [ct] > required, varchar
 User : abreviature [us] > required, varchar
 Password : abreviature [ps] > required, varchar
 Authorization Hash : abreviature [hs] > required, varchar

URL:

http://www.razient.com/Razient/service/wsauth/globalincidents/ci={city}/st={stat
e}/co={country}/dy={day}/ct={category}/us={user}/ps={password}/hs={hash}

Optional:
 If ci = ALL, It consults all the cities.
 If st = ALL, It consults all the states.
 If co = ALL, It consults all the countries.
 If the value dy =0 then Days to Report = 5
 If ct = ALL, It consults all the incidents types.

Example: (in the following example we are requesting incidents for city: Rancho Viejo; State: ALL; Days:5;
Categories: All)

Razient - Confidential Page 6

http://www.razient.com/Razient/service/wsauth/globalincidents/ci=Rancho
%20Viejo/st=ALL/co=ALL/dy=5/ct=ALL/us=email@email.com/ps=1234567890/hs=35ra45456060t
tyu5e56ddf75d34l230.xml

Result:

Razient - Confidential Page 7