TL;DR, szybka odpowiedź
7 min czytanialifecycleState to wymagany enum w każdym wywołaniu tworzącym post w Posts API LinkedIna, a PUBLISHED jest jedyną wartością, jaką LinkedIn tam przyjmuje. DRAFT, PUBLISH_REQUESTED i PUBLISH_FAILED istnieją, ale tylko jako wartości zwracane przy odczycie posta. Dokumentacja przeczy sobie w dwóch miejscach: jeden akapit wymienia stan PROCESSING, którego nie ma w enumie, a inny podaje nieistniejącą wartość PUBLISHED_FAILED. Każde wywołanie wymaga też nagłówka Linkedin-Version w formacie YYYYMM oraz X-Restli-Protocol-Version 2.0.0.
Do czego służy lifecycleState w Posts API LinkedIna?
Pole lifecycleState na LinkedInie określa stan posta, a przy tworzeniu przyjmuje tylko jedną wartość: PUBLISHED. Schemat Post API w Microsoft Learn ujmuje to w jednym zdaniu: "PUBLISHED is the only accepted field during creation." Schemat oznacza pole jako Enum string i required, więc nie można go też pominąć.
Każde przykładowe żądanie na stronie Posts API zawiera ten sam wiersz:
{
"author": "urn:li:organization:5515715",
"commentary": "Sample text Post",
"visibility": "PUBLIC",
"distribution": {
"feedDistribution": "MAIN_FEED",
"targetEntities": [],
"thirdPartyDistributionChannels": []
},
"lifecycleState": "PUBLISHED",
"isReshareDisabledByAuthor": false
}Udane utworzenie zwraca 201, a identyfikator nowego posta LinkedIn umieszcza w nagłówku odpowiedzi x-restli-id jako urn:li:share:{id} lub urn:li:ugcPost:{id}.
Jakie wartości może zwrócić lifecycleState?
LinkedIn dokumentuje cztery wartości, a trzy z nich będziesz tylko odczytywać, nigdy wysyłać.
| Wartość | Definicja LinkedIna | Przyjmowana przy tworzeniu |
|---|---|---|
PUBLISHED | "Represents content that's accessible to all entities." | Tak |
DRAFT | "Represents content that's accessible only to the author and is not yet published." | Nie |
PUBLISH_REQUESTED | "Represents content that has been submitted for publishing but is not yet ready for rendering." | Nie |
PUBLISH_FAILED | "Represents content that has been submitted for publishing but was not processed." | Nie |
Schemat poprzedza trzy ostatnie prostym zastrzeżeniem: "The following values can be returned in responses." Opisują one posty, a nie są poleceniami dla LinkedIna.
To PUBLISH_REQUESTED wprowadza integracje w błąd. LinkedIn podaje, że treść w tym stanie "will be published asynchronously once the processing has successfully completed." Kod 201 przy tworzeniu mówi, że LinkedIn przyjął żądanie. Stan mówi, czy post jest już widoczny, a to dwie różne informacje.
PUBLISH_FAILED ma konkretną zasadę naprawy: "An edit is required in order to re-attempt publishing." Ponowne wysłanie tego samego żądania utworzy drugi post, a nie ponowi pierwszy.

Czy można utworzyć szkic na LinkedInie przez API?
Nie. Posts API nie dokumentuje żadnego sposobu utworzenia posta w stanie DRAFT, a zasada tworzenia nie zostawia na to miejsca. DRAFT pojawia się w odpowiedziach dla treści dostępnych tylko dla autora, ale LinkedIn nie wyjaśnia, jak takie treści powstają ani jak programista mógłby je utworzyć.
LinkedIn nie dokumentuje też dokładnej odpowiedzi na wysłanie "lifecycleState": "DRAFT" przy tworzeniu. Najbliższy odpowiednik w tabeli błędów to ten wiersz:
| Status | Kod | Komunikat | Zalecenie LinkedIna |
|---|---|---|---|
400 | INVALID_VALUE_FOR_FIELD | "{field} cannot be set to {value}." | "Verify that enum values for fields such as visibility, feedDistribution, and lifecycleState are valid." |
400 | MISSING_FIELD | "A required field is missing." | "Ensure all required fields such as author, visibility, distribution, and lifecycleState are present." |
Narzędzie do planowania, które chce wstrzymać post do określonej godziny, musi więc przechowywać go po swojej stronie i wysłać żądanie utworzenia dokładnie w tym momencie. API LinkedIna nie oferuje stanu oczekiwania, na którym można by się oprzeć. Dlatego właśnie zaplanowane posty na LinkedInie przestają działać, gdy narzędzie, które je przechowuje, straci token: po stronie LinkedIna nic nie czeka na publikację.
Gdzie dokumentacja LinkedIna sama sobie przeczy?
Trzy miejsca na tych samych dwóch stronach nie zgadzają się z enumem.
Pierwsze to uwaga o viewContext na stronie Posts API. Mówi ona, że widok AUTHOR "can be used to retrieve the latest version of a post, which has not yet been published; it can be in a number of possible states such as: PUBLISHED, DRAFT or PROCESSING." PROCESSING nie jest wartością Posts API. Należy do starszego API ugcPosts, a w enumie Posts API jego miejsce zajmuje PUBLISH_REQUESTED.
Drugie znajduje się w tabeli lifecycleStateInfo na stronie schematu. Pole reviewStatus jest "Applicable for lifecycle state values of PUBLISH_REQUESTED and PUBLISHED_FAILED only." Wartość PUBLISHED_FAILED nie istnieje. Enum zapisuje ją jako PUBLISH_FAILED. Jeśli generujesz typy z dokumentacji, użyj pisowni z enuma.
Trzecie to sekcja o aktualizacji. LinkedIn wymienia lifecycleState wśród jedynych pól, które można zmienić przez PARTIAL_UPDATE, obok commentary, contentCallToActionLabel, contentLandingPage i adContext. Strona nie podaje przykładu takiej zmiany ani nie mówi, które przejścia są dozwolone. Przykładowa aktualizacja dotyczy tylko commentary i contentCallToActionLabel.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Jak stany Posts API mają się do starych stanów ugcPosts?
Posts API zastąpiło ugcPosts, a migracja LinkedIna skróciła enum z siedmiu wartości do czterech. Schemat ugcPosts w Microsoft Learn nadal wymienia wszystkie siedem.
| Wartość ugcPosts | Odpowiednik w Posts API |
|---|---|
PUBLISHED | PUBLISHED |
DRAFT | DRAFT |
PROCESSING | PUBLISH_REQUESTED |
PROCESSING_FAILED | PUBLISH_FAILED |
DELETED | Brak. DELETE zwraca 204 |
PUBLISHED_EDITED | Brak. Zobacz isEditedByAuthor |
ARCHIVED | Brak udokumentowanego odpowiednika |
Opisy pokrywają się niemal słowo w słowo. ugcPosts definiuje PROCESSING jako treść "submitted for publish but is not yet ready for rendering", co jest definicją PUBLISH_REQUESTED z Posts API z jednym zmienionym słowem.
Dwie usunięte wartości przeniosły się gdzie indziej. Usuwanie to teraz żądanie DELETE z nagłówkiem X-RestLi-Method: DELETE, a LinkedIn podaje, że "Post deletions are idempotent", zwracając 204 nawet dla posta, którego już nie ma. Edycje są widoczne jako wartość logiczna lifecycleStateInfo.isEditedByAuthor, która według LinkedIna jest "Applicable for UserGeneratedContentLifecycleState value of PUBLISHED only."
Czym jest lifecycleStateInfo?
To obiekt towarzyszący, który objaśnia stan, a LinkedIn zwraca go przy odczycie. Ma trzy pola:
contentStatus: "Status for post content", z wartościamiPENDING,PROCESSINGiFAILED. "If processing completes UGC transitions to PUBLISHED and the contentStatus is null."reviewStatus: "Review status of the post", z tymi samymi trzema wartościami, null po osiągnięciu przez post stanuPUBLISHED.isEditedByAuthor: domyślniefalse.
To tutaj PROCESSING legalnie występuje w Posts API. Jest wartością contentStatus i reviewStatus, a nie lifecycleState. Kod rozgałęziający się według lifecycleState nigdy nie powinien się go spodziewać.

Jakich nagłówków wymaga żądanie utworzenia?
Czterech, a dwa z nich LinkedIn podaje na początku strony Posts API: "All APIs require the request header Linkedin-Version: {Version in YYYYMM format}" oraz "All APIs require the request header X-Restli-Protocol-Version: 2.0.0".
curl -X POST 'https://api.linkedin.com/rest/posts' \
-H 'Authorization: Bearer {INSERT_TOKEN}' \
-H 'X-Restli-Protocol-Version: 2.0.0' \
-H 'Linkedin-Version: 202608' \
-H 'Content-Type: application/json' \
--data '{ ...body with "lifecycleState": "PUBLISHED"... }'Nagłówek wersji najczęściej psuje integracje, bo musi mieć sześć cyfr, a wersja musi być nadal aktywna. Zasady dotyczące tej wartości opisuje tekst o tym, dlaczego nagłówek LinkedIn-Version musi mieć format YYYYMM. Strona Posts API zawiera obecnie ostrzeżenie, że Marketing Version 202510 "will be sunset on October 15, 2026."
Token również potrzebuje uprawnienia do publikowania. w_member_social publikuje w imieniu uwierzytelnionego członka. w_organization_social publikuje w imieniu strony firmowej i jest "Restricted to organizations where the authenticated member has one of the following company page roles: ADMINISTRATOR, DIRECT_SPONSORED_CONTENT_POSTER, CONTENT_ADMIN."
Jak odczytać bieżący stan posta?
Wyślij GET na https://api.linkedin.com/rest/posts/{encoded ugcPostUrn|shareUrn} i dodaj viewContext=AUTHOR, jeśli chcesz zobaczyć stany nieopublikowane. LinkedIn wyjaśnia, że domyślny READER "specifies the version of the post that has been published and is viewable to a general audience." Post wciąż w stanie PUBLISH_REQUESTED to dokładnie to, czego widok READER ci nie pokaże.
Posty z multimediami przechodzą najpierw osobny etap przesyłania. LinkedIn podaje, że post z obrazem "requires uploading an image asset to obtain an Image URN (urn:li:image:{id}) for use in the post", a żądanie utworzenia odwołuje się potem do tego URN. Tę część procesu opisuje tekst o URN obrazu w initializeUpload na LinkedInie.
Najczęściej zadawane pytania
Czy lifecycleState jest wymagane w Posts API LinkedIna?
Tak. Schemat oznacza je jako required, a opis błędu MISSING_FIELD wymienia je wśród pól, które muszą być obecne, obok author, visibility i distribution.
Czy mogę zaplanować post na LinkedInie, tworząc go jako DRAFT?
Nie. PUBLISHED to jedyna wartość, jaką LinkedIn przyjmuje przy tworzeniu, więc zaplanowany post musi czekać w twoim systemie do chwili wysłania żądania utworzenia.
Co oznacza PUBLISH_REQUESTED?
LinkedIn przyjął post, ale nie zakończył jego przetwarzania. LinkedIn podaje, że treść "will be published asynchronously once the processing has successfully completed."
Jak ponowić post, który utknął w PUBLISH_FAILED?
Wyedytuj go. Definicja LinkedIna mówi: "An edit is required in order to re-attempt publishing." Ponowne utworzenie posta da nowy post.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Dlaczego dokumentacja LinkedIna wspomina o PROCESSING i PUBLISHED_FAILED?
Oba to pomyłki w dokumentacji. PROCESSING jest wartością ugcPosts i contentStatus, a PUBLISHED_FAILED to błędna pisownia PUBLISH_FAILED. Żadna z nich nie występuje w enumie lifecycleState w Posts API.
Czy usunięty post wraca ze stanem DELETED?
Nie. Posts API nie ma wartości DELETED. Żądanie DELETE zwraca 204, a LinkedIn podaje, że ponowne usunięcia tego samego posta również zwracają 204.
Jaki błąd zwróci LinkedIn, gdy wyślę DRAFT jako lifecycleState?
LinkedIn nie dokumentuje dokładnej odpowiedzi w tym przypadku. Najbliższy udokumentowany błąd to 400 INVALID_VALUE_FOR_FIELD z komunikatem "{field} cannot be set to {value}." LinkedIn zaleca sprawdzenie poprawności wartości enumów takich jak lifecycleState, a przy tworzeniu jedyną poprawną jest PUBLISHED.
Jak zobaczyć post na LinkedInie, który nie jest jeszcze opublikowany?
Wyślij GET na https://api.linkedin.com/rest/posts/{encoded ugcPostUrn|shareUrn} z viewContext=AUTHOR. Domyślny widok READER pokazuje tylko wersję opublikowaną i dostępną dla ogółu odbiorców. Post w stanie PUBLISH_REQUESTED się w nim nie pojawi.
Jakich nagłówków wymaga żądanie utworzenia w Posts API LinkedIna?
Wymagane są Linkedin-Version w formacie YYYYMM oraz X-Restli-Protocol-Version: 2.0.0. Przykładowe żądanie wysyła też Authorization z tokenem Bearer i Content-Type: application/json. Wersja musi być nadal aktywna, bo LinkedIn ostrzega, że Marketing Version 202510 "will be sunset on October 15, 2026."
Jakiego uprawnienia potrzebuję, by publikować na stronie firmowej na LinkedInie?
Potrzebujesz w_organization_social. LinkedIn podaje, że jest ono "Restricted to organizations where the authenticated member has one of the following company page roles: ADMINISTRATOR, DIRECT_SPONSORED_CONTENT_POSTER, CONTENT_ADMIN." Do publikowania jako uwierzytelniony członek służy w_member_social.
Wykorzystaj to w praktyce z AdaptlyPost
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Więcej naszych treści w Google
Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.
Jeszcze chwila...
AdaptlyPost
Planowanie treści na wszystkich platformach
Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Powiązane hasła ze słownika


Jak initializeUpload na LinkedInie zamienia plik w URN obrazu
Akcja initializeUpload na LinkedInie zwraca URN obrazu i adres przesyłania. Oto żądanie PUT, post odwołujący się do URN i błędy na każdym etapie.


Każde wywołanie /rest/ wymaga nagłówka LinkedIn-Version w formacie YYYYMM
Nagłówek LinkedIn-Version przyjmuje wartość YYYYMM, np. 202608. Bez niego LinkedIn zwraca 400 VERSION_MISSING, a wycofana wersja kończy się kodem 426.


Limity długości wideo na LinkedInie dla profili, stron i API
Wideo na LinkedInie może trwać do 15 minut w aplikacji i 30 minut w Videos API. Minimalne długości, rozmiary plików i zasady reklam według dokumentacji LinkedIna.
Powiązane artykuły


Gdzie naprawdę zapisano limit znaków tekstu alternatywnego na LinkedInie
Limit tekstu alternatywnego na LinkedInie to 4 086 znaków w polu altText w API, a dla pola tekstu alternatywnego w aplikacji LinkedIn nie publikuje żadnego limitu.


Ile zdjęć zmieści post z wieloma obrazami na LinkedInie
Post z wieloma obrazami na LinkedInie mieści do 20 zdjęć po 5 MB, co najmniej 552 x 276. Jak LinkedIn je układa, czym różni się karuzela PDF i jak działa API.


Zasady rozmiaru wideo na LinkedInie dla postów, reklam i API
Oficjalny zakres rozmiaru wideo na LinkedInie: od 256x144 do 4096x2304 pikseli, od 1:2.4 do 2.4:1 i od 75 KB do 5 GB w postach. Reklamy mają ostrzejsze wymagania.

