/api/import/forms/:id

Loads data import form specified by ID.

Resource Information

Resource URL

https://service.belladati.com/api/import/forms/:id

HTTP Method

GET

Request Parameters

Parameters

Detail

Example

id

ID of the form to load. You can find the ID in the response to GET /api/import/forms

123

Response Structure

{
      "id": 123,
      "name": "My Data Collecting Form",
      "recordTimestamp": false,
      "tags": [
        "my tag 123456",
        "my another tag"
      ],
      "elements": [
        {
          "id": "mNdZBe1rMY",
          "name": "Field",
          "type": "username"
        }
	  ]
}

Name

Description

id

Import form identifier.

name

Name of import form.

recordTimestampBoolean flag indicating if timestamp should be recorded.
tagsArray of string tags.
elements

Array of form elements - fields.

NameDescription
idElement identifier.
nameElement name - title displayed next to field.
type

Element type - please see list of supported values.

mapToDateColumnOnly if "type" has value "datefield". Flag if value should be mapped to date column.
items

Only if "type" has value "select". Array of options in select box.

NameDescription
nameOption value displayed in select box


Sample Request / Response

Using curl:

curl -H "Authorization: OAuth realm=\"https://service.belladati.com/\", oauth_consumer_key=\"myConsumer\", oauth_token=\"mh7an9dkrg59\", oauth_timestamp=\"135131231\", oauth_nonce=\"randomString\"" https://service.belladati.com/api/import/forms/123

The JSON format response:

  	{
      "id": 123,
      "name": "My Data Collecting Form",
      "recordTimestamp": false,
      "tags": [
        "my tag 123456",
        "my another tag"
      ],
      "elements": [
        {
          "id": "mNdZBe1rMY",
          "name": "Username",
          "type": "username"
        },
        {
          "id": "wo35CMzcGV",
          "name": "Country",
          "type": "textfield"
        },
        {,
          "id": "N9zpsXG4WI",
          "name": "Birth Date",
          "type": "datefield",
          "mapToDateColumn": true
        },
        {
          "id": "ZdXAW61ko5",
          "name": "Gender",
          "type": "select",
          "items": [
            {"name": "Male"},
            {"name": "Female"},
            {"name": "Other"}
          ]
        },
        {
          "name": "Are you smiling right now?",
          "id": "WSyh9tSkut",
          "type": "checkbox"
        },
        {
          "name": "Timestamp Value",
          "id": "mw0qjAfe66",
          "type": "timestamp"
        }
      ]
    }
  • No labels