api:post versions
Table of Contents
The following includes the details of how to interface with the post version records through the API.
Record field format
| Name | Type | Details |
|---|---|---|
id | integer | >0 |
post_id | integer | >0 |
tags | string | space delineated, tag format |
added_tags | array | string, tag format |
removed_tags | array | string, tag format |
rating | string | [g, s, q, e] |
parent_id | integer | >0 or null |
source | string | |
rating_changed | boolean | |
parent_changed | boolean | |
source_changed | boolean | |
version | integer | >0 |
updater_id | integer | >0 |
created_at | timestamp | |
updated_at | timestamp | |
updater_addr_ip | inet | Limited to Moderator+ |
Associated attributes
| Name | Type | Number | Availability | Details |
|---|---|---|---|---|
post | post | single | required | |
updater | user | single | required |
Nomenclature
- Plural form: "post_versions"
- Used in the URL pathname
- Singular form: "post_version"
- Unused
- Version of: API:Posts
Index
| HTTP Method | GET or POST [1] |
| Base URL | /post_versions.json |
| Type | read request |
| Description | The default order is ID descending. |
Search attributes
All of the following are standard attributes with all of their available formats and qualifiers.
- Number syntax
idpost_idparent_idupdater_idversioncreated_atupdated_at- Text syntax
tagsratingsource- Boolean syntax
rating_changedparent_changedsource_changed- Array syntax
added_tagsremoved_tags
Special search parameters
changed_tags- Search where all tags must be either an added tag or removed tag- The list of tags is space-delineated
all_changed_tags- The same aschanged_tagschanged_tags- Search where at least one tag must be either an added tag or removed tag- The list of tags is space-delineated
tag_matches- Case-insensitive search of the tag string with first tag from the input- If asterisks ( * ) are missing from the input, it adds an asterisk to either side of the tag
updater_name- Searches by updater name instead of updater IDis_new- Boolean syntax- Shorthand search for
version=1orversion=>1