Base URL i uwierzytelnianie
Wszystkie żądania trafiają pod adres:Authorization każdego żądania przekaż swój token API Gologin:
401.
Token utworzysz w aplikacji Gologin: API & MCP > API > New Token albo w sekcji API w obszarze Connected accounts w AI Assistant. Token można utworzyć w płatnym planie, jeśli w Gologin jest włączone uwierzytelnianie dwuskładnikowe.
Wysyłka domyślnie działa w trybie próbnym (dry run)
Zaproszenia, wiadomości, komentarze i odpowiedzi są wysyłane tylko wtedy, gdy przekażesz"send": true. Bez tego żądanie jest próbą (dry run): sprawdza cel i informuje, co by się stało - kim jest odbiorca, czy zaproszenie jest możliwe, czy rozmowa już istnieje - ale niczego nie wysyła. Najpierw wykonaj próbę, a potem powtórz żądanie z "send": true.
Publikowanie postów, reakcje i akceptowanie zaproszeń mają własne flagi: publish, react i accept.
Połącz konto
- Pobierz ID swojego workspace:
GET https://api.gologin.com/workspacesz tym samym tokenem zwraca Twoje workspace’y i ichid. - Utwórz konto:
- Aby się zalogować, przekaż jedno z:
credentials(loginipassword),cookiesalbobrowserProfileId- profil Gologin, który jest już zalogowany do LinkedIn. - Dla adresu IP przekaż
proxyCountry(kody pochodzą zGET /available-countries) lub własnyproxy(host,portoraz opcjonalnieprotocol,username,password). Powiązany profil Gologin używa własnego proxy. - Aby zaimportować istniejące rozmowy, dodaj
"importHistory": true.
- Na czas konfiguracji konto ma status
pending. SprawdzajGET /accounts/{id}, ażstatussię zmieni:
Każde oczekiwanie trwa do 10 minut. Niewysłany kod lub niepotwierdzone logowanie kończy się wtedy statusem
auth_failed.
Znajdź osoby i wyślij zaproszenie
- Wyszukiwanie.
GET /linkedin/people/search?accountId=ACCOUNT_ID&query=head%20of%20growthzwracaprofile_urliprofile_iddla każdej osoby. Zamiastquerymożesz przekazaćurl- link do wyszukiwania LinkedIn wraz z filtrami. - Sprawdź profil.
GET /linkedin/profile?accountId=ACCOUNT_ID&profileUrl=PROFILE_URLpokazujeis_connected,is_pendingiis_available_to_connect. - Zaproś. Najpierw wykonaj próbę (dry run):
connectable_dry_run oznacza, że zaproszenie zostałoby wysłane. not_connectable podaje powód: already_connected, invite_pending lub connect_unavailable. Powtórz żądanie z "send": true. sent_verified oznacza, że LinkedIn utworzył zaproszenie.
Wyślij wiadomość
POST /linkedin/messages/send przyjmuje accountId, message oraz jedno z:
profileUrl- aby napisać do osoby. Rozmowa z nią zostanie znaleziona lub otwarta, jeśli jeszcze nie istnieje; odpowiedź zawieraexisting_conversationalbonew_conversation. Jeśli do osoby można dotrzeć tylko płatnym InMail, otrzymasznot_messageablezpaid_inmail_required. Płatny InMail nigdy nie jest zużywany po cichu.conversationId- aby kontynuować rozmowę:conversation_idz/linkedin/inbox, ID wątku2-…lub URL wątku.
sent_verified wraz z message_id i conversation_id.
Czytaj rozmowy
GET /linkedin/inbox?accountId=ACCOUNT_IDzwraca listę rozmów konta, od najnowszej.GET /linkedin/messages/conversation?accountId=ACCOUNT_ID&conversationId=CONVERSATION_IDzwraca wiadomości, od najstarszej.limitzachowuje tylko najnowsze.GET /workspaces/{workspaceId}/conversationszwraca rozmowy wszystkich kont w workspace, aGET /workspaces/{workspaceId}/inbox/unreadzwraca liczbę nieprzeczytanych.
Odbieraj nowe wiadomości przez webhook
{ accountId, workspaceId, event }. W razie błędów dostarczenie jest ponawiane, a to samo zdarzenie może dotrzeć dwa razy, dlatego deduplikuj po event.id. Aby usunąć webhook, wyślij {"url": null}. Adresy localhost i adresy wewnętrzne nie są akceptowane.
Limity
Działania wykonywane przez API wliczają się do tych samych limitów co w aplikacji.GET /accounts/{id}/limitszwraca etap (stage) konta i wszystkie limity: wartość zalecaną, Twoją własną wartość, wartość zastosowaną, ile zużyto orazresetsAt- moment, w którym w oknie będzie miejsce na jeszcze jedno działanie.PUT /accounts/{id}/limitszmieniastagelub Twoje własne wartości wcustomLimits. Wartośćnullusuwa Twoją własną wartość.DELETE /accounts/{id}/limits/customprzywraca wszystkie limity do zalecanych.GET /workspaces/{workspaceId}/accounts-usagepokazuje, ile kont może połączyć Twój workspace i ile miejsc jest zajętych.
Warte uwagi błędy
Rozgrzewka przed serią wywołań
Nieużywana sesja z czasem wygasa, a pierwsze wywołanie po tym trwa kilka sekund. WywołajPOST /accounts/{id}/warmup przed serią wywołań lub zaraz po ponownym zalogowaniu. Konto musi mieć status active.