Basics

The following information provides an overview of some key concepts within the CrowdVision Developer API. Some familiarity with RESTful programming concepts and the associated tools and techniques for consuming web services is a pre-requisite.

Scheme (SSL/TLS)

All calls should be sent using https. Calls received using http will receive a 301 redirecting them to https.

Picture

HTTP Methods

The Travel Data Services API is designed to have predictable, resource-oriented URLs and HTTP Methods (aka verbs) to make learning easier. The following standard HTTP Methods are used:

Content Types

Unless otherwise noted, all endpoints within the API accept and return data formatted as JSON. The Content-Type request header with a value of application/json is required when providing content in the body of a request.

Response Status Codes

Picture

Paging

Endpoints that return multiple items support paging using the following query parameters:


PageSize

The number of items to return in a response. The default value is 10.


PageNumber

Pages are numbered starting at 1. Each page contains up to PageSize items as noted above. For example, to retrieve items 11 through 20, the PageSize should be set to 10 and the PageNumber set to 2. The default value for PageNumber is 1.