Bestand uploaden via documentwebhoos

Het uploaden van een bestand naar een leverancier van documentopslag is een proces in twee stappen waarvoor twee afzonderlijke API-eindpunten nodig zijn. Adobe Workfront begint het uploadproces door /uploadInit te roepen. Dit eindpunt keert een document identiteitskaart terug die dan tot /upload wordt overgegaan wanneer het uploaden van de documentbytes. Afhankelijk van het onderliggende documentopslagsysteem kan het nodig zijn om een document met een lengte van nul te maken en de inhoud van het document later bij te werken.

De document-id en de document-versie-id zijn toegevoegd aan versie 1.1 van deze specificatie en kunnen worden gebruikt om extra informatie van Workfront op te halen.

Voorbeeld: als het systeem van het documentbeheer extra informatie over het document wil, kon de code van de webshimplementatie documentidentiteitskaart gebruiken om die informatie terug te winnen gebruikend Workfront RESTful API. Als goede praktijk, kon deze informatie uit de gebieden van douanegegevens op het document komen en het bevat taak, kwestie, of project.

POST-methode

URL

POST /uploadInit

Zoekparameters

Naam
Beschrijving
parentId
De bovenliggende map-id, waarnaar wordt verwezen door de websiteprovider.
filename
De naam van het document
documentId
De Workfront-document-id (toegevoegd in versie 1.1)
documentVersionId
De Workfront-document versie-id (toegevoegd in versie 1.1)

Antwoord

De meta-gegevens voor het dossier, zoals die door het /metadata eindpunt wordt bepaald. Hieronder valt de document-id die door de provider wordt gebruikt.

Voorbeeld:

https://www.acme.com/api/uploadInit?parentId=12345&filename=new-file.png&documentId=511ea6e000023edb38d2effb2f4e6e3b&documentVersionId=511ea6e000023edb38d2e ffb2f4e6e3b

PUT-methode

Hiermee uploadt u de bytes van een document naar de websiteprovider.

URL

PUT /upload

Zoekparameters

Naam
Beschrijving
id
De document-id, die zojuist is gemaakt.

Lichaam van het Verzoek

De onbewerkte inhoudbytes voor het document.

Reactie

{
result: "success"
}

of

{
result: "fail"
}

Voorbeeld

https://www.acme.com/api/upload?id=1234 [document bytes included in update stream]

reactie

{
result:"success"
}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43