Campaign

Campaign list

GET https://partner-api.sddan.com/api/v1/public/event-notify/campaign

Get campaign list

Query Parameters

Name	Type	Description
size	number	number of maximum campaign returned by call
page	number

Headers

Name	Type	Description
Authorization	string	token

200

[
    {
      "id": "xxxxxxx-2feb-481a-9910-6d71dc337b00",
      "id_audience": "xxxxxx-6e58-4db7-8ada-53b7bace6da4",
      "id_partner": 12345,
      "name": "My first campaign",
      "notify_method": "WEBHOOK",
      "devices": [
        "DESKTOP",
        "MOBILE"
      ],
      "event": [
        "ONLINE"
      ],
      "map_value_types": [
        "EMAIL_HASH"
      ],
      "active": true,
      "start": "2019-07-25T17:09:41.32419522+02:00",
      "end": "2019-09-30T00:09:41.32419522+02:00",
      "max_event_age_in_second": 300,
      "max_notifying_per_id": 1000,
      "delay_before_notify_same_id_in_second": 3600,
      "webhook_endpoint": "https://my-endpoint.com/api/v1/endpoint",
      "capping_notify_per_minute": null,
      "status_endpoint": null,
      "filter_partner_audience": true,
      "ready_for_activation": true,
      "uploaded_ids": 0
    }
]

404 Could not find a cake matching this query.

Campaign

GET https://partner-api.sddan.com/api/v1/public/event-notify/campaign/:id

Path Parameters

Name	Type	Description
id	string	campaign id

Headers

Name	Type	Description
Authorization	string	token

200

    {
      "id": "xxxxxxx-2feb-481a-9910-6d71dc337b00",
      "id_audience": "xxxxxx-6e58-4db7-8ada-53b7bace6da4",
      "id_partner": 12345,
      "name": "My first campaign",
      "notify_method": "WEBHOOK",
      "devices": [
        "DESKTOP",
        "MOBILE"
      ],
      "event": [
        "ONLINE"
      ],
      "map_value_types": [
        "EMAIL_HASH"
      ],
      "active": true,
      "start": "2019-07-25T17:09:41.32419522+02:00",
      "end": "2019-09-30T00:09:41.32419522+02:00",
      "max_event_age_in_second": 300,
      "max_notifying_per_id": 1000,
      "delay_before_notify_same_id_in_second": 3600,
      "webhook_endpoint": "https://my-endpoint.com/api/v1/endpoint",
      "capping_notify_per_minute": null,
      "status_endpoint": null,
      "filter_partner_audience": true,
      "ready_for_activation": true,
      "uploaded_ids": 0
    }

404

Create campaign

POST https://partner-api.sddan.com/api/v1/public/event-notify/campaign

JSON body

Headers

Name	Type	Description
Authorization	string	token

Request Body

Name	Type	Description
filter_partner_audience	boolean	should used only traffic linked to partner id?
ready_for_activation	boolean	is campaign should start?
status_endpoint	string	if precise, notify service will call this URL to check if notifying must continue
capping_notify_per_minute	number	max number of notify sent by minute
webhook_endpoint	string	url called by service to notify
delay_before_notify_same_id_in_second	number
max_notifying_per_id	number	max notification by hash (or reference id if used in upload)
max_event_age_in_second	number	max event age in second before notification
end	string	end time, example : 2019-10-01T00:09:41.32419522+02:00
start	string	start time, example : 2019-07-25T17:09:41.32419522+02:00
map_value_types	string	["EMAIL_HASH"]
event	array	["ONLINE"]
devices	array	["DESKTOP","MOBILE"]
notify_method	string	only value for now : WEBHOOK
name	string	campaign name
id_audience	string	audience id

200

    {
      "id": "xxxxxxx-2feb-481a-9910-6d71dc337b00",
      "id_audience": "xxxxxx-6e58-4db7-8ada-53b7bace6da4",
      "id_partner": 12345,
      "name": "My first campaign",
      "notify_method": "WEBHOOK",
      "devices": [
        "DESKTOP",
        "MOBILE"
      ],
      "event": [
        "ONLINE"
      ],
      "map_value_types": [
        "EMAIL_HASH"
      ],
      "active": true,
      "start": "2019-07-25T17:09:41.32419522+02:00",
      "end": "2019-09-30T00:09:41.32419522+02:00",
      "max_event_age_in_second": 300,
      "max_notifying_per_id": 1000,
      "delay_before_notify_same_id_in_second": 3600,
      "webhook_endpoint": "https://my-endpoint.com/api/v1/endpoint",
      "capping_notify_per_minute": null,
      "status_endpoint": null,
      "filter_partner_audience": true,
      "ready_for_activation": true,
      "uploaded_ids": 0
    }

400

Update campaign

PUT https://partner-api.sddan.com/api/v1/public/event-notify/campaign/:id

Use same parameters as create campaign

Path Parameters

Name	Type	Description
id	string	campaign id

Headers

Name	Type	Description
Authorization	string	token

200

    {
      "id": "xxxxxxx-2feb-481a-9910-6d71dc337b00",
      "id_audience": "xxxxxx-6e58-4db7-8ada-53b7bace6da4",
      "id_partner": 12345,
      "name": "My first campaign",
      "notify_method": "WEBHOOK",
      "devices": [
        "DESKTOP",
        "MOBILE"
      ],
      "event": [
        "ONLINE"
      ],
      "map_value_types": [
        "EMAIL_HASH"
      ],
      "active": true,
      "start": "2019-07-25T17:09:41.32419522+02:00",
      "end": "2019-09-30T00:09:41.32419522+02:00",
      "max_event_age_in_second": 300,
      "max_notifying_per_id": 1000,
      "delay_before_notify_same_id_in_second": 3600,
      "webhook_endpoint": "https://my-endpoint.com/api/v1/endpoint",
      "capping_notify_per_minute": null,
      "status_endpoint": null,
      "filter_partner_audience": true,
      "ready_for_activation": true,
      "uploaded_ids": 0
    }

302

404