Forms

IN DEVELOPMENT: FEATURE IS CURRENTLY NOT AVAILABLE

Due to the dynamic nature of AffinityLive it's really difficult to determine what fields are available and required when creating and editing objects. The forms feature can be used to retrieve a list of required and optional fields for a given object or group of objects. Once you have selected the details you wish to store, you can then simply submit the form.

Endpoints

(POST|GET) [/object_type1,object_type2,..object_typeN]/_forms/fields

Request fields for given object type(s). For example, 

$ curl -XGET /addresses,contacts/_forms/fields

would give you the fields for addresses and contacts available to the current user, so something like this:

{
    "response": {
		"forms": {
			"addresses": [{
				"title": "Address",
				"fields": [{
					"key": "title",
					"title": "Title",
					"type": "text",
					"required": 1
				}, ...]
			}],
			"contacts": [{
				...
			}],
		}
	},
	"meta": { ... }
}

You can also pass the form information in as body data. This can be used to configure the forms, which we will discuss a little bit later in the document. For example,

$ curl -XPOST /_forms/fields -d'{
	"forms": {
		"addresses": { ... configure addresses form ... },
		"contacts: 1,
	}
}';

would return a similar structure of fields. The fields endpoint accept the following parameters:

• forms : The forms for each object type, with optional configuration options.

We currently support the following form object types, which are being used in our mobile applications:

• addresses
• companies
• contacts