POST rule engine/triggers
From Social ID Developers
(Difference between revisions)
(14 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
== Description == | == Description == | ||
− | Trigger an event for a | + | Trigger an event for a Login User. |
+ | |||
+ | See all available [[Rule Engine Events|events]]. | ||
== Resource URL == | == Resource URL == | ||
Line 12: | Line 14: | ||
{| | {| | ||
− | ! align="left" width="200px" | | + | ! align="left" width="200px" | trigger |
− | | width="200px" | required | + | | width="200px" | required |
− | | | + | | A hash in the format field:value, with the necessary fields for the trigger: |
|- | |- | ||
− | ! align="left" width="200px" | | + | ! align="left" width="200px" style="padding-left: 20px" | account_source |
+ | | width="200px" | required | ||
+ | | Type of account source. Allowed values: ''account'', ''adsp''. | ||
+ | |- | ||
+ | ! align="left" width="200px" style="padding-left: 20px" | account_identifier | ||
| width="200px" | required <sup>1</sup> | | width="200px" | required <sup>1</sup> | ||
− | | | + | | Value of account source. |
|- | |- | ||
− | ! align="left" width="200px" | | + | ! align="left" width="200px" style="padding-left: 20px" | login_user_source |
− | | width="200px" | required | + | | width="200px" | required |
− | | user | + | | Type of login user source. Allowed values: ''login_user'', ''mac_address'', ''mpact_client_id''. |
|- | |- | ||
− | ! align="left" width="200px" | + | ! align="left" width="200px" style="padding-left: 20px" | login_user_identifier |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
| width="200px" | required | | width="200px" | required | ||
− | | | + | | Value of login user source. |
+ | |- | ||
+ | ! align="left" width="200px" style="padding-left: 20px" | event_type | ||
+ | | width="200px" | optional | ||
+ | | Type of the event to be triggered. See all available [[Rule Engine Events|events]]. | ||
|- | |- | ||
− | ! align="left" width="200px" | event_attrs | + | ! align="left" width="200px" style="padding-left: 20px" | event_attrs |
| width="200px" | optional | | width="200px" | optional | ||
− | | | + | | A hash in the format field:value, with specific parameters for the triggered event. See all available [[Rule Engine Events|events]]. |
|} | |} | ||
− | <sup>1</sup> | + | <sup>1</sup> Must not be informed if ''account_source'' is set to ''account'', as the value is inferred from the authentication. |
− | + | ||
− | + | ||
== Authentication == | == Authentication == | ||
− | This API requires | + | This API requires Account authentication. See [[Authentication]]. |
== Response == | == Response == | ||
Line 65: | Line 69: | ||
== Examples == | == Examples == | ||
− | + | Trigger a "region_entered" event from AirDefense Services Platform (ADSP) to the user identified by the MAC address "0a:1b:2c:3d:4e:5f": | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
==== Request ==== | ==== Request ==== | ||
− | + | curl -iX POST 'https://api.socialidnow.com/v1/marketing/rule_engine/triggers' \ | |
− | -d '{" | + | -d '{ |
− | + | "trigger": { | |
− | + | "account_source": "adsp", | |
+ | "account_identifier": "24E3S8Z7S6CYI91IOOFN", | ||
+ | "login_user_source": "mac_address", | ||
+ | "login_user_identifier": "0a:1b:2c:3d:4e:5f", | ||
+ | "event_type": "region_entered", | ||
+ | "event_attrs": { | ||
+ | "region_name": "region A" | ||
+ | } | ||
+ | } | ||
+ | }' \ | ||
-H 'Content-type: application/json' \ | -H 'Content-type: application/json' \ | ||
--user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf | --user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf |
Latest revision as of 17:02, 30 December 2021
Contents |
Description
Trigger an event for a Login User.
See all available events.
Resource URL
POST https://api.socialidnow.com/v1/marketing/rule_engine/triggers
Parameters
JSON Parameters
trigger | required | A hash in the format field:value, with the necessary fields for the trigger: |
---|---|---|
account_source | required | Type of account source. Allowed values: account, adsp. |
account_identifier | required 1 | Value of account source. |
login_user_source | required | Type of login user source. Allowed values: login_user, mac_address, mpact_client_id. |
login_user_identifier | required | Value of login user source. |
event_type | optional | Type of the event to be triggered. See all available events. |
event_attrs | optional | A hash in the format field:value, with specific parameters for the triggered event. See all available events. |
1 Must not be informed if account_source is set to account, as the value is inferred from the authentication.
Authentication
This API requires Account authentication. See Authentication.
Response
Response Status
accepted (202) | The event was accepted and will be processed. |
---|---|
bad_request (400) | Some required parameter was not informed. |
unauthorized (401) | The authentication is wrong. See Authentication. |
internal_server_error (500) | An unknown error happened. |
Examples
Trigger a "region_entered" event from AirDefense Services Platform (ADSP) to the user identified by the MAC address "0a:1b:2c:3d:4e:5f":
Request
curl -iX POST 'https://api.socialidnow.com/v1/marketing/rule_engine/triggers' \ -d '{ "trigger": { "account_source": "adsp", "account_identifier": "24E3S8Z7S6CYI91IOOFN", "login_user_source": "mac_address", "login_user_identifier": "0a:1b:2c:3d:4e:5f", "event_type": "region_entered", "event_attrs": { "region_name": "region A" } } }' \ -H 'Content-type: application/json' \ --user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf
Response
Response Headers
HTTP/1.1 202 Accepted Status: 202