Bỏ qua tới phần tài liệu
API

Liệt kê nhóm đối tượng

Nhóm đối tượng là một danh sách liên hệ có tên trong không gian làm việc này. Mọi liên hệ đều nằm trong nhóm đối tượng mặc định có sẵn ngay từ khi được tạo, và `builtin` là trường đánh dấu hàng đó; các nhóm còn lại do bạn tạo, thêm liên hệ và xóa. Nhóm đối tượng mặc định đứng đầu, sau đó là các nhóm còn lại theo thứ tự mới nhất trước. Phiên bản này chỉ quản lý danh sách và không gửi gì tới chúng, nên không có endpoint gửi hàng loạt nào để tìm.

GETapi.openemail.uk/audiences

Chạy lệnh gọi thật với không gian làm việc của bạn, bằng khóa của chính bạn.

GET /audiences

Nhóm đối tượng là một danh sách liên hệ có tên trong không gian làm việc này. Mọi liên hệ đều nằm trong nhóm đối tượng mặc định có sẵn ngay từ khi được tạo, và builtin là trường đánh dấu hàng đó; các nhóm còn lại do bạn tạo, thêm liên hệ và xóa. Nhóm đối tượng mặc định đứng đầu, sau đó là các nhóm còn lại theo thứ tự mới nhất trước. Phiên bản này chỉ quản lý danh sách và không gửi gì tới chúng, nên không có endpoint gửi hàng loạt nào để tìm.

Ví dụ

Cần audiences:read. limit tối đa là 100 và mặc định là 25.

curl
curl "$OE/audiences" -H "$AUTH"
Phản hồi
{  "object": "list",  "data": [    {      "object": "audience",      "id": "aud_9f2c4b7e1a0d63d84c5f2e7b",      "name": "All contacts",      "description": null,      "builtin": "default",      "contactCount": 412,      "createdAt": "2026-08-01T10:00:00.000Z",      "updatedAt": "2026-08-01T10:00:00.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

Hãy rẽ nhánh theo builtin chứ không theo tên. Bất kỳ ai cũng có thể đổi tên nhóm đối tượng mặc định, và tên là thứ duy nhất của nó có thể thay đổi.

Nhóm đối tượng mặc định được xác lập ở lần đọc đầu tiên, nên một không gian làm việc chưa từng tạo nhóm đối tượng nào vẫn liệt kê đúng một hàng.

contactCount được đếm tại thời điểm đọc, nên hai lần đọc trước và sau một thao tác tạo sẽ lệch nhau một đơn vị. Tên không phải là duy nhất, vì vậy hãy lưu id thay vì tên.