REST APIPOST

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.

Przesyłanie multimediów ma dwa etapy: najpierw pobranie podpisanego adresu URL, a potem przesłanie pliku bezpośrednio na ten adres. Zapewnia to bezpieczeństwo plików i umożliwia przesyłanie dużych plików.
POSThttps://post.adaptlypost.com/post/api/v1/upload-urls

Pobiera podpisane adresy URL do przesłania jednego lub wielu plików. W jednym wywołaniu można pobrać do 20 adresów.

Klucz API (token Bearer)
Uprawnienie:media.uploadRole i uprawnienia

Parametry treści żądania

ParametrTypOpis
filesWYMAGANEFileUploadRequest[]Tablica metadanych plików (1-20 elementów)
files[].fileNameWYMAGANEstringOryginalna nazwa pliku
files[].mimeTypeWYMAGANEstringimage/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

TypTypy MIME
Obrazyimage/jpeg, image/png, image/webp, image/gif
Filmyvideo/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
Pobranie adresów URL do przesyłania
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"
      }
    ]
  }'
Przesłanie pliku
curl --request PUT \
  --url "https://storage.adaptlypost.com/presigned/abc123..." \
  --header 'Content-Type: image/jpeg' \
  --data-binary @product-photo.jpg
201
{
  "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"
    }
  ]
}