Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Last revisionBoth sides next revision
dev:web_api:v3:types_and_fields [2017/11/12 19:53] – external edit 127.0.0.1dev:web_api:v3:types_and_fields [2019/12/06 14:51] – Clarify "conditional requests" tomas_fiers
Line 1: Line 1:
-<html><p id="zotero-5-update-warning" style="color: red; font-weight: bold">We’re 
-in the process of updating the documentation for 
-<a href="https://www.zotero.org/blog/zotero-5-0">Zotero 5.0</a>. Some documentation 
-may be outdated in the meantime. Thanks for your understanding.</p></html> 
- 
- 
 ====== Zotero Web API Item Type/Field Requests ====== ====== Zotero Web API Item Type/Field Requests ======
  
 For a [[start|Zotero Web API]] client to present an editing UI to its users, it must know what combinations of Zotero item types, fields, and creator types are valid. Clients can request this data from the Zotero API. For a [[start|Zotero Web API]] client to present an editing UI to its users, it must know what combinations of Zotero item types, fields, and creator types are valid. Clients can request this data from the Zotero API.
  
-As schema changes are currently rare, clients should cache type/field data for a period of time (e.g., one hour) without making further requests. Subsequent requests for new data should then include ''If-Modified-Since'' headers containing the contents of the ''Last-Modified'' header from the original response. If no changes have occurred, the server will return a ''304 Not Modified'' and clients should continue to use cached data for the same period of time. //[Conditional requests are not yet implemented.]//+As schema changes are currently rare, clients should cache type/field data for a period of time (e.g., one hour) without making further requests. Subsequent requests for new data should then include ''If-Modified-Since'' headers containing the contents of the ''Last-Modified'' header from the original response. If no changes have occurred, the server will return a ''304 Not Modified'' and clients should continue to use cached data for the same period of time. //[Conditional requests -- i.e. ''If-Modified-Since'' -- are not yet implemented.]//
  
-User-friendly type/field names will be returned in English by default. Clients can request names in other languages by passing a ''locale'' parameter (e.g., ''GET /itemTypes?locale=fr-FR''). //[Non-English locales are not yet implemented.]//+User-friendly type/field names will be returned in English by default. Clients can request names in other languages by passing a ''locale'' parameter (e.g., ''GET /itemTypes?locale=fr-FR'').
  
 ==== Getting All Item Types ==== ==== Getting All Item Types ====
dev/web_api/v3/types_and_fields.txt · Last modified: 2019/12/07 18:46 by tomas_fiers