In addition to providing ways toreadandwrite188BET靠谱吗online library data, the Zotero Web API allows you to upload attachment files.

The exact process depends on whether you are adding a new attachment file or modifying an existing one and whether you are performing a full upload or uploading a binary diff.

GET /items/new?itemType=attachment&linkMode={imported_file,imported_url,linked_file,linked_url}

{   "itemType": "attachment",   "linkMode": "imported_url",   "title": "",   "accessDate": "",   "url": "",   "note": "",   "tags": [],   "relations": {},   "contentType": "",   "charset": "",   "filename": "",   "md5": null,   "mtime": null }

POST /users/
        
         188BET靠谱吗/items Content-Type: application/json Zotero-Write-Token:
         
        

[   {     "itemType": "attachment",     "parentItem": "ABCD2345",     "linkMode": "imported_url",     "title": "My Document",     "accessDate": "2012-03-14T17:45:54Z",     "url": "http://example.com/doc.pdf",     "note": "",     "tags": [],     "relations": {},     "contentType": "application/pdf",     "charset": "",     "filename": "doc.pdf",     "md5": null,     "mtime": null   } ]

md5andmtimecan be edited directly in personal libraries for WebDAV-based file syncing.188BET靠谱吗They should not be edited directly when using Zotero File Storage, which provides an atomic method (detailed below) for setting the properties along with the corresponding file.

Top-level attachments can be created by excluding theparentItemproperty or setting it tofalse.Though the API allows all attachments to be made top-level items for backward-compatibility, it is recommended that only file attachments (imported_file/linked_file) and PDF imported web attachments (imported_urlwith content typeapplication/pdf188BET靠谱吗) be allowed as top-level items, as in the Zotero client.

GET /users/
        
         /items/
         
        

{   "key": "ABCD2345",   "version": 124,   "library": { ...},   ..."data": {     "key": "ABCD2345",     "version": 124,     "itemType": "attachment",     "linkMode": "imported_file",     "title": "My Document",     "note": "",     "tags": [],     "relations": {},     "contentType": "text/plain",     "charset": "utf-8",     "filename": "doc.txt",     "md5": "4fa38e3f2c360ca181e633d02bab91f5",     "mtime": "1331171741767"   } }

GET /users/
        
         /items/
         
          /file
         
        

Check theETagheader of the response to make sure it matches the attachment item'smd5value.If it doesn't, check the attachment item again.188BET靠谱吗If the attachment item still has a different hash, the latest version of the file may be available only via WebDAV, not via Zotero File Storage, and it is up to the client how to proceed.

Save the file asfilenameand set the modification time to themtimeprovided in the attachment item.

Note that to perform a faster partial upload using a binary diff, you must save a copy of the file before changes are made.

POST /users/
        
         /items/
         
          /file Content-Type: application/x-www-form-urlencoded If-None-Match: *
         
        

md5=
        
         &filename=
         
          &filesize=
          
           &mtime=
           
          
         
        

For existing attachments, useIf-Match: in place ofIf-None-Match: *, where is the previous MD5 hash of the file (as provided in the ETagheader when downloading it).

Note thatmtimemust be provided in milliseconds, not seconds.

A successful200response returns one of two possible JSON objects:

{   "url": ...,   "contentType": ...,   "prefix": ...,   "suffix": ...,   "uploadKey": ...}

or

{ "exists": 1 }

In the latter case, the file already exists on the server and was successfully associated with the specified item.No further action is necessary.

Concatenateprefix, the file contents, andsuffixand POST tourlwith theContent-Typeheader set tocontentType.

prefixandsuffixare strings containing multipart/form-data.In some environments, it may be easier to work directly with the form parameters.Addparams=1to the upload authorization request above to retrieve the individual parameters in aparamsarray, which will replacecontentType,prefix, andsuffix.

POST /users/
        
         /items/
         
          /file Content-Type: application/x-www-form-urlencoded If-None-Match: *
         
        

upload=
        

For existing attachments, useIf-Match: , where is the previous MD5 hash of the file, provided as the md5property in the attachment item.

After the upload has been registered, the attachment item will reflect the new metadata (filename,mtime,md5).

PATCH /users/
        
         /items/
         
          /file?algorithm={xdelta,vcdiff,bsdiff}&upload=
          
           If-Match:
           
          
         
        

For best results, we recommend using Xdelta version 3 with the "-9 -S djw" flags.bsdiff takes significantly longer to generate diffs.'vcdiff' is an alias for 'xdelta', as Xdelta3 can process diffs in VCDIFF format.

Clients may wish to automatically fall back to a full upload — possibly with some form of warning — if HTTP PATCH is not supported by a user's proxy server (indicated, in theory, by a405 Method Not Allowed).

After the upload has finished, the attachment item will reflect the new metadata.