[Index]
Describes a Device Model which maps to API endpoints of some external application (device)
Title | Description | Details | |||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Name * | Name of this Device Model and resulting model type i.e. device/<Device Type>/<Name> |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Documentation | Documentation text for this model |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Version * | Version of this model |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Device Type * | Device type for e.g. device/facebook |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Primary Key Field * | This is the field returned by an add operation that uniquely identifies the created entity for e.g. id |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Meta Information | Meta information for this Device Model |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Summary Attributes | Summary attributes for this model. This defines the data returned in API list requests. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
API Operations | List of API endpoint definitions as they map to model operations |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Action * | Name of the device model operation for e.g. add |
|
|||||||||||||||||||||||||||||||||||||||||||||||
URI | URI for the API request |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Target | Target of this operation Default: HTTP |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Request Format | Request format Default: JSON |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Response Format | Response format Default: JSON |
|
|||||||||||||||||||||||||||||||||||||||||||||||
HTTP Method | HTTP method for API request Default: get |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Response Code Template | Jinja template for mapping API endpoint specific error/status response |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Request Headers | HTTP request headers to send with API operation request. Takes precedence over default request headers specified on related Connection Parameters Type instance. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Name * | Name of HTTP request header, e.g. Accept. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Value * | Value of HTTP request header, e.g. text/plain. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Response Handlers | Handlers to execute on API responses. Only those response handlers' which condition evaluate to True are executed. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Condition * | Jinja template which if evaluation results in a value of True will cause the specified handler type to be executed, e.g. {{ status_code == 429 }}. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Type * | Response handler type to execute if specified condition evaluates to True, e.g. Backoff & Retry. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Variables | List of context variables availble to template rendering (supports Macros) |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Name | Context variable name. This will appear in the context as 'variables.<name>' |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Value | Value of this variable. This field supports Macros |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Pre-request Calls | List of API calls to make before making this request |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Post-request Calls | List of API calls to make after making this request |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Request Template | Jinja template for API request. Maps system schema to external application schema. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Response Template | Jinja template for API response. Maps external application schema to system schema. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Operations | List of supported operations |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Instance Operations | List of supported instance operations |
|
|||||||||||||||||||||||||||||||||||||||||||||||
List Operations | List of supported list operations |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Schema * | JSON schema of the model |
|