diff --git a/API.md b/API.md index ab7a9b4..38aea69 100644 --- a/API.md +++ b/API.md @@ -1391,7 +1391,8 @@ A single user. - ``: the user name. - ``: the user email. It is available only if the request is authenticated by the same user, or the authenticated user can change the - email. + email. If it's unavailable, the server returns `false`. If the user hasn't + specified an email, the server returns `null`. - ``: the user rank, which effectively affects their privileges. Possible values: @@ -1444,7 +1445,12 @@ experience. "name": , "color": , "usages": - "default": + "default": , + "snapshots": [ + , + , + + ] } ``` @@ -1454,6 +1460,8 @@ experience. - ``: the category color. - ``: how many tags is the given category used with. - ``: whether the tag category is the default one. +- ``: a [snapshot resource](#snapshot) that contains the tag + category's earlier versions. ## Detailed tag category **Description** @@ -1465,19 +1473,12 @@ A tag category with extra information. ```json5 { "tagCategory": , - "snapshots": [ - , - , - - ] } ``` **Field meaning** - ``: a [tag category resource](#tag-category) -- ``: a [snapshot resource](#snapshot) that contains the tag - category's earlier versions. ## Tag **Description** @@ -1494,7 +1495,12 @@ A single tag. Tags are used to let users search for posts. "suggestions": , "creationTime": , "lastEditTime": , - "usages": + "usages": , + "snapshots": [ + , + , + + ] } ``` @@ -1510,6 +1516,8 @@ A single tag. Tags are used to let users search for posts. - ``: time the tag was created, formatted as per RFC 3339. - ``: time the tag was edited, formatted as per RFC 3339. - ``: the number of posts the tag was used in. +- ``: a [snapshot resource](#snapshot) that contains the tag's + earlier versions. ## Detailed tag **Description** @@ -1521,18 +1529,11 @@ A tag with extra information. ```json5 { "tag": , - "snapshots": [ - , - , - - ] } ``` **Field meaning** - ``: a [tag resource](#tag) -- ``: a [snapshot resource](#snapshot) that contains the tag's - earlier versions. ## Post **Description** @@ -1566,6 +1567,16 @@ One file together with its metadata posted to the site. "favoritedBy": , "hasCustomThumbnail": , "mimeType": + "snapshots": [ + , + , + + ], + "comments": { + , + , + + } } ``` @@ -1617,6 +1628,9 @@ One file together with its metadata posted to the site. - ``: whether the post uses custom thumbnail. - ``: subsidiary to ``, used to tell exact content format; useful for `