Skip to main content
POST
Haal ondertekende PUT-URL’s op voor een upload van een referentieafbeelding waarvan je eigenaar bent. Een afbeelding van 8 MiB heeft maximaal twee onderdelen. Bewaar de ETag van elke PUT voor upload_complete.

Authenticatie en machtigingen

string
vereist
Stuur een VoiceCheap API-sleutel mee in deze header. Authorization: Bearer met dezelfde API-sleutel wordt ook ondersteund. OAuth-toegangstokens worden alleen door MCP geaccepteerd, niet door dit REST-endpoint.
Vereiste machtigingen: thumbnails:write. Een actief betaald abonnement is vereist. Machtigingen wijzigen geen teamrollen, eigendom van resources, mediategoed of abonnementslimieten.

Parameters

string
Optioneel op transportniveau: als de identificatie ontbreekt, voegt de server deze vóór de validatie toe. Geef zelf een stabiele UUID v4 op om veilig te kunnen herstellen als een antwoord verloren gaat.Formaat: “uuid”. Patroon: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$.
string
vereist
De uploadId die de upload_initialize-actie van dit domein retourneert.Formaat: “uuid”. Patroon: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$.
array
vereist
Lijst met waarden. Zie het volledige invoerschema voor de structuur van de items.Minimaal aantal items: 1. Maximaal aantal items: 2.
Het onderstaande JSON Schema behoudt de exacte veldnamen, geneste typen, standaardwaarden, grenzen en toegestane waarden die discovery beschikbaar stelt. Aanvullende regels tussen velden staan in de opmerkingen bij de bewerking.

Idempotentie

Gebruik voor elke wijziging een UUID v4 in requestId of de HTTP-header Idempotency-Key. Gebruik na een netwerkfout dezelfde identificatie en identieke argumenten opnieuw. Als je beide opgeeft, moeten ze overeenkomen. Het opnieuw versturen van een opgeslagen aanvraag herhaalt de bewerking niet en verbruikt geen extra maandelijkse aanroep. Mislukte of onderbroken aanvragen worden niet automatisch opnieuw gestart. Elke wijziging kan HTTP 202 retourneren wanneer een nieuwe poging vaststelt dat dezelfde aanvraag nog loopt, ook wanneer de eerste uitvoering normaal synchroon is. Als de uitvoering is voltooid maar resultStored false is, retourneert een nieuwe poging HTTP 200 met de opgeslagen aanvraagstatus in plaats van het oorspronkelijke resultaat. Haal de uitvoer op via de geschiedenis-, resultaat- of downloadactie van het betreffende domein.

Voorbeeldaanvragen

Vervang de voorbeeldidentificaties van resources en mediasleutels door waarden die voor je account zijn geretourneerd. Behoud dezelfde aanvraagidentificatie wanneer je dezelfde wijziging opnieuw probeert.

Antwoord

Een geslaagde eerste uitvoering retourneert HTTP 200 met het resultaat van de bewerking onder data. Een herhaalde aanvraag kan in plaats daarvan de opgeslagen aanvraagstatus retourneren. Het voorbeeld toont één ondersteund antwoord, niet alle optionele velden. Een array met tijdelijke ondertekende PUT-URL’s, één per uniek aangevraagd deelnummer. De respons bevat geen afbeeldingsbytes, ETags of groottevelden per deel.

Resultaatvelden

Deze aanvraag herstellen en controleren

Gebruik dezelfde identificatie, ook nadat de verbinding is verbroken. Als resultStored false is, haal je de uitvoer op via de bijbehorende geschiedenis-, resultaat- of downloadactie. Start nooit een tweede generatie alleen om de voortgang te controleren.
HTTP 200

Opmerkingen bij de bewerking

  • Vereist thumbnails:write; er is geen aanvullende uploadscope nodig.
  • uploadId is de UUID uit initialize. partNumbers bevat 1–2 gehele getallen, elk tussen 1 en 2, en elk deel moet bestaan voor de opgegeven fileSize van die sessie. Dubbele aangevraagde deelnummers worden teruggebracht tot één URL.
  • Verstuur de ruwe binaire bytes van elk onderdeel met PUT naar de bijbehorende geretourneerde URL. Content-Length is ondertekend en moet exact overeenkomen met min(partSize, fileSize - (partNumber - 1) × partSize). In het voorbeeld van 7 MiB bestaat onderdeel 1 uit 5,242,880 bytes en onderdeel 2 uit 2,097,152 bytes. Verstuur geen JSON, multipart/form-data of base64 naar de ondertekende URL.
  • Bewaar de ETag-antwoordheader van elke geslaagde PUT en stuur die waarden naar thumbnails_upload_complete. Behandel ondertekende URL’s als privétoegang voor tijdelijk uploaden.
  • Alleen een upload van de verbonden gebruiker kan worden ondertekend, voltooid of afgebroken. Deze aliassen accepteren alleen JPG-, PNG- en WebP-sessies van maximaal 8 MiB, zelfs als de sessie via een andere uploadfamilie is aangemaakt.
  • De uploadsessie in productie verloopt na 24 uur. Ondertekende deel-URL’s verlopen na één uur. Voltooien en afbreken verwijderen de actieve sessie; sign-parts en complete retourneren daarna Upload not found. Geen van beide responsen bevat een expiresAt-veld.
  • Gebruik een UUID v4 als requestId of de HTTP-header Idempotency-Key en hergebruik deze met identieke invoer wanneer je opnieuw probeert. De integratielaag legt elke wijziging vast en retourneert de vastgelegde status of het resultaat zonder deze opnieuw uit te voeren. Een mislukte of onderbroken aanvraag wordt niet automatisch opnieuw geprobeerd.
  • Roep sign-parts aan met een nieuwe requestId om nieuwe URL’s te verkrijgen nadat ze na één uur zijn verlopen, zolang de sessie nog actief is. Een nieuwe poging met dezelfde requestId retourneert het opgeslagen resultaat, inclusief de oude URL’s.

Verbruik

Elke geslaagde aanroep verbruikt één maandelijkse API/MCP-aanroep. Ook het mediategoed en de eigen generatielimieten van de bewerking zijn van toepassing.

Fouten