wordpress REST API 手册 —- 文章修订(Post-revisions)
文章修订(Post-revisions)
TOPICS
- Schema
- List Post-revisions
- Retrieve a Post-revision
- Delete a Post-revision
- Retrieve a Post-revision
- Create a Post-revision
- Retrieve a Post-revision
Schema Schema
The schema defines all the fields that exist for a post-revision object.
| author
integer |
The ID for the author of the object.Context: view, edit, embed |
| date
string, |
The date the object was published, in the site’s timezone.Context: view, edit, embed |
| date_gmt
string, |
The date the object was published, as GMT.Context: view, edit |
| guid
object |
The globally unique identifier for the object.Read only
Context: view, edit |
| id
integer |
Unique identifier for the object.Context: view, edit, embed |
| modified
string, |
The date the object was last modified, in the site’s timezone.Context: view, edit |
| modified_gmt
string, |
The date the object was last modified, as GMT.Context: view, edit |
| parent
integer |
The ID for the parent of the object.Context: view, edit, embed |
| slug
string |
An alphanumeric identifier for the object unique to its type.Context: view, edit, embed |
| title
object |
The title for the object.Context: view, edit, embed |
| content
object |
The content for the object.Context: view, edit |
| excerpt
object |
The excerpt for the object.Context: view, edit, embed |
Example Request Example Request
$ curl -X OPTIONS -i https://example.com/wp-json/wp/v2/posts/<parent>/revisions
List Post-revisions List Post-revisions
Arguments Arguments
| parent | The ID for the parent of the object. |
| context | Scope under which the request is made; determines fields present in response.Default: view
One of: view, embed, edit |
| page | Current page of the collection.Default: 1 |
| per_page | Maximum number of items to be returned in result set. |
| search | Limit results to those matching a string. |
| exclude | Ensure result set excludes specific IDs. |
| include | Limit result set to specific IDs. |
| offset | Offset the result set by a specific number of items. |
| order | Order sort attribute ascending or descending.Default: desc
One of: asc, desc |
| orderby | Sort collection by object attribute.Default: date
One of: date, id, include, relevance, slug, include_slugs, title |
Definition Definition
GET /wp/v2/posts/<parent>/revisions
Example Request Example Request
$ curl https://example.com/wp-json/wp/v2/posts/<parent>/revisions
Retrieve a Post-revision Retrieve a Post-revision
Arguments Arguments
| parent | The ID for the parent of the object. |
| id | Unique identifier for the object. |
| context | Scope under which the request is made; determines fields present in response.Default: view
One of: view, embed, edit |
Definition Definition
GET /wp/v2/posts/<parent>/revisions/<id>
Example Request Example Request
$ curl https://example.com/wp-json/wp/v2/posts/<parent>/revisions/<id>
Delete a Post-revision Delete a Post-revision
Arguments Arguments
| parent | The ID for the parent of the object. |
| id | Unique identifier for the object. |
| force | Required to be true, as revisions do not support trashing. |
Definition Definition
DELETE /wp/v2/posts/<parent>/revisions/<id>
Example Request Example Request
$ curl -X DELETE https://example.com/wp-json/wp/v2/posts/<parent>/revisions/<id>
Retrieve a Post-revision Retrieve a Post-revision
Arguments Arguments
| parent | The ID for the parent of the object. |
| context | Scope under which the request is made; determines fields present in response.Default: view
One of: view, embed, edit |
Definition Definition
GET /wp/v2/posts/<id>/autosaves
Example Request Example Request
$ curl https://example.com/wp-json/wp/v2/posts/<id>/autosaves
Create a Post-revision Create a Post-revision
Arguments Arguments
| parent | The ID for the parent of the object. |
| date | The date the object was published, in the site’s timezone. |
| date_gmt | The date the object was published, as GMT. |
| slug | An alphanumeric identifier for the object unique to its type. |
| status | A named status for the object. One of: publish, future, draft, pending, private |
| password | A password to protect access to the content and excerpt. |
| title | The title for the object. |
| content | The content for the object. |
| author | The ID for the author of the object. |
| excerpt | The excerpt for the object. |
| featured_media | The ID of the featured media for the object. |
| comment_status | Whether or not comments are open on the object. One of: open, closed |
| ping_status | Whether or not the object can be pinged. One of: open, closed |
| format | The format for the object. One of: standard, aside, chat, gallery, link, image, quote, status, video, audio |
| meta | Meta fields. |
| sticky | Whether or not the object should be treated as sticky. |
| template | The theme file to use to display the object. |
| categories | The terms assigned to the object in the category taxonomy. |
| tags | The terms assigned to the object in the post_tag taxonomy. |
Definition Definition
POST /wp/v2/posts/<id>/autosaves
Retrieve a Post-revision Retrieve a Post-revision
Arguments Arguments
| parent | The ID for the parent of the object. |
| id | The ID for the object. |
| context | Scope under which the request is made; determines fields present in response.Default: view
One of: view, embed, edit |
Definition Definition
GET /wp/v2/posts/<parent>/autosaves/<id>
Example Request Example Request
$ curl https://example.com/wp-json/wp/v2/posts/<parent>/autosaves/<id>
原文：https://developer.wordpress.org/rest-api/reference/pages/