URL gốc và xác thực
Mọi yêu cầu đều được gửi đến:Authorization của mỗi yêu cầu:
401.
Hãy tạo mã thông báo trong ứng dụng Gologin: API & MCP > API > Mã thông báo mới, hoặc trong phần API thuộc mục Connected accounts của AI Assistant. Bạn có thể tạo mã thông báo khi dùng gói trả phí và đã bật xác thực hai yếu tố trong Gologin.
Mặc định, việc gửi chỉ là chạy thử (dry run)
Lời mời, tin nhắn, bình luận và phản hồi chỉ được gửi đi khi bạn truyền"send": true. Nếu không có tham số này, yêu cầu chỉ là chạy thử: hệ thống kiểm tra đối tượng và cho bạn biết điều gì sẽ xảy ra - người nhận là ai, có thể gửi lời mời hay không, đã có hội thoại hay chưa - và không gửi gì cả. Hãy chạy thử trước, sau đó lặp lại yêu cầu với "send": true.
Việc đăng bài, thả cảm xúc và chấp nhận lời mời dùng các cờ riêng: publish, react và accept.
Kết nối tài khoản
- Lấy ID workspace của bạn:
GET https://api.gologin.com/workspacesvới cùng mã thông báo sẽ trả về các workspace của bạn cùngidcủa chúng. - Tạo tài khoản:
- Để đăng nhập, hãy truyền một trong các giá trị sau:
credentials(loginvàpassword),cookies, hoặcbrowserProfileId- một hồ sơ Gologin đã đăng nhập sẵn vào LinkedIn. - Với IP, hãy truyền
proxyCountry(các mã lấy từGET /available-countries) hoặcproxycủa riêng bạn (host,port, và tùy chọnprotocol,username,password). Hồ sơ Gologin được liên kết sẽ dùng proxy riêng của nó. - Để nhập các hội thoại hiện có, hãy thêm
"importHistory": true.
- Tài khoản được trả về với trạng thái
pendingtrong khi quá trình thiết lập đang chạy. Hãy kiểm traGET /accounts/{id}cho đến khistatusthay đổi:
Mỗi bước chờ kéo dài tối đa 10 phút. Nếu mã chưa được gửi hoặc đăng nhập chưa được xác nhận, trạng thái sẽ chuyển thành
auth_failed.
Tìm người và gửi lời mời
- Tìm kiếm.
GET /linkedin/people/search?accountId=ACCOUNT_ID&query=head%20of%20growthtrả vềprofile_urlvàprofile_idcủa từng người. Thay choquery, bạn có thể truyềnurl- một liên kết tìm kiếm LinkedIn cùng các bộ lọc của nó. - Kiểm tra hồ sơ.
GET /linkedin/profile?accountId=ACCOUNT_ID&profileUrl=PROFILE_URLhiển thịis_connected,is_pendingvàis_available_to_connect. - Mời. Hãy chạy thử trước:
connectable_dry_run nghĩa là lời mời sẽ được gửi đi. not_connectable cho biết lý do không thể gửi: already_connected, invite_pending hoặc connect_unavailable. Hãy lặp lại yêu cầu với "send": true. sent_verified nghĩa là LinkedIn đã tạo lời mời.
Gửi tin nhắn
POST /linkedin/messages/send nhận accountId, message và một trong các tham số sau:
profileUrl- để nhắn cho một người. Hệ thống sẽ tìm hội thoại với người đó, hoặc mở hội thoại mới nếu chưa có; phản hồi sẽ ghiexisting_conversationhoặcnew_conversation. Nếu chỉ có thể liên hệ người đó bằng InMail trả phí, bạn sẽ nhận đượcnot_messageablekèmpaid_inmail_required. Hệ thống không bao giờ tự động dùng InMail trả phí mà không báo trước.conversationId- để tiếp tục một hội thoại:conversation_idtừ/linkedin/inbox, ID luồng dạng2-…hoặc URL của luồng.
sent_verified cùng message_id và conversation_id.
Đọc hội thoại
GET /linkedin/inbox?accountId=ACCOUNT_IDliệt kê các hội thoại của tài khoản, mới nhất đứng đầu.GET /linkedin/messages/conversation?accountId=ACCOUNT_ID&conversationId=CONVERSATION_IDtrả về các tin nhắn, cũ nhất đứng đầu.limitchỉ giữ lại những tin nhắn gần đây nhất.GET /workspaces/{workspaceId}/conversationsliệt kê các hội thoại của mọi tài khoản trong workspace, vàGET /workspaces/{workspaceId}/inbox/unreadtrả về số lượng tin nhắn chưa đọc.
Nhận tin nhắn mới qua webhook
{ accountId, workspaceId, event }. Hệ thống sẽ thử gửi lại khi có lỗi, và cùng một sự kiện có thể đến hai lần, vì vậy hãy loại bỏ trùng lặp theo event.id. Để xóa webhook, hãy gửi {"url": null}. Localhost và các địa chỉ nội bộ không được chấp nhận.
Giới hạn
Các hành động qua API được tính vào cùng các giới hạn như trong ứng dụng.GET /accounts/{id}/limitstrả về giai đoạn (stage) của tài khoản và mọi giới hạn: giá trị khuyến nghị, giá trị riêng của bạn, giá trị được áp dụng, mức đã dùng vàresetsAt- thời điểm khung thời gian có chỗ cho thêm một hành động.PUT /accounts/{id}/limitsthay đổistagehoặc các giá trị riêng của bạn trongcustomLimits. Giá trịnullsẽ xóa giá trị riêng của bạn.DELETE /accounts/{id}/limits/customđặt lại toàn bộ giới hạn về mức khuyến nghị.GET /workspaces/{workspaceId}/accounts-usagecho biết workspace của bạn có thể kết nối bao nhiêu tài khoản và đã dùng bao nhiêu vị trí (seat).
Các lỗi cần biết
Làm nóng trước khi chạy hàng loạt
Một phiên không được sử dụng sẽ dần cũ đi, và lệnh gọi đầu tiên sau đó mất vài giây. Hãy gọiPOST /accounts/{id}/warmup trước một loạt lệnh gọi hoặc ngay sau khi đăng nhập lại. Tài khoản phải ở trạng thái active.