From a9488bfaf4325b571bd999799a1a9a2e1e40941e Mon Sep 17 00:00:00 2001 From: Lee Lawlor Date: Thu, 19 Mar 2015 11:33:15 -0400 Subject: [PATCH] update outdated link for Twitter docs --- app/views/docs/thingtweet.html.erb | 69 ++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 app/views/docs/thingtweet.html.erb diff --git a/app/views/docs/thingtweet.html.erb b/app/views/docs/thingtweet.html.erb new file mode 100644 index 0000000..b845395 --- /dev/null +++ b/app/views/docs/thingtweet.html.erb @@ -0,0 +1,69 @@ +
+ +
+ <%= render 'docs/sidebar' %> +
+ +
+ +

ThingTweet

+ + The ThingTweet App allows you to update a Twitter status via ThingSpeak. Twitter requires Open Authentication (OAuth) which is difficult for a low level device to interface with. ThingTweet acts a Twitter proxy, so the device can use Twitter by making simple API calls. + +

+ +
+

App Setup

+ + Sign in to ThingSpeak, select Apps from the menu, and then click on ThingTweet. +

+ Under the ThingTweet App, select "Link new Twitter account". This will redirect you to Twitter to see if you want the app to have the ability to access your account. You can Allow or Deny the process. Once you have confirmed the right Twitter account, Twitter will send you back to ThingSpeak. +

+ The app generates a ThingTweet API Key for you to use. If you send an HTTP POST with your ThingTweet API Key, then the message will be relayed to Twitter. All of the parameters from the Twitter API (statuses/update) are possible including geolocation. +

+ +
+

Update Twitter Status

+ + To update your Twitter status send an HTTP POST to <%= @ssl_api_domain %>apps/thingtweet/1/statuses/update and include your ThingTweet API key and message. +

+ Example POST: + + 
+POST <%= @ssl_api_domain %>apps/thingtweet/1/statuses/update
+     api_key=<%= @thingtweet_api_key %>
+     status=I just posted this from my thing!
+ +
+ The response will be 1 if the update was successful, and -1 if there was an error. +

+ +

Channel Values

+ You can retrieve the last value from a Channel field by including the following in the ThingTweet status: +

+ %%channel_CHANNEL_ID_field_FIELD_NUMBER%% +

+ For example, you can send a Tweet that includes the last value from Channel 1417, field 1: +

+ status=The current CheerLights color is %%channel_1417_field_1%%. + +

+
+

Update Channel Feed and Twitter Status

+ Your Twitter status can also be updated when a Channel feed is updated by specifying the twitter and tweet parameters. +

+ Example Channel feed update that also updates a Twitter status: + +
+POST <%= @ssl_api_domain %>update.json.xml
+     api_key=XXXXXXXXXXXXXXXX
+     field1=73
+     twitter=thingspeaktest
+     tweet=I just posted this from my thing!
+
+ +











+ +
+
+