Basic Trip Creation
From EveryTrail API Developer Documentation
Contents |
URL
/api/trip/create
Semantics
Required method: Creates a basic trip and assigns a trip ID which may be used for subsequent requests.
Parameters
| Parameter name | Parameter format | Required | Description |
|---|---|---|---|
| username | string | yes | username of user performing the request |
| password | string | yes | password of user performing the request |
| title | string | yes | title for the trip |
| description | string | no | Description (story) for the trip |
| tips | string | no | Tips for the trip |
| time | string in Standard Date Format | yes | Creation timestamp for the trip |
| activity | string | no | Activity for the trip. This parameter is matched case sensitively against the activities in the Activity List. If it does not exist there it will be listed as an "Other" activity. |
| activity_id | int | no | ID for activity of the trip. Either activity or activity_id is required. See Activity List. Don't include or use 0 if no activity. If you want to specify an activity not on the list, put it in the "activity" parameter |
| gps_device_id | int | no | See GpsDevice List |
| visibility_id | int | yes | The visibility of the trip on the server. See Visibility List |
| map_type | String | no | The default map type when viewing the trip Map Type List |
Success Response
<etTripCreateResponse status="success"> <tripID>${trip ID}</tripID> </etTripCreateReponse>
${trip ID}: integer ID of the trip created on the server
Error Reponse
<etTripCreateResponse status="error"> ${error reponse} </etTripCreateResponse>
${error reponse}: See format in Error Reponse Format
