post: Create a New Blog Post
In tumblR: Access to Tumblr V2 API

Description Usage Arguments Details Value Author(s) References Examples

This function allows to create a blog post.

post(base_hostname = NA, type = "text", state = "published", tags = NA, 
tweet = NA, date = as.character(Sys.time()), format = "html", slug = NA, 
title_text = NA, body = NA, caption_photo = NA, link = NA, source_photo = NA, 
data_photo = NA, quote = NA, source_quote = NA, url_link = NA, title_link = NA, 
description = NA, title_chat = NA, conversation = NA, external_url = NA, 
data_audio = NA, caption_audio = NA, embed = NA, data_video = NA, 
caption_video = NA, token = NA, consumer_key = NA, consumer_secret = NA)

	All Post types have the following parameters:
`base_hostname`	The standard or custom blog hostname. See Details.
`type`	The type of post to create. Specify one of the following: text, photo, quote, link, chat, audio, video. The default is setted as text.
`state`	The state of the post. Specify one of the following: published, draft, queue, private. The default is setted as published.
`tags`	Comma-separated tags for this post.
`tweet`	Manages the autotweet (if enabled) for this post: set to off for no tweet, or enter text to override the default tweet.
`date`	The GMT date and time of the post, as a string.
`format`	Sets the format type of post. Supported formats are: html, markdown. The default is setted as html.
`slug`	Add a short text summary to the end of the post URL.
`token`	Represents the complete set of data needed for OAuth access: an app, an endpoint, cached credentials and parameters. See Details.
`consumer_key`	The consumer key provided by your application.
`consumer_secret`	The consumer secret provided by your application.

Text Posts

`title_text`	The optional title of the post, HTML entities must be escaped.
`body`	The full post body, HTML allowed.

Photo Posts

`caption_photo`	The user-supplied caption, HTML allowed.
`link`	The "click-through URL" for the photo.
`source_photo`	The photo source URL. (Either source_photo or data_photo)
`data_photo`	One or more image files (submit multiple times to create a slide show). (Either source_photo or data_photo)

Quote Posts

`quote`	The full text of the quote, HTML entities must be escaped.
`source_quote`	Cited source, HTML allowed.

Link Posts

`url_link`	The link.
`title_link`	The title of the page the link points to, HTML entities should be escaped.
`description`	A user-supplied description, HTML allowed.

Chat Posts

`title_chat`	The title of the chat.
`conversation`	The text of the conversation/chat, with dialogue labels (no HTML).

Audio Posts

`external_url`	The URL of the site that hosts the audio file (not tumblr). (Either external_url or data_audio)
`data_audio`	An audio file. (Either external_url or data_audio)
`caption_audio`	The user-supplied caption.

Video Posts

`embed`	HTML embed code for the video. (Either embed or data_video)
`data_video`	A video file. (Either embed or data_video)
`caption_video`	The user-supplied caption.

Each blog has a unique hostname. The hostname can be standard or custom. Standard hostname: the blog short name + .tumblr.com. Custom hostname: Anything at all, as determined by a DNS CNAME entry.

The API uses three different levels of authentication, depending on the method. None: No authentication. Anybody can query the method. API key: Requires an API key. Use your OAuth Consumer Key as your api_key. OAuth: Requires a signed request that meets the OAuth 1.0a Protocol.

The API supports the OAuth 1.0a Protocol, accepting parameters via the Authorization header, with the HMAC-SHA1 signature method only.

Returns 201: Created or an error code.

Andrea Capozio

https://www.tumblr.com/docs/en/api/v2

## Not run: 
## An example of an authenticated request using the httr package,
## where consumer_key, consumer_secret, appname are fictitious.
## You can obtain your own at https://www.tumblr.com/oauth/apps

consumer_key <-'key'
consumer_secret <- 'secret'
appname <- Tumblr_App
tokenURL <- 'https://www.tumblr.com/oauth/request_token'
accessTokenURL <- 'https://www.tumblr.com/oauth/acces_token'
authorizeURL <- 'https://www.tumblr.com/oauth/authorize'

app <- oauth_app(appname, consumer_key, consumer_secret)	
endpoint <- oauth_endpoint(tokenURL, authorizeURL, accessTokenURL)
token <- oauth1.0_token(endpoint, app)
sig <- sign_oauth1.0(app, 
token = token$credentials$oauth_token, 
token_secret = token$credentials$oauth_token_secret)	

## you must specify a real blog for base_hostname		
base_hostname <- "blogname.tumblr.com"
					
post(base_hostname = base_hostname, type = "text", tags = "tumblr, api", body = "foo", 
token = token, consumer_key = consumer_key, consumer_secret = consumer_secret)

## End(Not run)