Differences

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

Link to this comparison view

Both sides previous revision Previous revision
dev:web_api:v3:basics [2019/08/10 07:03]
dstillman [Searching]
dev:web_api:v3:basics [2019/08/10 07:17] (current)
dstillman [Resources]
Line 46: Line 46:
 ==== User and Group Library URLs ==== ==== User and Group Library URLs ====
  
-Requests for data in a specific library begin with ''/​users/<​userID>''​ or ''/​groups/<​groupID>'',​ referred to below as ''<​userOrGroupPrefix>''​. User IDs are different from usernames and can be found on the [[/​settings/​keys|API Keys]] page and in OAuth responses.+Requests for data in a specific library begin with ''/​users/<​userID>''​ or ''/​groups/<​groupID>'',​ referred to below as ''<​userOrGroupPrefix>''​. User IDs are different from usernames and can be found on the [[/​settings/​keys|API Keys]] page and in OAuth responses. ​Group IDs are different from group names and can be retrieved from ''/​users/<​userID>/​groups''​. 
 + 
 +=== Collections ===
  
 ^ URI ^ Description ^ ^ URI ^ Description ^
-| <​userOrGroupPrefix>/​items | The set of all items in the library, excluding trashed items | +| <​userOrGroupPrefix>/​collections | Collections ​in the library | 
-| <​userOrGroupPrefix>/​items/​top | The set of all top-level items in the library, excluding trashed items | +| <​userOrGroupPrefix>/​collections/​top | Top-level collections in the library |
-| <​userOrGroupPrefix>/​items/​trash | The set of items in the trash | +
-| <​userOrGroupPrefix>/​items/<​itemKey>​ | A specific item in the library | +
-| <​userOrGroupPrefix>/​items/<​itemKey>/​children | The set of all child items under a specific item | +
-| <​userOrGroupPrefix>/​items/<​itemKey>/​tags | The set of all tags associated with a specific item | +
-| <​userOrGroupPrefix>/​tags | The set of all tags in the library | +
-| <​userOrGroupPrefix>/​tags/<​url+encoded+tag>​ | The set of tags (i.e., of all types) matching a specific name | +
-| <​userOrGroupPrefix>/​collections | The set of all collections ​in the library | +
-| <​userOrGroupPrefix>/​collections/​top | The set of all top-level collections in the library |+
 | <​userOrGroupPrefix>/​collections/<​collectionKey>​ | A specific collection in the library | | <​userOrGroupPrefix>/​collections/<​collectionKey>​ | A specific collection in the library |
-| <​userOrGroupPrefix>/​collections/<​collectionKey>/​collections | The set of subcollections ​within a specific collection in the library | +| <​userOrGroupPrefix>/​collections/<​collectionKey>/​collections | Subcollections ​within a specific collection in the library | 
-| <​userOrGroupPrefix>/​collections/<collectionKey>/items | The set of all items within a specific ​collection ​in the library | + 
-| <​userOrGroupPrefix>/​collections/<collectionKey>/items/top The set of top-level ​items within a specific collection in the library | +=== Items === 
-| <​userOrGroupPrefix>/​collections/<​collectionKey>/​tags The set of tags within a specific collection in the library | + 
-| <​userOrGroupPrefix>/​searches | The set of all saved searches in the library |+^ URI ^ Description ^ 
 +| <​userOrGroupPrefix>/​items | All items in the library, excluding trashed items | 
 +| <​userOrGroupPrefix>​/items/top | Top-level items in the library, excluding trashed items | 
 +<userOrGroupPrefix>/items/​trash ​Items in the trash | 
 +| <​userOrGroupPrefix>/​items/<​itemKey>​ | A specific ​item in the library | 
 +| <​userOrGroupPrefix>/​items/<itemKey>/children | Child items under a specific item |  
 +| <​userOrGroupPrefix>​/publications/​items ​Items in My Publications | 
 +| <​userOrGroupPrefix>/​collections/<​collectionKey>/​items | Items within a specific collection in the library | 
 +| <​userOrGroupPrefix>/​collections/<​collectionKey>/​items/​top ​Top-level items within a specific collection in the library | 
 + 
 +=== Searches === 
 + 
 +(Note: Only search metadata is currently available, not search results.) 
 + 
 +^ URI ^ Description ^ 
 +| <​userOrGroupPrefix>/​searches | All saved searches in the library |
 | <​userOrGroupPrefix>/​searches/<​searchKey>​ | A specific saved search in the library | | <​userOrGroupPrefix>/​searches/<​searchKey>​ | A specific saved search in the library |
 +
 +=== Tags ===
 +
 +^ URI ^ Description ^
 +| <​userOrGroupPrefix>/​tags | All tags in the library |
 +| <​userOrGroupPrefix>/​tags/<​url+encoded+tag>​ | Tags of all types matching a specific name |
 +| <​userOrGroupPrefix>/​items/<​itemKey>/​tags | Tags associated with a specific item |
 +| <​userOrGroupPrefix>/​collections/<​collectionKey>/​tags | Tags within a specific collection in the library |
 +| <​userOrGroupPrefix>/​items/​tags | All tags in the library, with the ability to filter based on the items |
 +| <​userOrGroupPrefix>/​items/​top/​tags | Tags assigned to top-level items |
 +| <​userOrGroupPrefix>/​items/​trash/​tags | Tags assigned to items in the trash |
 +| <​userOrGroupPrefix>/​items/<​collectionKey>/​items/​tags | Tags assigned to items in a given collection |
 +| <​userOrGroupPrefix>/​items/<​collectionKey>/​items/​top/​tags | Tags assigned to top-level items in a given collection |
 +| <​userOrGroupPrefix>/​publications/​items/​tags | Tags assigned to items in My Publications |
 +
 +
  
 ==== Other URLs ==== ==== Other URLs ====
dev/web_api/v3/basics.txt · Last modified: 2019/08/10 07:17 by dstillman