Submitting observations to the InfoEx via the CAAML 3.0.3 API

REQUIREMENTS
Permission	Operation Administrator and higher
Connectivity	Online only

This document describes how to submit observations from an external database system to the InfoEx via its CAAML 3.0.34 API. This document is aimed at IT system administrators who are setting up the exchange between the two systems on behalf of the InfoEx subscriber.

Background

To submit to the InfoEx system via the CAAML 3.0.3 API, the operator needs two pieces of information from the CAA:

• API Key
  A secret token that uniquely identifies the submitting system and provides it with administration privileges for the operation.
• Operation UUID
  The universally unique identifier of the operation used in the InfoEx system.

Please connect with the InfoEx manager at the Canadian Avalanche Association to get this information for your operation.

The CAAML 3.0.3 API is intended to make the transition of existing data systems that directly submit observations to the new InfoEx as easy as possible. By supporting the submission via the legacy CAAML 3.0.3 file format, the submission procedure of these systems only has to be adjusted minimally for the 2013/14 winter season. As a consequence, however, the InfoEx CAAML 3.0.3 API only supports observation types what were used in the legacy InfoEx system during the 2012/13 winter season. Any of the new functionalities that the new InfoEx system offers (e.g., hazard assessments, PWL tracking) is not supported by this API.

NOTE

The CAAML 3.0.3 API will only be made accessible to data systems that already submitted observation directly to the legacy InfoEx system. Any new developments should be using the more advanced JSON API that is used internally by the new InfoEx system or the future CAAML 5.0 API which will both support the full functionality of the new system.

Step-by-step description

Submission of observations via CAAML 3.0.3 API

This section described the different components of the HTTPS POST call

1.	HTTPS POST URL Production server: https://infoex.avalancheassociation.ca/CAAML/v3 Training server: https://training-infoex.avalancheassociation.ca/CAAML/v3
2.	HTTP HEADERS Accept: application/json operation: <operation-uuid> api_key: <API_KEY>
3.	HTTP POST PAYLOAD (RAW XML UTF-8) Observations in CAAML 3.0.3 format.

Related documents

• Link to relate document 1
• Link to relate document 2

Functionality tested by

• Dec. 22, 2013: Pascal Haegeli