Chuyển đến nội dung chính
Các nhà tích hợp trên Business Plan hoặc Enterprise Plan có thể đưa các tài khoản mạng xã hội của khách hàng vào dưới các sub-profile. Sử dụng MCP Server, một agent tạo một sub-profile, nhắm tới nó và tạo một URL liên kết single sign-on mà khách hàng mở ra để kết nối các tài khoản của họ.

​
Quy trình

1

Tạo một sub-profile

Gọi create_profile (cấp tài khoản — không có profileKey). Nó trả về một profile key cho sub-profile mới.
2

Nhắm tới sub-profile

Sử dụng profile key được trả về trên các lệnh gọi tiếp theo — hoặc qua header Profile-Key trên kết nối hoặc dưới dạng đối số profileKey theo lệnh gọi. Xem Kết nối & Thiết lập để biết thứ tự ưu tiên.
3

Tạo URL social-linking

Gọi generate_jwt_social_linking_url để tạo một URL liên kết single sign-on. Khóa ký JWT và tên miền onboarding được lấy phía server — người gọi không cung cấp header X-Ayrshare-* và không cần khóa riêng hoặc tên miền.
4

Khách hàng liên kết tài khoản của họ

Khách hàng mở URL và ủy quyền (OAuth) các tài khoản mạng xã hội của họ. Các tài khoản đã kết nối được liên kết với sub-profile.

​
Yêu cầu

generate_jwt_social_linking_url yêu cầu một profileKey. Nếu không có, lệnh gọi trả về 400 với thông báo “Profile Key is required…”.Một tên miền social-linking phải được cấp phép cho tài khoản của bạn. Điều này có sẵn trên các gói Business và Enterprise.

​
Trạng thái lỗi

Điều kiệnPhản hồi
Không có tên miền được cấp phép400 — “No social-linking domain is provisioned for this account (available on Business/Enterprise plans).”
Không có khóa ký400 — “No signing key found for this account’s social-linking domain.”

​
Các bước tiếp theo

Kết nối & Thiết lập

Xác thực và nhắm tới profile.

Danh mục Công cụ

27 công cụ được nhóm theo miền, với phạm vi và mục đích.