API profili użytkowników mediów społecznościowych
Pobierz wszystkie konta społecznościowe połączone z obszarem roboczym AdaptlyPost wraz z platformą, identyfikatorem i statusem połączenia.
https://post.adaptlypost.com/post/api/v1/social-accountsZwraca listę wszystkich kont społecznościowych połączonych z obszarem roboczym. Zwrócone identyfikatory połączeń służą do tworzenia postów.
Użycie
Wartości id z tej odpowiedzi należy podawać jako identyfikatory połączeń przy tworzeniu postów. Każde konto zawiera displayName, username i avatarUrl. Konta stron na Facebooku mają także pageId (ID strony na Facebooku), ponieważ strony nie mają nazwy użytkownika. Dla Facebooka pageIds przyjmuje id konta lub pageId, a odpowiedzi dotyczące postów zawsze zwracają pageId. Każde konto ma też status: active albo unauthorized, gdy platforma odrzuciła jego token. Posty na konto unauthorized są odrzucane błędem 400 do czasu ponownego połączenia w panelu, a unauthorizedReason zawiera komunikat platformy.
Lokalizacja Google Business Profile ma tytuł lokalizacji jako displayName i pusty username. Konta Instagram mają pole supportsInstagramAudio, które ma wartość true, gdy konto połączono przez Facebooka, co jest wymagane do dodania dźwięku do Reela. Kanał lub grupa na Telegramie ma tytuł czatu jako displayName, publiczną @nazwę bez @ jako username (pustą, jeśli czat jej nie ma) i pusty avatarUrl. Czat, z którego usunięto bota AdaptlyPost, ma status unauthorized. Witryna WordPress, której dane logowania przestały działać (zwraca 401 lub 403), ma status unauthorized do czasu ponownego połączenia.
Ponowne sprawdzenie konta
https://post.adaptlypost.com/post/api/v1/social-accounts/:id/checkStrony są automatycznie sprawdzane na Facebooku dwa razy dziennie. Aby sprawdzić stronę od razu, należy wywołać ten endpoint z id konta lub pageId. Odrzucony token oznacza stronę jako unauthorized i wywołuje account.unauthorized; działający token usuwa wcześniejsze oznaczenie. Odpowiedź zawiera aktualny status.
Uprawnienie accounts.manage ma tylko klucz Administratora. Łączenie, odłączanie i ponowne sprawdzanie kont, wybór stron i tablic, preferencje Pinteresta i linki do połączenia są dostępne wyłącznie dla Administratora.
Usunięcie konta
https://post.adaptlypost.com/post/api/v1/social-accounts/:idOdłącza konto od obszaru roboczego, tak samo jak odłączenie na stronie Łączniki. Zapisane tokeny są usuwane, konto znika ze wszystkich oczekujących i cyklicznych postów i przestaje wliczać się do planu. Należy podać id konta lub pageId. Działa niezależnie od statusu konta, więc konto unauthorized można usunąć bez ponownego łączenia. Odpowiedź zwraca id, platform, displayName oraz, dla Facebooka, pageId usuniętego konta wraz z removed: true. Id spoza obszaru roboczego zwraca 404.
Uprawnienie accounts.manage ma tylko klucz Administratora. Łączenie, odłączanie i ponowne sprawdzanie kont, wybór stron i tablic, preferencje Pinteresta i linki do połączenia są dostępne wyłącznie dla Administratora.
Wyszukiwanie dźwięków na Instagramie
https://post.adaptlypost.com/post/api/v1/social-accounts/:id/instagram-audioWyszukuje muzykę i oryginalne dźwięki z Instagrama do dodania do Reela. Bez searchQuery zwraca popularne pozycje. Wybrane audioId należy przekazać w instagramConfigs[].audio. Działa tylko dla kont Instagram z supportsInstagramAudio: true.
Parametry zapytania
| Parametr | Typ | Opis |
|---|---|---|
audioTypeWYMAGANE | string | music lub original_sound |
searchQuery | string | Filtr słów kluczowych, do 100 znaków. Pominięcie zwraca popularne dźwięki |
Pola dźwięku
| Pole | Opis |
|---|---|
audioId | Należy przekazać jako instagramConfigs[].audio.audioId |
audioType | music lub original_sound |
title | Tytuł utworu |
displayArtist, igUsername | displayArtist dla muzyki, igUsername (nazwa twórcy na Instagramie) dla oryginalnego dźwięku |
durationMs | Długość w milisekundach |
coverArtworkUrl, profilePictureUrl | Okładka dla muzyki, zdjęcie profilowe twórcy dla oryginalnego dźwięku |
previewUrl | Tymczasowy link do pliku audio do odsłuchu. Wygasa po około 1,5 dnia |
instagramUrl | Strona dźwięku na Instagramie |
isAdsEligible | Czy Instagram oznacza dźwięk jako dostępny do użycia w reklamach |
Lista tablic Pinterest
https://post.adaptlypost.com/post/api/v1/social-accounts/:id/pinterest-boardsZwraca w boards wszystkie tablice, na które konto Pinterest może przypinać, także tajne. Należy przekazać id tablicy jako pinterestConfigs[].boardId lub jej nazwę jako pinterestConfigs[].boardName. Tablica należy do jednego konta Pinterest, dlatego listę trzeba pobrać dla każdego konta, na które trafia post.
Pola tablicy
| Pole | Opis |
|---|---|
id | Należy przekazać jako pinterestConfigs[].boardId |
name | Nazwa tablicy. Można ją przekazać jako pinterestConfigs[].boardName |
description | Opis tablicy. Opcjonalne |
privacy | PUBLIC, PROTECTED lub SECRET, zgodnie z danymi Pinteresta. Opcjonalne |
pinCount | Liczba pinów na tablicy. Opcjonalne |
Lista kategorii WordPress
https://post.adaptlypost.com/post/api/v1/social-accounts/:id/wordpress-categoriesZwraca w categories kategorie witryny WordPress posortowane według nazwy. Id kategorii należy przekazać w wordpressConfigs[].categoryIds. Endpoint pozwala zamienić znane nazwy kategorii na id. Kategoria należy do jednej witryny, dlatego listę trzeba pobrać dla każdej witryny, na której publikowany jest post.
Pola kategorii
| Pole | Opis |
|---|---|
id | Należy przekazać w wordpressConfigs[].categoryIds |
name | Nazwa kategorii |
parentId | Id kategorii nadrzędnej lub null dla kategorii najwyższego poziomu |
Wyszukiwanie strony firmowej na LinkedIn
https://post.adaptlypost.com/post/api/v1/linkedin-organizations/lookupZwraca w organization stronę firmową na LinkedIn wraz ze wzmianką gotową do wklejenia w treść posta na LinkedIn. Należy podać adres URL strony, jej nazwę własną (część po linkedin.com/company/) lub nazwę własną z @.
Parametry zapytania
| Parametr | Typ | Opis |
|---|---|---|
queryWYMAGANE | string | Adres URL strony firmowej, np. https://www.linkedin.com/company/acme/, jej nazwa własna (acme) lub @acme. Od 1 do 300 znaków |
Pola organizacji
| Pole | Opis |
|---|---|
id | ID organizacji na LinkedIn |
name | Nazwa strony wyświetlana na LinkedIn |
vanityName | Nazwa własna z adresu URL strony. Może mieć wartość null |
urn | URN organizacji, urn:li:organization:<id> |
mention | Należy wkleić do treści posta na LinkedIn bez zmian |
LinkedIn dopasowuje wyłącznie dokładną nazwę własną, więc nie jest to wyszukiwanie: acm lub nazwa ze spacjami niczego nie znajdą. Gdy post trafia też na inne platformy, wzmiankę należy umieścić w platformTexts dla LINKEDIN, ponieważ inne platformy pokażą tę składnię jako zwykły tekst.
curl --request GET \
--url https://post.adaptlypost.com/post/api/v1/social-accounts \
--header 'Authorization: Bearer <api-key>'curl --request POST \
--url https://post.adaptlypost.com/post/api/v1/social-accounts/<account-id>/check \
--header 'Authorization: Bearer <api-key>'curl --request DELETE \
--url https://post.adaptlypost.com/post/api/v1/social-accounts/<account-id> \
--header 'Authorization: Bearer <api-key>'curl --request GET \
--url 'https://post.adaptlypost.com/post/api/v1/social-accounts/<account-id>/instagram-audio?audioType=music&searchQuery=summer' \
--header 'Authorization: Bearer <api-key>'curl --request GET \
--url https://post.adaptlypost.com/post/api/v1/social-accounts/<account-id>/pinterest-boards \
--header 'Authorization: Bearer <api-key>'curl --request GET \
--url https://post.adaptlypost.com/post/api/v1/social-accounts/<account-id>/wordpress-categories \
--header 'Authorization: Bearer <api-key>'curl --request GET \
--url 'https://post.adaptlypost.com/post/api/v1/linkedin-organizations/lookup?query=devtestco' \
--header 'Authorization: Bearer <api-key>'{
"accounts": [
{
"id": "conn_abc123",
"platform": "TWITTER",
"displayName": "Your Handle",
"username": "@yourhandle",
"avatarUrl": "https://pbs.twimg.com/profile_images/...",
"status": "active"
},
{
"id": "conn_def456",
"platform": "LINKEDIN",
"displayName": "Your Company",
"username": "",
"avatarUrl": "https://media.licdn.com/...",
"status": "active"
},
{
"id": "conn_ghi789",
"platform": "INSTAGRAM",
"displayName": "Your Profile",
"username": "yourprofile",
"avatarUrl": "https://scontent.cdninstagram.com/...",
"status": "active",
"supportsInstagramAudio": true
},
{
"id": "conn_pqr678",
"platform": "TELEGRAM",
"displayName": "Your Channel",
"username": "yourchannel",
"avatarUrl": "",
"status": "active"
},
{
"id": "conn_mno345",
"platform": "GOOGLE_BUSINESS",
"displayName": "Your Cafe, Main Street",
"username": "",
"avatarUrl": "",
"status": "active"
},
{
"id": "conn_jkl012",
"platform": "FACEBOOK",
"displayName": "Your Page",
"username": "",
"avatarUrl": "",
"status": "unauthorized",
"unauthorizedReason": "This Page access token belongs to a Page that is not accessible.",
"pageId": "123456789012345"
}
]
}