| Requires the role: | EventPublisher |
| POST | /client/{externalOrganizationId}/events | Accepts and stores a collection of IoT events from an external system. |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ExternalOrganizationId | path | string | Yes | External Organization Id |
| Events | body | List<ExternalOrganizationEvent> | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| AccessId | form | string | No | |
| Timestamp | form | DateTime | No | |
| Event | form | int | No | |
| EventData | form | Object | No | |
| EventType | form | string | No | |
| AccessPointId | form | string | No |
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /client/{externalOrganizationId}/events HTTP/1.1
Host: api.4spaces.io
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length
{
externalOrganizationId: String,
events:
[
{
access_id: String,
timestamp: -62135596800000,
event: 0,
event_data: {},
event_type: String,
access_point_id: String
}
]
}