Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

Obtaining the Session Token

All VB-Mapp Content Server REST API calls require an authorization token to allow access to the server.  The token can be found on the User page when logged in at http://vbmappdata.com.

Formatting the REST Request

Required Headers

The REST Request should have the following HTTP headers defined:

  • Authorization: Token token="<your session token here>"
  • Content-Type: application/json
  • X-ClientId: <the client id here>
  • X-ClientCode: <the client code here>

Optional Headers

The REST Request may have the following HTTP headers defined:

  • Accept-Language: <language> – Currently 'en' is supported ('es', 'fr' coming soon)

 

The 'X-ClientId' and 'X-ClientCode' header is not required on all requests.  However, when they are required either of the two may be provided to authenticate the call, both are not simultaneously required.

X-ClientCode equates the code field that is provided when the client record is created. This allows you to store a unique value in the code field, for example your primary key, and thus no changes to your data model are required to integrate the REST service.

Example

Here is an example curl script that uses the session token as seen in the above illustration:

curl -X GET \
-H 'Authorization: Token token="c1b297a8e1fda144588ee1f9ce23b23a"' \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-ClientId: 1" \
-H "Accept-Language: en" \

  http://data-sandbox.vbmappapp.com/1/vbmapp/index

 

 

 

  • No labels