段落
GET https://pushye.com/api/segments/
curl --request GET \
--url 'https://pushye.com/api/segments/' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://pushye.com/api/segments/' \
--header 'Authorization: Bearer {api_key}' \
| 参数 | 细节 | 描述 |
|---|---|---|
| page | 可选的 整数 | 您想要结果的页码。默认为 1。 |
| results_per_page | 可选的 整数 | 每页您想要多少个结果。允许的值是：10 , 25 , 50 , 100 , 250 , 500 , 1000。默认为25。 |
{
"data": [
{
"id": 1,
"user_id": 1,
"website_id": 1,
"name": "API Sample",
"settings": {
"subscribers_ids": [1,2,3,4,5]
},
"type": "custom",
"total_subscribers": 5,
"last_datetime": null,
"datetime": "2025-02-05 12:54:56"
}
],
"meta": {
"page": 1,
"results_per_page": 25,
"total": 1,
"total_pages": 1
},
"links": {
"first": "https://pushye.com/api/segments?&page=1",
"last": "https://pushye.com/api/segments?&page=1",
"next": null,
"prev": null,
"self": "https://pushye.com/api/segments?&page=1"
}
}
GET https://pushye.com/api/segments/{segment_id}
curl --request GET \
--url 'https://pushye.com/api/segments/{segment_id}' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://pushye.com/api/segments/{segment_id}' \
--header 'Authorization: Bearer {api_key}' \
{
"data": {
"id": 1,
"user_id": 1,
"website_id": 1,
"name": "API Sample",
"settings": {
"subscribers_ids": [1,2,3,4,5]
},
"type": "filter",
"total_subscribers": 5,
"last_datetime": null,
"datetime": "2025-02-05 12:54:56"
}
}
POST https://pushye.com/api/segments
| 参数 | 细节 | 描述 |
|---|---|---|
| website_id | 必需 整数 | - |
| name | 必需 字符串 | - |
| type | 可选的 字符串 | 允许的值：custom , filter |
| subscribers_ids | 可选的 字符串 | 可用时间：segment = custom |
| filters_custom_parameter_key[index] | 可选的 字符串 | 可用时间：segment = filter |
| filters_custom_parameter_value[index] | 可选的 字符串 | 可用时间：segment = filter |
| filters_custom_parameter_value[index] | 可选的 字符串 | 可用时间：segment = filter |
| filters_subscribed_on_url | 可选的 字符串 | 可用时间：segment = filter |
| filters_cities | 可选的 字符串 | 可用时间：segment = filter |
| filters_countries[] | 可选的 字符串 | 可用时间：segment = filter |
| filters_continents[] | 可选的 字符串 | 可用时间：segment = filter |
| filters_device_type[] | 可选的 字符串 | 可用时间：segment = filter |
| filters_languages[] | 可选的 字符串 | 可用时间：segment = filter |
| filters_operating_systems[] | 可选的 字符串 | 可用时间：segment = filter |
| filters_browsers[] | 可选的 字符串 | 可用时间：segment = filter |
curl --request POST \
--url 'https://pushye.com/api/segments' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example name' \
--form 'website_id=1' \
--form 'type=custom' \
--form 'subscribers_ids=1,2,3,4,5' \
--url 'https://pushye.com/api/segments' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example name' \
--form 'website_id=1' \
--form 'type=custom' \
--form 'subscribers_ids=1,2,3,4,5' \
{
"data": {
"id": 1
}
}
POST https://pushye.com/api/segments/{segment_id}
| 参数 | 细节 | 描述 |
|---|---|---|
| website_id | 可选的 整数 | - |
| name | 可选的 字符串 | - |
| type | 可选的 字符串 | 允许的值：custom , filter |
| subscribers_ids | 可选的 字符串 | 可用时间：segment = custom |
| filters_custom_parameter_key[index] | 可选的 字符串 | 可用时间：segment = filter |
| filters_custom_parameter_value[index] | 可选的 字符串 | 可用时间：segment = filter |
| filters_custom_parameter_value[index] | 可选的 字符串 | 可用时间：segment = filter |
| filters_subscribed_on_url | 可选的 字符串 | 可用时间：segment = filter |
| filters_cities | 可选的 字符串 | 可用时间：segment = filter |
| filters_countries[] | 可选的 字符串 | 可用时间：segment = filter |
| filters_continents[] | 可选的 字符串 | 可用时间：segment = filter |
| filters_device_type[] | 可选的 字符串 | 可用时间：segment = filter |
| filters_languages[] | 可选的 字符串 | 可用时间：segment = filter |
| filters_operating_systems[] | 可选的 字符串 | 可用时间：segment = filter |
| filters_browsers[] | 可选的 字符串 | 可用时间：segment = filter |
curl --request POST \
--url 'https://pushye.com/api/segments/{segment_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example name' \
--form 'website_id=1' \
--form 'type=custom' \
--form 'subscribers_ids=1,2,3,4,5' \
--url 'https://pushye.com/api/segments/{segment_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example name' \
--form 'website_id=1' \
--form 'type=custom' \
--form 'subscribers_ids=1,2,3,4,5' \
{
"data": {
"id": 1
}
}
DELETE https://pushye.com/api/segments/{segment_id}
curl --request DELETE \
--url 'https://pushye.com/api/segments/{segment_id}' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://pushye.com/api/segments/{segment_id}' \
--header 'Authorization: Bearer {api_key}' \