Sprawdź post przed utworzeniem
Przetestuj post: wyślij tę samą treść co do Utwórz post i poznaj każdy problem, który by go zatrzymał, dla każdego konta, niczego nie tworząc.
https://post.adaptlypost.com/post/api/v1/social-posts/validateWykonuje wszystkie kontrole Utwórz post, niczego nie tworząc. Przyjmuje tę samą treść i zwraca, co stałoby się z postem oraz wszystkie problemy, które by go zatrzymały.
Do uruchomienia kontroli wystarczy posts.draft, niezależnie od tego, co stałoby się z postem. requiredPermissions w odpowiedzi podaje uprawnienia potrzebne do utworzenia posta, a klucz bez któregoś z nich otrzymuje problem PERMISSION_DENIED.
Treść żądania
Ta sama treść co w Utwórz post, pole w pole. Nic nie jest tworzone, przesyłane ani zapisywane. Poprawna treść zawsze zwraca 200 z raportem, nawet jeśli post zostałby odrzucony. Tylko nieprawidłowo sformatowana treść zwraca 400.
Problemy wykrywane przed publikacją
Oprócz wszystkich kontroli Utwórz post raport obejmuje problemy, które inaczej wyszłyby na jaw dopiero przy publikacji: limity twórców TikToka, dzienny limit przesyłania YouTube dla kanałów bez zapasowego przesyłania, wygasły dostęp do Instagrama i Threads, serwery Mastodon przyjmujące mniej załączników, nieistniejące tablice Pinterest oraz kredyty X w planach z ofertą dożywotnią.Pola odpowiedzi
| Pole | Opis |
|---|---|
valid | false, gdy dowolny problem ma severity ERROR, na najwyższym poziomie lub przy koncie |
outcome | Skutek utworzenia posta: PUBLISH_NOW, SCHEDULED lub DRAFT |
scheduledAt | Termin publikacji posta (ISO 8601). Ustawiane tylko, gdy outcome to SCHEDULED |
requiredPermissions | Uprawnienia potrzebne do utworzenia posta, np. posts.schedule |
issues | Problemy niezwiązane z jednym kontem, np. brak uprawnienia |
accounts | Jeden wpis na wybrane konto, z polami opisanymi poniżej |
notChecked | Kwestie, o których może zdecydować tylko platforma w chwili publikacji, jako { code, message }. code to PLATFORM_PROCESSING, DUPLICATE_CONTENT, PLATFORM_RATE_LIMITS, LIVE_ACCOUNT_ACCESS lub VIDEO_DURATION |
Pola konta
| Pole | Opis |
|---|---|
platform, connectionId, accountName | Platforma konta, jego identyfikator połączenia i nazwa, jeśli jest znana |
status | READY, WARNING (publikacja z zastrzeżeniem) lub BLOCKED (brak publikacji) |
issues | Problemy wykryte dla tego konta |
Pola problemu
| Pole | Opis |
|---|---|
code | Stały powód, np. TEXT_TOO_LONG, ACCOUNT_DISCONNECTED, TIKTOK_POSTING_BLOCKED lub YOUTUBE_UPLOAD_QUOTA_EXHAUSTED. Mogą pojawiać się nowe kody, dlatego dla nieznanego kodu należy wyświetlić message |
severity | ERROR zatrzymuje publikację posta lub danego konta. WARNING ją dopuszcza |
message | Czytelne zdanie, które można wyświetlić bez zmian |
platform, connectionId | Platforma i konto, których dotyczy problem, jeśli dotyczy konkretnego |
valid: true nie jest gwarancją
Platforma nadal może odrzucić multimedia podczas przetwarzania, odmówić publikacji duplikatu lub osiągnąć limit zapytań w chwili publikacji. Te przypadki wymienia notChecked. Kontrola przed Utwórz post nigdy nie jest konieczna, ponieważ ten endpoint wykonuje te same sprawdzenia ponownie.curl --request POST \
--url https://post.adaptlypost.com/post/api/v1/social-posts/validate \
--header 'Authorization: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"platforms": ["TWITTER", "TIKTOK"],
"contentType": "VIDEO",
"text": "Behind the scenes of our launch",
"mediaUrls": ["https://cdn.adaptlypost.com/uploads/launch.mp4"],
"scheduledAt": "2026-11-03T15:00:00Z",
"timezone": "America/New_York",
"twitterConnectionIds": ["conn_abc123"],
"tiktokConnectionIds": ["conn_tt789"]
}'{
"valid": false,
"outcome": "SCHEDULED",
"scheduledAt": "2026-11-03T15:00:00.000Z",
"requiredPermissions": ["posts.schedule"],
"issues": [],
"accounts": [
{
"platform": "TWITTER",
"connectionId": "conn_abc123",
"accountName": "@yourhandle",
"status": "READY",
"issues": []
},
{
"platform": "TIKTOK",
"connectionId": "conn_tt789",
"accountName": "yourbrand",
"status": "BLOCKED",
"issues": [
{
"code": "TIKTOK_VIDEO_TOO_LONG",
"severity": "ERROR",
"message": "Video duration (185s) exceeds your TikTok account limit of 180 seconds",
"platform": "TIKTOK",
"connectionId": "conn_tt789"
}
]
}
],
"notChecked": [
{
"code": "PLATFORM_PROCESSING",
"message": "The platform processes media after upload and can still reject it then"
}
]
}