The page documents read requests available in the188BET靠谱吗Zotero Web API188BET靠谱吗, providing read-only access to online Zotero libraries.

The baseURLfor allAPIrequests is

188BET靠谱吗https://api.zotero.org

All requests must use HTTPS.

Multiple versions of theAPIare available, and production code should always request a specific version.This page documentsAPIversion 3, which is currently the default and recommended version.

Clients can request a specific version in one of two ways:

1. Via the 188BET靠谱吗Zotero-API-VersionHTTP header ( 188BET靠谱吗Zotero-API-Version: 3)
2. Via the vquery parameter ( v=3)

Use of the188BET靠谱吗Zotero-API-Versionheader is recommended for production code.Thevparameter can be used for easier debugging and sharing ofAPIrequests or in clients that can't pass arbitrary HTTP headers.

TheAPIversion of a response will be returned in the188BET靠谱吗Zotero-API-Versionresponse header.

At most times,APIchanges are made in a backwards-compatible manner.Occasionally, however, backwards-incompatible changes may need to be made.When this occurs, a newAPIversion will be made available without changing the default version for clients that don't request a specific version.After a transition period, the newAPIversion will become the default.If anAPIversion is discontinued, clients requesting the discontinued version will receive the oldest available version.Announcements regardingAPIversion transitions will always be made ahead of time on188BET靠谱吗zotero-dev.

Authentication is not required for read access to public libraries.

Accessing non-public libraries requires use of anAPIkey.Third-party developers shoulduse OAuth to establish credentialsor instruct their users to create dedicated keys for use with their services.End users can createAPIkeys via188BET靠谱吗their Zotero account settings.

APIkeys can be included in requests in one of three ways:

1. As an HTTP header in the form 188BET靠谱吗Zotero-API-Key: P9NiFoyLeZu2bZNvvuQPDWsd
   
2. As an HTTP header in the form Authorization: Bearer P9NiFoyLeZu2bZNvvuQPDWsd
   
3. As a URLquery parameter, in the form key=P9NiFoyLeZu2bZNvvuQPDWsd(not recommended)

Use of an HTTP header is recommended, as it allows use of URLs returned from theAPI(e.g., for pagination) without modification.

Authorization: Beareris also the authentication mechanism for OAuth 2.0.188BET靠谱吗While Zotero currently supports only OAuth 1.0a, when support for OAuth 2.0 is added, clients will no longer need to extract theAPIkey from the OAuth response and pass it to theAPIseparately.

Requests for data in a specific library begin with/users/ or金博宝世界杯体育赛事/groups/ , referred to below as .User IDs are different from usernames and can be found on theAPI Keyspage and in OAuth responses.Group IDs are different from group names and can be retrieved from/users/ 金博宝世界杯体育赛事/groups .

(Note: Only search metadata is currently available, not search results.)

The following parameters affect the format of data returned from read requests.All parameters are optional.

The following parameters are valid for all read requests:

Note the difference betweenformat=bibandinclude=bib/content=bib.format=bibreturns a formatted bibliography as XHTML, sorted according to the rules of the selected style.include=bib(valid only forformat=json(the default format mode) andformat=atom) returns an individual formatted reference within the JSONdatablock or Atom block for each item, with the results or feed sorted according to the query parameters.format=bibprocesses the entire feed you are requesting without regard for any limit arguments, so it is generally a good idea to use it only with collections or tags.

The following bibliographic data formats can be used asformat,include, andcontentparameters for items requests:

These parameters can be used to search against items when returning tags within items.In such cases, the main parameters (q,qmode,tag) apply to the tags themselves, as the primary objects of the request.

itemTypeandtagparameters support Boolean searches:

Examples:

• itemType=book
• itemType=book || journalArticle(OR)
• itemType=-attachment(NOT)

• tag=foo
• tag=foo bar(tag with space)
• tag=foo&tag=bar(AND)
• tag=foo bar || bar(OR)
• tag=-foo(NOT)
• tag=\-foo(literal first-character hyphen)

Be sure toURL-encode search strings if required by your client or library.

The following parameters are valid only for multi-object read requests such as /items , with the exception offormat=bibrequests, which do not support sorting or pagination.

Responses for multi-object read requests will include a custom HTTP header,Total-Results, that provides the total number of results matched by the request.The actual number of results provided in a given response will be no more than 100.

When the total number of results matched by a read request is greater than the current limit, theAPIwill include pagination links in the HTTPLinkheader.Possible values arerel=first,rel=prev,rel=next, andrel=last.For some requests, the header may also include arel=alternate188BET靠谱吗link for the relevant page on the Zotero website.

188BET靠谱吗GET https://api.zotero.org/users/12345/items?limit=30

Link:
        
         !rel="next",
         
          !rel="last",
          
           !rel="alternate"
          
         
        

(Newlines are inserted here for clarity.)

For efficient usage of theAPI, clients should make conditional GET requests whenever possible.Multi-object requests (e.g.,/users/1/items) return aLast-Modified-Versionheader with the current library version.If aIf-Modified-Since-Version: header is passed with a subsequent multi-object read request and data has not changed in the library since the specified version, theAPIwill return304 Not Modifiedinstead of200.(Single-object conditional requests are not currently supported, but will be supported in the future.)

While a conditional GET request that returns a304188BET靠谱吗should be fast, some clients may wish or need to perform additional caching on their own, using stored data for a period of time before making subsequent conditional requests to the ZoteroAPI.188BET靠谱吗This makes particular sense when the underlying Zotero data is known not to change frequently or when the data will be accessed frequently.188BET靠谱吗For example, a website that displayed a bibliography from a Zotero collection might cache the returned bibliography for an hour, after which time it would make another conditional request to the ZoteroAPI.If theAPIreturned a304, the website would continue to display the cached bibliography for another hour before retrying.188BET靠谱吗This would prevent the website from making a request to the ZoteroAPIevery time a user loaded a page.

188BET靠谱吗In addition to making conditional requests, clients downloading data for entire Zotero libraries should use?since=to request only objects that have changed since the last time data was downloaded.

SeeSyncingfor more information on library and object versioning.

[Not all rate limits are currently enforced, but clients should be prepared to handle them.]

188BET靠谱吗Clients accessing the ZoteroAPIshould be prepared to handle two forms of rate limiting: backoff requests and hard limiting.

If theAPIservers are overloaded, theAPImay include aBackoff: HTTP header in responses, indicating that the client should perform the minimum number of requests necessary to maintain data consistency and then refrain from making further requests for the number of seconds indicated.Backoffcan be included in any response, including successful ones.

If a client has made too many requests within a given time period or is making too many concurrent requests, theAPImay return429 Too Many Requestswith aRetry-After: header.Clients receiving a429should wait at least the number of seconds indicated in the header before making further requests.They should also reduce their overall request rate and/or concurrency to avoid repeatedly getting 429s, which may result in stricter throttling or temporary blocks.

Retry-Aftercan also be included with503 Service Unavailableresponses when the server is undergoing maintenance.

Several examples of read request URLs and their responses:

Successful GET requests will return a200 OKstatus code.

Conditional GET requestsmay return304 Not Modified.

For any read or write request, the server may return a400 Bad Request,404 Not Found, or405 Method Not Allowedfor an invalid request and500 Internal Server Erroror503 Service Unavailablefor a server-related issue.Authenticationerrors (e.g., invalidAPIkey or insufficient privileges) will return a403 Forbidden.

Passing anExpectheader, which is unsupported, will result in a417 Expectation Failedresponse.

Library/object versioningor188BET靠谱吗Zotero-Write-Tokenerrors will result in412 Precondition Failedor428 Precondition Required.

429 Too Many Requestsindicates that the client has beenrate-limited.

• Write Requests
• File Uploads
• Syncing
• OAuth Authentication
• Changes from API Version 2