voceconnect/thermal-api voceconnect/thermal-api

  • Stars
    star
    147
  • Rank 250,615 (Top 5 %)
  • Language
    PHP
  • Created over 11 years ago
  • Updated about 8 years ago
Twitter logo Share LinkedIn logo Share Facebook logo Share
voceconnect/thermal-api
github

voceconnect

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Thermal is the WordPress plugin that gives you the power of WP_Query in a RESTful API.

Please note: This plugin is no longer being actively maintained or supported.

Thermal API

Build Status

Current API version: v1

Overview

Thermal is the WordPress plugin that gives you the access and control to your content from outside of the WordPress admin. Thermal supports client-based decisions that, when combined with a responsive design framework, allows for a truly responsive application leveraging a WordPress content source.

Versions

In order to support migration, the API plugin will support up to 2 versions of the API. Once a version is more than 1 cycle old, it will no longer respond at it's API root unless configured to do so.

API Root

The URL root of the API will be the version number of the API prefixed by your WordPress site URL and the Voce\Thermal\API_ROOT constant. By default this is set to wp_api but can be overridden by setting it in wp-config.php.

The current API version is v1 so the default URL root is:

http://example.com/wp_api/v1/

Resource Types

The following resources are available

Posts

A post represents a single item of content.

Methods

List

Request
GET {api root}/posts
Parameters

Parameter Data Type Description
Date Filters
m string A compressed datetime string in the format of 'YmdGis' that represents date/time range to filter posts to (.e.g 2012-01-01 13:59:59 is expressed as 20120101135959). As most right most parts of the string are left off, the filter becomes less exact.

Examples:

  • 'm=2012' Only posts from 2012 will be returned; Equivalent to 'year=2012'
  • 'm=201206' Only posts from June 2012 will be returned; Equivalent to 'year=2012&monthnum=6'
  • 'm=20120609' Only posts from June 9th, 2012 will be returned; Equivalent to 'year=2012&monthnum=6&day=9'
year integer 4 digit year (e.g. 2012)
monthum integer Month number (from 1 to 12)
w integer Week of the year (from 0 to 53)
day integer Day of the month (from 0 to 31)
hour integer Hour of the day in 24 hour format (from 0 to 23)
minute integer Minute (from 0 to 59)
second integer Second (from 0 to 59)
before string A parsable formatted date string. Unless specified in the format used, the result will be relative to the timezone of the site.
after string A parsable formatted date string. Unless specified in the format used, the result will be relative to the timezone of the site.
Search Filtering
s string Search keyword or string, by default this searches against the title and post_content By default, the search expression is split into individual terms.
exact boolean Default false. If true, the search will omit the wildcard '%' wrapper, making it so that at least one searched fields be an exact match.
sentence boolean Default false. If true, the search string will not be split up into individual tokens and the expression will be matched in its entirety.
Taxonomy Filters
cat array|integer The term_id of the category to include. An array of IDs will also be accepted.
category_name string The slug of a single category.
tag string The slug of a single tag
taxonomy associative array An associative array where the key is the name of the taxonomy and the value is an array of term IDs. Post that exist in any of the terms will be included in the results. Only public taxonomies will be recognized.
Pagination Filters
paged integer A positive integer specifiying the page (or subset of results) to return. This filter will automatically determine the offset to use based on the per_page and paged. Using this filter will cause include_found to be true.
per_page integer The maximum number of posts to return. The value must range from 1 to MAX_POSTS_PER_PAGE.
offset integer The number of posts to skip over before returning the result set.
Ordering Parameters
orderby array|string Sort the results by the given identifier. Defaults to 'date'. Supported values are:
  • 'none' - No ordering will be applied.
  • 'ID' - The ID of the post.
  • 'author' - The value of the author ID.
  • 'title' - The title of the post.
  • 'name' - The slug/name of the post.
  • 'date' - (Default) Publish date of the post.
  • 'modified' - Last modified date of the post.
  • 'parent'- The ID of the post's parent
  • 'rand' - A random order, Note: due to caching, the order may not change on every request.
  • 'comment_count' - The number of comments the post has.
  • 'menu_order' - The set menu order for the post.
  • 'post__in' - Preserves the order supplied in the post__in filter. This is ignored unless the post__in filter is supplied.

Orderby will also accept an array of multiple identifiers.

order string The order direction. Options are 'ASC' and 'DESC'. Default is 'DESC'
General Filters
author_name string The user_nicename of the author.
author integer The ID of the authors to include. An array of IDs will also be accepted. Negative ID's can be used to denote exclusion.
post__in array|integer An array of post ID's to include.
p integer A single post ID
name string The post_name or slug of the post
pagename string The post_name or slug of the post. Will cause the post_type filter to default to 'page'
attachment string The post_name or slug of the post. Will cause the post_type filter to default to 'attachment'.
attachment_id integer Synonym to 'p' filter.
subpost string Synonym for 'attachment' filter.
subpost_id integer Synonym for 'attachment_id' filter.
post_type array|string The post types to be included in the result set.
post_status array|string Default to 'publish'. The post statii to include in the result set. Note that the statii passed in are run through capability checks for the current user.
post_parent__in array|integer Array or single Post ID to pull child posts from.
Response Altering Parameters
include_found boolean Defaut to false. When true, the response will include a found rows count. There is some overhead in generating the total count so this should only be turned on when needed. This is automatically turned on if the 'paged' filter is used.
callback string When set, the response will be wrapped in a JSONP callback.
Response
{
	'found': 40, //only provided if include_found == true
	"posts": [
		[Post Object],
		….
	]
}

Single Entity

Request
GET {api root}/posts/{id}
Parameters
Parameter Data Type Description
Response Altering Parameters
callback string When set, the response will be wrapped in a JSONP callback.
Post JSON Schema
{
    "title": "Post Object",
    "description": "A representation of a single post object",
    "type": "object",
    "id": "#post",
    "properties": {
        "author": {
            "description": "The user set as the author of the post.",
            "type": {
                "$ref": "#user"
            },
            "required": true
        },
        "comment_count": {
            "description": "The number of comments for this post.",
            "type": "integer",
            "minimum": 0,
            "required": true
        },
        "comment_status": {
            "description": "The current status determining whether the post is accepting comments.",
            "enum": ["open", "closed"],
            "required": true
        },
        "content_display": {
            "description": "The content of the post after it has been run through the set 'the_content' filters.  Shortcodes are not expanded.",
            "type": "string",
            "required": true
        },
        "content": {
            "description": "The raw content of the post as it's stored in the database.",
            "type": "string",
            "required": true
        },
        "date": {
            "description": "The post's creation time in iso 8601 format.",
            "type": "string",
            "format": "date-time",
            "required": true
        },
        "excerpt_display": {
            "description": "The excerpt of the post after it has been run through the 'the_excerpt' filters.",
            "type": "string",
            "required": true
        },
        "excerpt": {
            "description": "The raw excerpt as it is stored in the database.",
            "type": "string",
            "required": true
        },
        "id_str": {
            "description": "The ID of the post represented as a string.",
            "type": "string",
            "required": true
        },
        "id": {
            "description": "The ID of the post",
            "type": "integer",
            "minimum": 1,
            "required": true
        },
        "type": {
            "description": "The post_type of the post",
            "type": "string",
            "required": true
        },
        "media": {
            "type": "array",
            "required": false,
            "items": {
                "type": {
                    "$ref": "#mediaItem"
                }
            }
        },
        "meta": {
            "description": "Additional data for the Post object.  Handling must be provided by other plugins to expand the provided meta beyond core properties.",
            "type": "object",
            "required": false,
            "default": {},
            "additionalProperties": {
                "featuredImage": {
                    "description": "The ID of the image being referenced as the featured image.  The referenced image should be present in the media property.",
                    "type": "integer",
                    "minimum": 1
                },
                "gallery": {
                	"description": "An array of objects that represent the galleries in the post content.",
                	"type": "array",
                	"required": false,
                	"items": {
                	 	"ids": {
                	 		"description": "The IDs of the attachments to be used in the gallery.",
                	 		"type": "array",
                	 		"required": false
                	 	},
                    	"orderby": {
                    		"description": "Specifies how to sort the display thumbnails.",
                    		"type": "array",
                    		"required": false
                    	},
                    	"order": {
                    		"description": "Specifies the sort order used to display thumbnails."
                    		"type": "string",
                    		"required": false
                    	},
                    	"in": {
                    		"description": "An array of IDs to only show the images from these attachments."
                    		"type": "array",
                    		"required": false
                    	},
                    	"exclude": {
                    		"description": "An array of IDs to not show the images from these attachments."
                    		"type": "array",
                    		"required": false
                    	},
                    	"id": {
                	 		"description": "The ID of the post to be used in the gallery. Used for specifying other posts.",
                	 		"type": "integer",
                	 		"required": false
                	 	}
                	}
                }
            }
        },
        "mime_type": {
            "description": "The mime type of the represented object",
            "type": "string",
            "required": true,
            "default": "text/html"
        },
        "modified": {
            "type": "string",
            "format": "date-time",
            "required": true
        },
        "name": {
            "description": "The name (slug) for the post, used in URLs.",
            "type": "string",
            "required": true
        },
        "parent_str": {
            "description": "The ID of the post's parent as a string, if it has one.",
            "type": "string",
            "required": false
        },
        "parent": {
            "description": "The ID of the post's parent as a string, if it has one.",
            "type": "integer",
            "required": false
        },
        "permalink": {
            "description": "The full permalink URL to the post.",
            "type": "string",
            "formate": "uri",
            "required": true
        },
        "status": {
            "description": "The status of the post.",
            "type": {
                "enum": ["publish", "draft", "pending", "future", "trash"]
            },
            "required": true
        },
        "taxonomies": {
            "description": "Key/Value pairs of taxonomies that exist for the given post where the Key is the name of the taxonomy.",
            "type": "object",
            "required": false,
            "default": {},
            "additionalProperties": {
                "category": {
                    "type": "array",
                    "items": {
                        "type": {
                            "$ref": "#term"
                        }
                    },
                    "required": false
                },
                "post_tag": {
                    "type": "array",
                    "items": {
                        "type": {
                            "$ref": "#term"
                        }
                    },
                    "required": false
                }
            }
        },
        "title": {
            "description": "The title of the Post.",
            "type": "string",
            "required": true
        }
    }
}
Example Post Response
{
	"id" : 1234567,
	"id_str" : "1234567",
	"type" : "post",
	"permalink": "http://example.com/posts/foobar/",
	"parent": 12345,
	"parent_str": "12345",
	"date": "2012-01-01T12:59:59+00:00",
	"modified": "2012-01-01T12:59:59+00:00",
	"status": "publish",
	"comment_status":"open",
	"comment_count": 99,
	"menu_order": 99,
	"title": "Lorem Ipsum Dolor!",
	"name": "loerm-ipsum-dolor"	,
	"excerpt": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec sed lacus eros. Integer elementum urna.",
	"excerpt_display": "<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec sed lacus eros. Integer elementum urna.</p>",
	"content": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed nec consequatnibh. Quisque in consectetur ligula. Praesent pretium massa vitae neque adipiscing vita cursus nulla congue.\n<img src=\"http://example.com/wp-content/uploads/2012/03/foobar.jpg\" class=\"alignleft  size-medium wp-image-17115\" alt=\"Lorem ipsum doler set amut.\" />\n Cras aliquet ipsum non nisi accumsan tempor sollicitudin lacus interdum Donec in enim ut ligula dignissim tempor. Vivamus semper cursus mi, at molestie erat lobortiut. Pellentesque non mi vitae augue egestas vulputate et eu massa. Integer et sem orci. Suspendisse at augue in ipsum convallis semper.\n\n[gallery ids=\"1,2,3,4\"]\n\nNullam vitae libero eros, a fringilla erat. Suspendisse potenti. In dictum bibendum liberoquis facilisis risus malesuada ac. Nulla ullamcorper est ac lectus feugiat scelerisque.  Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas",
	"content_display": "<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed nec consequatnibh. Quisque in consectetur ligula. Praesent pretium massa vitae neque adipiscing vita cursus nulla congue.</p>\n<img src=\"http://example.com/wp-content/uploads/2012/03/foobar.jpg\" class=\"alignleft  size-medium wp-image-17115\" alt=\"Lorem ipsum doler set amut.\" />\n<p>Cras aliquet ipsum non nisi accumsan tempor sollicitudin lacus interdum Donec in enim ut ligula dignissim tempor. Vivamus semper cursus mi, at molestie erat lobortiut. Pellentesque non mi vitae augue egestas vulputate et eu massa. Integer et sem orci. Suspendisse at augue in ipsum convallis semper.</p>\n\n<div class=\"gallery\" id=\"gallery-1234\"></div>\n\n<p>Nullam vitae libero eros, a fringilla erat. Suspendisse potenti. In dictum bibendum liberoquis facilisis risus malesuada ac. Nulla ullamcorper est ac lectus feugiat scelerisque.  Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas</p>",
	"author": [User Object],
	"mime_type": "",
	"meta": {
		"featuredImage": 123456,
		"gallery" : [
			{
				"ids": [23],
				"orderby": [
					"menu_order",
					"ID"
				],
				"order": "ASC",
				….
			},
			….
		]
	},
	"taxonomies": {
		"category": [
			[Term Object],
			….
		],
		"post_tag": [
			[Term Object],
			….
		],
		….
	},
	"media": [
		{
			"type":
			"id": 123456,
			"id_str": ""123445",
			"altText": "Lorem ipsum doler set amut.",
			"mime_type": "image/jpg",
			"sizes": [
				{
					"name": "thumbnail",
					"width": 100,
					"height": 80,
					"url": "http://example.com/wp-content/uploads/2012/02/foobar-100x80.jpg"
				},
				….
			]
		},
		….
	]
}

##Users A User represents a single author or user on the site.

Methods

List

Request
GET {api root}/users
Parameters
Parameter Data Type Description
Pagination Filters
paged integer A positive integer specifiying the page (or subset of results) to return. This filter will automatically determine the offset to use based on the per_page and paged. Using this filter will cause include_found to be true.
per_page integer The maximum number of posts to return. The value must range from 1 to MAX_USERS_PER_PAGE.
offset integer The number of posts to skip over before returning the result set.
Ordering Parameters
orderby string Sort the results by the given identifier. Defaults to 'display_name'. Supported values are:
  • 'display_name' - Ordered by the display name of the user.
  • 'nicename' - The slug/nicename of the user.
  • 'post_count' - The number of posts the user has.
order string The order direction. Options are 'ASC' and 'DESC'. Default is 'DESC'
General Filters
in array|integer An array of user ID's to include.
Response Altering Parameters
include_found boolean Defaut to false. When true, the response will include a found rows count. There is some overhead in generating the total count so this should only be turned on when needed. This is automatically turned on if the 'paged' filter is used.
who string Filters to users based on a subset of roles. Currently, only 'authors' is supported.
callback string When set, the response will be wrapped in a JSONP callback.
Response
{
	'found': 40, //only provided if include_found == true
	"users": [
		[User Object],
		….
	]
}

Single Entity

Request
GET {api root}/users/{id}
Parameters
Parameter Data Type Description
Response Altering Parameters
callback string When set, the response will be wrapped in a JSONP callback.
User JSON Schema
{
    "description": "Representation of a single sytem user or author.",
    "id": "#user",
    "type": "object",
    "properties": {
        "id_str": {
            "description": "The ID of the User object as a string.",
            "type": "integer",
            "required": true
        },
        "id": {
            "description": "The ID of the User object.",
            "type": "integer",
            "required": true
        },
        "nicename": {
            "description": "The user's slug, or url safe name.",
            "type": "string",
            "required": false
        },
        "display_name": {
            "description": "The user's name as shown publicly.",
            "type": "string",
            "required": false
        },
        "posts_url": {
            "description": "The URL to the user's posts.",
            "type": "string",
            "format": "uri",
            "required": false
        },
        "user_url": {
            "description": "The User's personal URL.",
            "type": "string",
            "required": false
        },
        "avatar": {
            "description": "An array of images/sizes available for the User's avatar.",
            "type": "array",
            "items": {
                "description": "Image information for a User's Avatar.",
                "type": "object",
                "properties": {
                    "height": {
                        "description": "Height of the image in pixels.",
                        "type": "integer",
                        "required": true
                    },
                    "url": {
                        "description": "Full URL to the image resource.",
                        "type": "string",
                        "format": "uri",
                        "required": true
                    },
                    "width": {
                        "description": "Width of the image in pixels.",
                        "type": "integer",
                        "required": true
                    }
                }
            }
        },
        "meta": {
            "description": "Extended User data.",
            "type": "object"
        }
    }

}
Example User Response
{
	"id" : 1234567,
	"id_str" : "1234567",
	"nicename": "john-doe",
	"display_name":"John Doe",
	"posts_url": "http://example.com/author/john-doe/",
	"user_url": "http://vocecomm.com",
	"avatar": [
		{
			"url":"http://1.gravatar.com/avatar/7a10459e7210f3bbaf2a75351255d9a3?s=64",
			"width":64,
			"height":64
		},
		….
	],
	"meta":{
		"nickname": "Johnny",
		"first_name": "John",
		"last_name": "Doe",
		"description": "Lorem ipsum dolar set amet."
	}
}

##Taxonomies Taxonomies represent the different types of classifications of content. Only public taxonomies can be returned via the API.

Methods

List

Request
GET {api root}/taxonomies
Parameters
Parameter Data Type Description
in array|string An array of taxonomy names to include.
post_type array|string An array of post_types to include taxonomies from. Results will include any taxonomies with at least 1 of the given post_types included.
callback string When set, the response will be wrapped in a JSONP callback.
callback string When set, the response will be wrapped in a JSONP callback.
Response
{
	"taxonomies": [
		[Taxonomy Object]
		….
	]
}

Single Entity

Request
GET {api root}/taxonomies/{name}
Parameters
Parameter Data Type Description
Response Altering Parameters
callback string When set, the response will be wrapped in a JSONP callback.
Taxonomy JSON Schema
{
    "id": "#taxonomy",
    "descrption": "A representation of a taxonomy.",
    "type": "object",
    "properties": {
        "name": {
            "description": "The name/unique identifier for the taxonomy.",
            "type": "string",
            "required": true
        },
        "post_type": {
            "description": "An array of post types the taxony is tied to.",
            "type": "array",
            "items": {
                "description": "The post_type string.",
                "type": "string"
            }
        },
        "hierarchical": {
            "description": "Indicates whether the taxonomy is hierarchical or allows parent/child relationships.",
            "type": "boolean",
            "default": false
        },
        "query_var": {
            "description": "The query_var tied to this taxonomy.  Useful when processing rewrite rules to determine the proper API query.",
            "type": "string",
            "required": false
        },
        "labels": {
            "description": "The user displayed name representing the taxonomy.",
            "type": "object",
            "properties": {
                "name": {
                    "description": "The plural name of the taxonomy.",
                    "type": "string"
                },
                "singularName": {
                    "description": "The singular name of the taxonomy.",
                    "type": "string"
                }
            }
        },
        "meta": {
            "description": "Extended Taxonomy data.",
            "type": "object"
        }
    }
}
Example Taxonomy Response
{
	"name": "category",
	"post_types": [
		"post",
		"attachment",
		….
	],
	"hierarchical": true,
	"queryVar":"category",
	"labels": {
		"name": "Categories",
		"singularName": "Category"
	},
	"meta":{
	}
}

##Terms Terms are individual classifications within a taxonomy.

Methods

List

Request
GET {api root}/taxonomies/{name}/terms
Parameters
Parameter Data Type Description
Pagination Filters
paged integer A positive integer specifiying the page (or subset of results) to return. This filter will automatically determine the offset to use based on the per_page and paged. Using this filter will cause include_found to be true.
per_page integer The maximum number of posts to return. The value must range from 1 to MAX_TERMS_PER_PAGE.
offset integer The number of posts to skip over before returning the result set.
Ordering Parameters
orderby string Sort the results by the given identifier. Defaults to 'name'. Supported values are:
  • 'name' - The user readable name of the term.
  • 'slug' - The slug of the term.
  • 'count' - The number of posts the term is connected to.
order string The order direction. Options are 'ASC' and 'DESC'. Default is 'DESC'
General Filters
in array|integer An array of term ID's to include.
slug string A term slug to include.
parent id Include the children of the provided term ID.
hide_empty boolean If true, only terms with attached posts will be returned. Default is true.
pad_counts boolean If true, count all of the children along with the term. Default is false.
Response Altering Parameters
include_found boolean Defaut to false. When true, the response will include a found rows count. There is some overhead in generating the total count so this should only be turned on when needed. This is automatically turned on if the 'paged' filter is used.
callback string When set, the response will be wrapped in a JSONP callback.
Response
{
	"found": 25,  //only provided if include_found == true
	"terms": [
		[Term Object]
		….
	]
}

Single Entity

Request
GET {api root}/taxonomies/{name}/terms/{term_id}
Parameters
Parameter Data Type Description
Response Altering Parameters
callback string When set, the response will be wrapped in a JSONP callback.

Term JSON Schema

{
    "type": "object",
    "required": false,
    "properties": {
        "description": {
            "description": "A long text describing the term.",
            "type": "string",
            "required": false
        },
        "meta": {
            "description": "Extended Term data.",
            "type": "object",
        },
        "name": {
            "description": "The title/name of the term as displayed to users.",
            "type": "string",
            "required": false
        },
        "parent_str": {
            "description": "The ID of the parent term as a string, if exists.",
            "type": "string",
            "required": false
        },
        "parent": {
            "description": "The ID of the parent term, if exists.",
            "type": "number",
            "required": false
        },
        "post_count": {
            "description": "The distinct count of posts attached to this term.  If 'pad_count' is set to true, this will also include all posts attached to child terms.  This only includes posts of type 'post'.",
            "type": "number",
            "required": false
        },
        "slug": {
            "description": "The name (slug) of the term as used in URLs.",
            "type": "string",
            "required": false
        },
        "taxonomy": {
            "type": "string",
            "required": false
        },
        "id_str": {
            "description": "The ID of the term as a string.",
            "type": "string",
            "id": "http://jsonschema.net/term_id_str",
            "required": false
        },
        "id": {
            "description": "The ID of the term.",
            "type": "number",
            "id": "http://jsonschema.net/term_id",
            "required": false
        },
        "term_taxonomy_id_str": {
            "description": "The ID that uniquely represents this term/taxonomy as ing asterms are shared across multiple taxonomies.",
            "type": "string",
            "id": "http://jsonschema.net/term_taxonomy_id_str",
            "required": false
        },
        "term_taxonomy_id": {
            "description": "The ID that uniquely represents this term/taxonomy as terms are shared across multiple taxonomies.",
            "type": "number",
            "id": "http://jsonschema.net/term_taxonomy_id",
            "required": false
        }
    }
}
Example Term Response
{
	"id": 123456,
	"term_id_str": "123456",
	"term_taxonomy_id": 123456789,
	"term_taxonomy_id_str": "123456789",
	"parent": 1234567,
	"parent_str": "1234567",
	"name": "Local News",
	"slug": "local-news",
	"taxonomy": "category",
	"description": "News reports from around Polk County",
	"post_count": 25,
	"meta":{
	}
}

##Rewrite Rules Rewrite Rules can be used to convert internal links in content into API requests.

Methods

List

Request
GET {api root}/rewrite_rules

Rewrite Rules JSON Schema

{
    "id": "#rewrite_rules",
    "description": "Rewrite Rules represent the URL structure on the hosting API site.  Providing these to the client, allows the client to override internal links with sequential API requests.",
    "type": "object",
    "properties": {
        "base_url": {
            "description": "The root URL which all rewrite rules are based.",
            "type": "string",
            "format": "uri",
            "required": true
        },
        "rewrite_rules": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "query_expression": {
                        "description": "The format string used to build the resulting query parameters for the rewrite rules from the components matched from the regex.",
                        "type": "string",
                        "required": true
                    },
                    "regex": {
                        "description": "The regular expression used to break down the requested URL into components.",
                        "type": "string",
                        "format": "regex",
                        "required": true
                    }
                }
            }


        }
    }
}
Example Rewrite Rules Response
{
	"base_url": "http://example.com/",
	"rewrite_rules": [
		{
			"regex": "category/(.+?)/?$",
			"query_expression": "category_name=$1"
		}
		….
	]
}

Media Items

Below are the schemas for media items.

Base Media Items JSON Schema

{
    "description": "Base media object",
    "id": "mediaItem",
    "type": "object",
    "properties": {
        "type": {
            "description": "The subclass of media object being represented.",
            "type": "string",
            "required": true
        }
    }

}

Internal Media Item Base JSON Schema

{
    "description": "An internal media item hosted by this WP instance that is backed by a Post Object",
    "type": "object",
    "id": "#internalMediaItem",
    "extends": {
        "$ref": "#mediaItem"
    },
    "properties": {
        "idStr": {
            "description": "The ID of the Post object representing this media attachment as a string.",
            "type": "integer",
            "required": true
        },
        "id": {
            "description": "The ID of the Post object representing this media attachment.",
            "type": "integer",
            "required": true
        },
        "mimeType": {
            "description": "The mime type of the attched media object",
            "type": "string",
            "required": true
        },
    }
}

Internal Image Media Item JSON Schema

{
    "description": "An internal image item hosted by this WP instance",
    "type": "object",
    "id": "#internalMediaItem",
    "extends": {
        "$ref": "#mediaItem"
    },
    "properties": {
        "altText": {
            "description": "The alternate text for the image.  Maps to post_meta key '_wp_attachment_image_alt'.",
            "type": "string",
            "required": false
        },
        "sizes": {
            "description": "Listing of available sizes of the image allowing the proper size to be used for the client device.",
            "type": "array",
            "required": true,
            "items": {
                "type": "object",
                "required": true,
                "properties": {
                    "height": {
                        "description": "Height of the image in pixels.",
                        "type": "integer",
                        "required": true
                    },
                    "name": {
                        "description": "The identifier for the size that generated this size of the image.",
                        "type": "string",
                        "required": true
                    },
                    "url": {
                        "description": "Full URL to the image resource.",
                        "type": "string",
                        "format": "uri",
                        "required": true
                    },
                    "width": {
                        "description": "Width of the image in pixels.",
                        "type": "integer",
                        "required": true
                    }
                }
            }


        }
    }
}

Comments

A comment represents a user response to a post

Methods

List

Request
GET {api root}/comments

GET {api root}/posts/{#post_id}/comments
Parameters

Parameter Data Type Description
Date Filters
before string A parsable formatted date string. Unless specified in the format used, the result will be relative to the timezone of the site.
after string A parsable formatted date string. Unless specified in the format used, the result will be relative to the timezone of the site.
Search Filtering
s string Search keyword or string, by default this searches against the author, author email, author url, author ip, and content. The search looks for a match to the entire search expression.
Pagination Filters
paged integer A positive integer specifiying the page (or subset of results) to return. This filter will automatically determine the offset to use based on the per_page and paged arguments. Using this filter will cause include_found to be true.
per_page integer The maximum number of posts to return. The value must range from 1 to MAX_COMMENTS_PER_PAGE.
offset integer The number of posts to skip over before returning the result set.
Ordering Parameters
orderby array|string Sort the results by the given identifier. Defaults to 'date'. Supported values are:
  • 'comment_date_gmt' - (Default) The GMT date of the post.
  • 'comment_ID' - The ID of the post.
  • 'comment_author' - The value of the author ID.
  • 'comment_date' - The date of the comment..
  • 'comment_type' - The type of comment.
  • 'comment parent'- The ID of the comment's parent
  • 'comment_post_ID' - The ID of the post which the comment belongs.
  • 'user_id' - The ID of the user making the comments.

Orderby will also accept an array of multiple identifiers.

order string The order direction. Options are 'ASC' and 'DESC'. Default is 'DESC'
General Filters
in integer|array Array of Ids of comments to include.
parent integer ID of the parent comment to pull from.
post_id integer ID of post from which to pull comments.
post_name string Slug/Name of the post from which to pull comments.
type string The type of comments to return. Default options: 'comment', 'pingback', 'trackback', 'pings' (returns trackbacks and pingbacks').
status string The status of comments to return. Default: 'approved'.
user_id int User ID of commentor making the comments.
Response Altering Parameters
include_found boolean Defaut to false. When true, the response will include a found rows count. There is some overhead in generating the total count so this should only be turned on when needed. This is automatically turned on if the 'paged' filter is used.
callback string When set, the response will be wrapped in a JSONP callback.
Response
{
	'found': 40, //only provided if include_found == true
	"comments": [
		[Comment Object],
		….
	]
}

Single Entity

Request
GET {api root}/comments/{id}
Parameters
Parameter Data Type Description
Response Altering Parameters
callback string When set, the response will be wrapped in a JSONP callback.
Comment JSON Schema
{
    "title": "Comment Object",
    "description": "A representation of a single post object",
    "type": "object",
    "id": "#comment",
    "properties": {
        "author": {
            "description": "Display name of the author of the comment.",
            "type": "string",
            "required": true
        }
        "author_url": {
            "description": "URL set for the author of the comment.",
            "type": "string",
            "required": false
        }
        "date": {
            "description": "The comment's creation time in iso 8601 format.",
            "type": "string",
            "format": "date-time",
            "required": true
        },
        "content": {
            "description": "The raw comment content.",
            "type": "string",
            "required": true
        },
        "content_display": {
            "description": "Display formatted content of the comment.",
            "type": "string",
            "required": true
        },
        "user": {
            "description": "ID of the user making the comment",
            "type": "integer",
            "required": false
        },
					"user_id_str": {
            "description": "String version of the ID of the user making the comment",
            "type": "string",
            "required": false
        },
        "id_str": {
            "description": "The ID of the post represented as a string.",
            "type": "string",
            "required": true
        },
        "id": {
            "description": "The ID of the post",
            "type": "integer",
            "minimum": 1,
            "required": true
        },
        "type": {
            "description": "The type of comment.  Deafult enum: 'comment', 'pingback', 'trackback'",
            "type": "string",
            "required": true
        },
        "media": {
            "type": "array",
            "required": false,
            "items": {
                "type": {
                    "$ref": "#mediaItem"
                }
            }
        },
        "parent_str": {
            "description": "The ID of the comment's parent as a string, if it has one.",
            "type": "string",
            "required": false
        },
        "parent": {
            "description": "The ID of the comment's parent as a string, if it has one.",
            "type": "integer",
            "required": false
        },
        "status": {
            "description": "The status of the comment.",
            "type": {
                "enum": ["approve", "pending", "spam", "trash"]
            },
            "required": true
        }
    }
}
Example Comment Response
{
    "id": 597,
    "id_str": "597",
    "type": "comment",
    "author": "John Doe",
    "author_url": "http://example.org",
    "parent": 0,
    "parent_str": "0",
    "date": "2013-06-11T18:39:46+00:00",
    "content": "This is my comment text",
    "status": "approve",
    "user": 1,
    "user_id_str": "1",
    "content_display": "<p>This is my comment text<\/p>\n",
    "avatar": [
        {
            "url": "http:\/\/1.gravatar.com\/avatar\/96614ec98aa0c0d2ee75796dced6df54?s=96&amp;d=http%3A%2F%2F1.gravatar.com%2Favatar%2Fad516503a11cd5ca435acc9bb6523536%3Fs%3D96&amp;r=G",
            "width": 96,
            "height": 96
        }
    ]
}

More Repositories

1

multi-post-thumbnails

Adds multiple post thumbnails to a post type. If you've ever wanted more than one Featured Image on a post, this plugin is for you.
PHP
144
star
2

grunt-peon-gui

Web GUI tool for running Grunt tasks
CSS
77
star
3

wp-multisite-sso

PHP
45
star
4

afterburner-ansible

Ansible Playbooks to complement afterburner.voceplatforms.com...
Shell
38
star
5

wp-large-options

PHP
34
star
6

objects-to-objects

A WordPress.com safe version of Posts2Posts
PHP
34
star
7

widget-data

WordPress Plugin - Widget Data Import/Export Settings
PHP
21
star
8

thermal-api-client

WisP: a backbone.js client for the Thermal WordPress API
CSS
20
star
9

grunt-composer

A grunt wrapper for composer
CoffeeScript
17
star
10

cms-press

WordPress Plugin
PHP
15
star
11

lift-search

Lift Search for WordPress
PHP
14
star
12

voce-settings-api

A simplification of the core WordPress settings API
PHP
13
star
13

post-type-converter

PHP
10
star
14

voce-cached-nav

Cached replacement for wp_nav_menu
PHP
7
star
15

post-selection-ui

drop-in to abstract ui to select multiple posts and put ids into an input field
PHP
7
star
16

voce-widget-cache

Caches WordPress widget output
PHP
6
star
17

wp-sphinx-search

WordPress Plugin
PHP
6
star
18

wp-dependencies

A composer package for WordPress to autoload plugin dependencies.
PHP
6
star
19

cdn-rewrite

WordPress Plugin
PHP
5
star
20

voce-post-meta

Easily create WordPress post meta groups and fields
PHP
5
star
21

wp-contextual-help

PHP
4
star
22

voce-post-pdfs

PHP
4
star
23

meta-revisions

WordPress Plugin
PHP
4
star
24

voce-performance-tools

WordPress plugin that provides numerous performance tools and functionalities to assist in developing high performance themes
PHP
4
star
25

wp-cache-bucket

A wrapper to WordPress' wp_cache to that allows tying multiple object cache entries to a single group that allows easy cache invalidation
PHP
4
star
26

memcached

Fork of Memecached Object Cache for WordPress
PHP
4
star
27

eventbrite-services

PHP
4
star
28

no-stampede-actions

WordPress drop in used to help prevent stampeding for actions that should only run once.
PHP
3
star
29

select-posts-widget

PHP
3
star
30

voce-seo

Voce Plugin - typically used as a submodule in the project's wp-content/theme/plugins/ folder
PHP
3
star
31

wp-shortcodes-api

PHP
3
star
32

wp-media-modal

JS Library to Handle post v3.5 Media Modals
JavaScript
3
star
33

wp-json-rpc

PHP
3
star
34

eventbrite-venue

CSS
3
star
35

voce-post-expiration

PHP
2
star
36

generator-voce-wp-project

A Yeoman Generator for Voce WordPress Projects
JavaScript
2
star
37

wp-short-urls

WordPress plugin for custom short URLs
PHP
2
star
38

wordpress-mu-domain-mapping

PHP
2
star
39

voce-theme-customizer

PHP
2
star
40

wp-qa-suite

Shell
2
star
41

ninja-forms-webhooks

PHP
2
star
42

wp-plugin-loader

A simplified interface to ensure that a plugin has been loaded.
PHP
1
star
43

eventbrite-event

CSS
1
star
44

event-box

JavaScript
1
star
45

wp-generate-new-image-sizes

PHP
1
star
46

site-wide-password

PHP
1
star
47

required-plugins

PHP
1
star
48

wp-nav-collapse

JS/CSS layer to make the admin of wp-nav-menus collapsible
CoffeeScript
1
star
49

voce-post-widgets

Add widgets for specific posts with the widgets UI embedded directly in the post admin screen
PHP
1
star
50

wp-cache-block

WordPress Plugin
PHP
1
star
51

view-all-pages

WordPress Plugin
PHP
1
star
52

voce-error-logging

PHP
1
star
53

memcached-redux

Mirror of https://wordpress.org/plugins/memcached-redux/ with bug fixes applied
PHP
1
star
54

lift-examples

Some examples of how to extend the functionality of Lift
PHP
1
star
55

skeletor

WordPress Shell Theme
CSS
1
star
56

wp-live-comments

PHP
1
star
57

custom-widget

PHP
1
star
58

voce-post-meta-media

Media field for Voce Post Meta plugin
PHP
1
star
59

wp-clean-chars

WordPress Plugin
PHP
1
star
60

scheduled-updates

1
star
61

author-comment-replies

Author Comment Replies WordPress Plugin
PHP
1
star
62

grunt-show-config

Output Grunt's current configuration object
JavaScript
1
star
63

voce-submenu-items

PHP
1
star
64

voce-group-keys

Voce Group Keys - create repeatable keys for use in caching
PHP
1
star