hosting

POST /v1/media-offload/uploads

Presigned upload URLs for a batch of media files.

Όλα τα τελικά σημεία hosting

Πισtoποίηση

Στείλτε ένα κλειδί API ως διακριτικό φορέα (bearer token). Αυτό το τελικό σημείο δεν ορίζει μια συγκεκριμένη άδεια στην προδιαγραφή, οπότε δώστε στο κλειδί σας τα ελάχιστα δυνατά δικαιώματα και ελέγξτε την απόκριση αντί να κάνετε υποθέσεις.

Αυτό το τελικό σημείο δεν δέχεται αναγνωριστικό οργανισμού. Το κλειδί σας προσδιορίζει ήδη τον οργανισμό στον οποίο ανήκει, και η απάντηση περιορίζεται σε αυτόν.

Δοκιμάστε το

Ατικatastήstε ό,τι βρίskεtai μέσα σe γώniaδeς μe τis δikές sas timές, kai to placeholder klεidioύ μe éna klεidi apó ton pinaka ελέgchou sas.

curl -X POST https://api.zinndigital.com/v1/media-offload/uploads \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "keys": <string[]> }'

Συνδεθήκατε; Η κονσόλα API στον πίνακα ελέγχου σας συμπληρώνει το πραγματικό αναγνωριστικό του οργανισμού σας και το δικό σας κλειδί, και εκτελεί το αίτημα στο ζωντανό API, ώστε να μπορείτε να δείτε την πραγματική απόκριση. Ανοίξτε αυτό το τελικό σημείο στην κονσόλα API

Λεπτομέρειες

Called by the Zinn® Media Offload plugin with a bearer plugin token. Returns one presigned `PUT` URL per key; the plugin then sends the bytes **straight to storage**, so no file ever transits this API and no storage credential ever reaches WordPress. Up to 100 keys per request. Presigning is local cryptography with no vendor round trip, so a batch costs no more than a single key — which is what makes offloading an existing 20,000-file media library 200 requests rather than 20,000. Every key is joined onto the site's own prefix and validated. A key that tries to climb out of that prefix is refused with `422`, never normalised into something plausible.

Σώμα αίτησης

ΌνομαΤύpοςΥποχρεωτικόΤι είναι
keysstring[]Ναι
plugin_versionstringΌχι

Απάντηση

ΌνομαΤύpοςΥποχρεωτικόΤι είναι
uploadsobject[]Ναι

Σφάλματα που μπορεί να επιστρέψει αυτό το τελικό σημείο

401 · 422 · 429 · 503