WikiAdmin: 1 revision imported

2023-07-14T12:58:50Z

1 revision imported

← Older revision	Revision as of 12:58, 14 July 2023
(No difference)

Pmorey: Created page with "==Verifi== ===Description=== Verifi uses a subscription based REST API that requires periodic polling to retrieve statuses accumulated since the last poll request. Multiple s..."

2018-11-08T14:08:02Z

Created page with "==Verifi== ===Description=== Verifi uses a subscription based REST API that requires periodic polling to retrieve statuses accumulated since the last poll request. Multiple s..."

New page

==Verifi==
===Description===

Verifi uses a subscription based REST API that requires periodic polling to retrieve statuses accumulated since the last poll request. Multiple statuses for multiple trucks may be received in a single poll request.

===REST API===

There are three API resources that handle status requests. When calling any of these resources, you must include the following HEADER parameters:

<pre>
verifi-user=(provided by verifi)
verify-user-pass=(provided by verifi)
</pre>

====Subscription Request====

Before polling, a "subscription request" call must be made. This is a POST call that includes body content. This call only needs to be made ONCE per session.

<pre>
POST https://portal.verificoncrete.com/rs/api/1.0/subscription

Body:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<verifi-subscription-request xmlns="https://portal.verificoncrete.com/api/1.0/xml/subscription" min-gps-interval-seconds="0">
<context>
<all/>
</context>
</verifi-subscription-request>
</pre>

====Poll Statuses====

At periodic intervals, make a GET call to the "poll status" resource. This will return all the statuses accumulated since the last call.

<I>NOTE: It is easier to obtain the results in JSON versus XML. To do this, add an "Accept" header to this call with the value "application/json".</I>

<pre>
GET https://portal.verificoncrete.com/rs/api/1.0/subscription
</pre>

Sample Response: (TBD)

Status Codes:
*404 (Resource not found) - There are no statuses since the last call.
*410 (Gone) - The Verifi session has timed out, you need to make the "subscription request" call again.

====Unsubscribe====

When your session is complete, you should "unsubscribe" by making this DELETE call:

<pre>
DELE https://portal.verificoncrete.com/rs/api/1.0/subscription
</pre>

GPS System Diagnostics - Revision history

WikiAdmin: 1 revision imported

Pmorey: Created page with "==Verifi== ===Description=== Verifi uses a subscription based REST API that requires periodic polling to retrieve statuses accumulated since the last poll request. Multiple s..."