Filöverföring via webbhotell för dokument
Att överföra en fil till en dokumentlagringsleverantör är en tvåstegsprocess som kräver två separata API-slutpunkter. Adobe Workfront påbörjar överföringen genom att anropa /uploadInit. Den här slutpunkten returnerar ett dokument-ID som sedan skickas till /upload när dokumentbyte överförs. Beroende på det underliggande dokumentlagringssystemet kan det vara nödvändigt att skapa ett dokument med längden noll och sedan uppdatera innehållet i dokumentet senare.
Dokument-ID och dokumentversions-ID kan läggas till i version 1.1 av den här specifikationen för att hämta extra information från Workfront.
Exempel: Om dokumenthanteringssystemet vill ha extra information om dokumentet, kan webhochimplementeringskoden använda dokument-ID:t för att hämta informationen med Workfront RESTful API. Som en god vana kan den här informationen komma från anpassade datafält i dokumentet och innehålla uppgifter, problem eller projekt.
POST-metod
URL
POST /uploadInit
Frågeparametrar
Svar
Metadata för filen, enligt definitionen i /metadata-slutpunkten. Detta inkluderar det dokument-ID som används av providern.
Exempel:
https://www.acme.com/api/uploadInit?parentId=12345&filename=new-file.png&documentId=511ea6e000023edb38d2effb2f4e6e3b&documentVersionId=511ea6e000023edb38d2e ffb2f4e6e3b
PUT
Överför byte i ett dokument till webbholleverantören.
URL
PUT /upload
Frågeparametrar
Begär brödtext
Dokumentets byte med Raw-innehåll.
Svar
{
result: "success"
}
eller
{
result: "fail"
}
Exempel
https://www.acme.com/api/upload?id=1234 [document bytes included in update stream]
svar
{
result:"success"
}