Both sides previous revisionPrevious revision | Next revisionBoth sides next revision |
dev:web_api:v3:basics [2019/08/10 07:03] – [Searching] dstillman | dev:web_api:v3:basics [2019/08/10 07:17] – [Resources] dstillman |
---|
==== 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 ==== |