Przesyłanie multimediów
Prześlij obrazy i filmy do AdaptlyPost za pomocą wstępnie podpisanych adresów URL, a następnie dołącz zwrócone identyfikatory multimediów do dowolnego zaplanowanego posta.
https://post.adaptlypost.com/post/api/v1/upload-urlsPobiera podpisane adresy URL do przesłania jednego lub wielu plików. W jednym wywołaniu można pobrać do 20 adresów.
Parametry treści żądania
| Parametr | Typ | Opis |
|---|---|---|
filesWYMAGANE | FileUploadRequest[] | Tablica metadanych plików (1-20 elementów) |
files[].fileNameWYMAGANE | string | Oryginalna nazwa pliku |
files[].mimeTypeWYMAGANE | string | image/jpeg, image/png, image/webp, image/gif, video/mp4, video/quicktime lub typ dokumentu dla postów DOCUMENT na LinkedIn (PDF, PPT, PPTX, DOC, DOCX; zob. Obsługiwane formaty). W fileName należy zachować rozszerzenie pliku. Obrazy GIF można publikować na Facebooku, X, Bluesky, Mastodon, LinkedIn i Tumblr; pozostałe platformy odrzucają je przy tworzeniu posta. |
Krok 1: pobranie adresów URL
Należy wysłać żądanie POST z metadanymi plików, aby otrzymać podpisane adresy URL. Przykładowe żądanie i odpowiedź znajdują się w panelu kodu.
Krok 2: przesłanie pliku
Plik należy przesłać żądaniem PUT na adres uploadUrl z odpowiedzi. Przykład znajduje się w panelu kodu.
Krok 3: użycie w poście
Przy tworzeniu posta należy przekazać publicUrl z odpowiedzi jako element mediaUrls. Jednego publicUrl można użyć w dowolnej liczbie postów; plik jest przechowywany do publikacji ostatniego posta, który się do niego odwołuje. Należy używać przesłanego publicUrl, a nie wartości mediaUrls odczytanej z opublikowanego posta, ponieważ mogą to być wygasające linki platformy.
Wygaśnięcie adresu URL
Podpisane adresy URL wygasają po 1 godzinie. Plik należy przesłać przed upływem expiresAt lub pobrać nowy adres.Obsługiwane formaty
| Typ | Typy MIME |
|---|---|
| Obrazy | image/jpeg, image/png, image/webp, image/gif |
| Filmy | video/mp4, video/quicktime |
| Dokumenty (LinkedIn) | application/pdf, application/vnd.ms-powerpoint, application/vnd.openxmlformats-officedocument.presentationml.presentation, application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document |
curl --request POST \
--url https://post.adaptlypost.com/post/api/v1/upload-urls \
--header 'Authorization: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"files": [
{
"fileName": "product-photo.jpg",
"mimeType": "image/jpeg"
}
]
}'curl --request PUT \
--url "https://storage.adaptlypost.com/presigned/abc123..." \
--header 'Content-Type: image/jpeg' \
--data-binary @product-photo.jpg{
"urls": [
{
"fileName": "product-photo.jpg",
"uploadUrl": "https://storage.adaptlypost.com/presigned/abc123...",
"publicUrl": "https://cdn.adaptlypost.com/uploads/product-photo.jpg",
"key": "uploads/usr_001/product-photo.jpg",
"expiresAt": "2026-03-14T13:00:00Z"
}
]
}