1260 lines
40 KiB
JavaScript
1260 lines
40 KiB
JavaScript
/**
|
|
* A Twitter library in JavaScript
|
|
*
|
|
* @package codebird
|
|
* @version 2.4.3
|
|
* @author J.M. <me@mynetx.net>
|
|
* @copyright 2010-2013 J.M. <me@mynetx.net>
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
/* jshint curly: true,
|
|
eqeqeq: true,
|
|
indent: 4,
|
|
latedef: true,
|
|
quotmark: double,
|
|
undef: true,
|
|
unused: true,
|
|
trailing: true,
|
|
laxbreak: true */
|
|
/* global window,
|
|
document,
|
|
navigator,
|
|
console,
|
|
XMLHttpRequest,
|
|
ActiveXObject,
|
|
b64pad: true,
|
|
b64_hmac_sha1 */
|
|
|
|
/**
|
|
* Array.indexOf polyfill
|
|
*/
|
|
if (! Array.prototype.indexOf) {
|
|
Array.prototype.indexOf = function (obj, start) {
|
|
for (var i = (start || 0); i < this.length; i++) {
|
|
if (this[i] === obj) {
|
|
return i;
|
|
}
|
|
}
|
|
return -1;
|
|
};
|
|
}
|
|
|
|
/**
|
|
* A Twitter library in JavaScript
|
|
*
|
|
* @package codebird
|
|
* @subpackage codebird-js
|
|
*/
|
|
/* jshint -W098 */
|
|
var Codebird = function () {
|
|
/* jshint +W098 */
|
|
|
|
/**
|
|
* The OAuth consumer key of your registered app
|
|
*/
|
|
var _oauth_consumer_key = null;
|
|
|
|
/**
|
|
* The corresponding consumer secret
|
|
*/
|
|
var _oauth_consumer_secret = null;
|
|
|
|
/**
|
|
* The app-only bearer token. Used to authorize app-only requests
|
|
*/
|
|
var _oauth_bearer_token = null;
|
|
|
|
/**
|
|
* The API endpoint base to use
|
|
*/
|
|
var _endpoint_base = "https://api.twitter.com/";
|
|
|
|
/**
|
|
* The API endpoint to use
|
|
*/
|
|
var _endpoint = _endpoint_base + "1.1/";
|
|
|
|
/**
|
|
* The API endpoint to use for OAuth requests
|
|
*/
|
|
var _endpoint_oauth = _endpoint_base;
|
|
|
|
/**
|
|
* API proxy endpoint
|
|
*/
|
|
var _endpoint_proxy = "https://api.jublo.net/codebird/";
|
|
|
|
/**
|
|
* Use JSONP for GET requests in IE7-9
|
|
*/
|
|
var _use_jsonp = (typeof navigator !== "undefined"
|
|
&& typeof navigator.userAgent !== "undefined"
|
|
&& (navigator.userAgent.indexOf("Trident/4") > -1
|
|
|| navigator.userAgent.indexOf("Trident/5") > -1
|
|
|| navigator.userAgent.indexOf("MSIE 7.0") > -1
|
|
)
|
|
);
|
|
|
|
/**
|
|
* Whether to access the API via a proxy that is allowed by CORS
|
|
*/
|
|
var _use_proxy = true;
|
|
|
|
/**
|
|
* The Request or access token. Used to sign requests
|
|
*/
|
|
var _oauth_token = null;
|
|
|
|
/**
|
|
* The corresponding request or access token secret
|
|
*/
|
|
var _oauth_token_secret = null;
|
|
|
|
/**
|
|
* The current Codebird version
|
|
*/
|
|
var _version = "2.4.3";
|
|
|
|
/**
|
|
* Sets the OAuth consumer key and secret (App key)
|
|
*
|
|
* @param string key OAuth consumer key
|
|
* @param string secret OAuth consumer secret
|
|
*
|
|
* @return void
|
|
*/
|
|
var setConsumerKey = function (key, secret) {
|
|
_oauth_consumer_key = key;
|
|
_oauth_consumer_secret = secret;
|
|
};
|
|
|
|
/**
|
|
* Sets the OAuth2 app-only auth bearer token
|
|
*
|
|
* @param string token OAuth2 bearer token
|
|
*
|
|
* @return void
|
|
*/
|
|
var setBearerToken = function (token) {
|
|
_oauth_bearer_token = token;
|
|
};
|
|
|
|
/**
|
|
* Gets the current Codebird version
|
|
*
|
|
* @return string The version number
|
|
*/
|
|
var getVersion = function () {
|
|
return _version;
|
|
};
|
|
|
|
/**
|
|
* Sets the OAuth request or access token and secret (User key)
|
|
*
|
|
* @param string token OAuth request or access token
|
|
* @param string secret OAuth request or access token secret
|
|
*
|
|
* @return void
|
|
*/
|
|
var setToken = function (token, secret) {
|
|
_oauth_token = token;
|
|
_oauth_token_secret = secret;
|
|
};
|
|
|
|
/**
|
|
* Enables or disables CORS proxy
|
|
*
|
|
* @param bool use_proxy Whether to use CORS proxy or not
|
|
*
|
|
* @return void
|
|
*/
|
|
var setUseProxy = function (use_proxy) {
|
|
_use_proxy = !! use_proxy;
|
|
};
|
|
|
|
/**
|
|
* Sets custom CORS proxy server
|
|
*
|
|
* @param string proxy Address of proxy server to use
|
|
*
|
|
* @return void
|
|
*/
|
|
var setProxy = function (proxy) {
|
|
// add trailing slash if missing
|
|
if (! proxy.match(/\/$/)) {
|
|
proxy += "/";
|
|
}
|
|
_endpoint_proxy = proxy;
|
|
};
|
|
|
|
/**
|
|
* Parse URL-style parameters into object
|
|
*
|
|
* @param string str String to parse
|
|
* @param array array to load data into
|
|
*
|
|
* @return object
|
|
*/
|
|
function parse_str(str, array) {
|
|
// Parses GET/POST/COOKIE data and sets global variables
|
|
//
|
|
// version: 1109.2015
|
|
// discuss at: http://phpjs.org/functions/parse_str // + original by: Cagri Ekin
|
|
// + improved by: Michael White (http://getsprink.com)
|
|
// + tweaked by: Jack
|
|
// + bugfixed by: Onno Marsman
|
|
// + reimplemented by: stag019 // + bugfixed by: Brett Zamir (http://brett-zamir.me)
|
|
// + bugfixed by: stag019
|
|
// - depends on: urldecode
|
|
// + input by: Dreamer
|
|
// + bugfixed by: Brett Zamir (http://brett-zamir.me) // % note 1: When no argument is specified, will put variables in global scope.
|
|
// * example 1: var arr = {};
|
|
// * example 1: parse_str('first=foo&second=bar', arr);
|
|
// * results 1: arr == { first: 'foo', second: 'bar' }
|
|
// * example 2: var arr = {}; // * example 2: parse_str('str_a=Jack+and+Jill+didn%27t+see+the+well.', arr);
|
|
// * results 2: arr == { str_a: "Jack and Jill didn't see the well." }
|
|
var glue1 = "=",
|
|
glue2 = "&",
|
|
array2 = String(str).replace(/^&?([\s\S]*?)&?$/, "$1").split(glue2),
|
|
i, j, chr, tmp, key, value, bracket, keys, evalStr,
|
|
fixStr = function (str) {
|
|
return decodeURIComponent(str).replace(/([\\"'])/g, "\\$1").replace(/\n/g, "\\n").replace(/\r/g, "\\r");
|
|
};
|
|
if (!array) {
|
|
array = this.window;
|
|
}
|
|
|
|
for (i = 0; i < array2.length; i++) {
|
|
tmp = array2[i].split(glue1);
|
|
if (tmp.length < 2) {
|
|
tmp = [tmp, ""];
|
|
}
|
|
key = fixStr(tmp[0]);
|
|
value = fixStr(tmp[1]);
|
|
while (key.charAt(0) === " ") {
|
|
key = key.substr(1);
|
|
}
|
|
if (key.indexOf("\0") !== -1) {
|
|
key = key.substr(0, key.indexOf("\0"));
|
|
}
|
|
if (key && key.charAt(0) !== "[") {
|
|
keys = [];
|
|
bracket = 0;
|
|
for (j = 0; j < key.length; j++) {
|
|
if (key.charAt(j) === "[" && !bracket) {
|
|
bracket = j + 1;
|
|
} else if (key.charAt(j) === "]") {
|
|
if (bracket) {
|
|
if (!keys.length) {
|
|
keys.push(key.substr(0, bracket - 1));
|
|
}
|
|
keys.push(key.substr(bracket, j - bracket));
|
|
bracket = 0;
|
|
if (key.charAt(j + 1) !== "[") {
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
if (!keys.length) {
|
|
keys = [key];
|
|
}
|
|
for (j = 0; j < keys[0].length; j++) {
|
|
chr = keys[0].charAt(j);
|
|
if (chr === " " || chr === "." || chr === "[") {
|
|
keys[0] = keys[0].substr(0, j) + "_" + keys[0].substr(j + 1);
|
|
}
|
|
if (chr === "[") {
|
|
break;
|
|
}
|
|
}
|
|
/* jshint -W061 */
|
|
evalStr = "array";
|
|
for (j = 0; j < keys.length; j++) {
|
|
key = keys[j];
|
|
if ((key !== "" && key !== " ") || j === 0) {
|
|
key = "'" + key + "'";
|
|
} else {
|
|
key = eval(evalStr + ".push([]);") - 1;
|
|
}
|
|
evalStr += "[" + key + "]";
|
|
if (j !== keys.length - 1 && eval("typeof " + evalStr) === "undefined") {
|
|
eval(evalStr + " = [];");
|
|
}
|
|
}
|
|
evalStr += " = '" + value + "';\n";
|
|
eval(evalStr);
|
|
/* jshint +W061 */
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Main API handler working on any requests you issue
|
|
*
|
|
* @param string fn The member function you called
|
|
* @param array params The parameters you sent along
|
|
* @param function callback The callback to call with the reply
|
|
* @param bool app_only_auth Whether to use app-only auth
|
|
*
|
|
* @return mixed The API reply encoded in the set return_format
|
|
*/
|
|
|
|
var __call = function (fn, params, callback, app_only_auth) {
|
|
if (typeof params === "undefined") {
|
|
params = {};
|
|
}
|
|
if (typeof app_only_auth === "undefined") {
|
|
app_only_auth = false;
|
|
}
|
|
if (typeof callback !== "function" && typeof params === "function") {
|
|
callback = params;
|
|
params = {};
|
|
if (typeof callback === "bool") {
|
|
app_only_auth = callback;
|
|
}
|
|
} else if (typeof callback === "undefined") {
|
|
callback = function () {};
|
|
}
|
|
switch (fn) {
|
|
case "oauth_authenticate":
|
|
case "oauth_authorize":
|
|
return this[fn](params, callback);
|
|
|
|
case "oauth2_token":
|
|
return this[fn](callback);
|
|
}
|
|
// reset token when requesting a new token (causes 401 for signature error on 2nd+ requests)
|
|
if (fn === "oauth_requestToken") {
|
|
setToken(null, null);
|
|
}
|
|
// parse parameters
|
|
var apiparams = {};
|
|
if (typeof params === "object") {
|
|
apiparams = params;
|
|
} else {
|
|
parse_str(params, apiparams); //TODO
|
|
}
|
|
|
|
// map function name to API method
|
|
var method = "";
|
|
var param, i, j;
|
|
|
|
// replace _ by /
|
|
var path = fn.split("_");
|
|
for (i = 0; i < path.length; i++) {
|
|
if (i > 0) {
|
|
method += "/";
|
|
}
|
|
method += path[i];
|
|
}
|
|
|
|
// undo replacement for URL parameters
|
|
var url_parameters_with_underscore = ["screen_name"];
|
|
for (i = 0; i < url_parameters_with_underscore.length; i++) {
|
|
param = url_parameters_with_underscore[i].toUpperCase();
|
|
var replacement_was = param.split("_").join("/");
|
|
method = method.split(replacement_was).join(param);
|
|
}
|
|
|
|
// replace AA by URL parameters
|
|
var method_template = method;
|
|
var match = method.match(/[A-Z_]{2,}/);
|
|
if (match) {
|
|
for (i = 0; i < match.length; i++) {
|
|
param = match[i];
|
|
var param_l = param.toLowerCase();
|
|
method_template = method_template.split(param).join(":" + param_l);
|
|
if (typeof apiparams[param_l] === "undefined") {
|
|
for (j = 0; j < 26; j++) {
|
|
method_template = method_template.split(String.fromCharCode(65 + j)).join("_" + String.fromCharCode(97 + j));
|
|
}
|
|
console.warn("To call the templated method \"" + method_template + "\", specify the parameter value for \"" + param_l + "\".");
|
|
}
|
|
method = method.split(param).join(apiparams[param_l]);
|
|
delete apiparams[param_l];
|
|
}
|
|
}
|
|
|
|
// replace A-Z by _a-z
|
|
for (i = 0; i < 26; i++) {
|
|
method = method.split(String.fromCharCode(65 + i)).join("_" + String.fromCharCode(97 + i));
|
|
method_template = method_template.split(String.fromCharCode(65 + i)).join("_" + String.fromCharCode(97 + i));
|
|
}
|
|
|
|
var httpmethod = _detectMethod(method_template, apiparams);
|
|
var multipart = _detectMultipart(method_template);
|
|
|
|
return _callApi(
|
|
httpmethod,
|
|
method,
|
|
method_template,
|
|
apiparams,
|
|
multipart,
|
|
app_only_auth,
|
|
callback
|
|
);
|
|
};
|
|
|
|
/**
|
|
* Gets the OAuth authenticate URL for the current request token
|
|
*
|
|
* @return string The OAuth authenticate URL
|
|
*/
|
|
var oauth_authenticate = function (params, callback) {
|
|
if (typeof params.force_login === "undefined") {
|
|
params.force_login = null;
|
|
}
|
|
if (typeof params.screen_name === "undefined") {
|
|
params.screen_name = null;
|
|
}
|
|
if (_oauth_token === null) {
|
|
console.warn("To get the authenticate URL, the OAuth token must be set.");
|
|
}
|
|
var url = _endpoint_oauth + "oauth/authenticate?oauth_token=" + _url(_oauth_token);
|
|
if (params.force_login === true) {
|
|
url += "?force_login=1";
|
|
if (params.screen_name !== null) {
|
|
url += "&screen_name=" + params.screen_name;
|
|
}
|
|
}
|
|
callback(url);
|
|
return true;
|
|
};
|
|
|
|
/**
|
|
* Gets the OAuth authorize URL for the current request token
|
|
*
|
|
* @return string The OAuth authorize URL
|
|
*/
|
|
var oauth_authorize = function (params, callback) {
|
|
if (typeof params.force_login === "undefined") {
|
|
params.force_login = null;
|
|
}
|
|
if (typeof params.screen_name === "undefined") {
|
|
params.screen_name = null;
|
|
}
|
|
if (_oauth_token === null) {
|
|
console.warn("To get the authorize URL, the OAuth token must be set.");
|
|
}
|
|
var url = _endpoint_oauth + "oauth/authorize?oauth_token=" + _url(_oauth_token);
|
|
if (params.force_login === true) {
|
|
url += "?force_login=1";
|
|
if (params.screen_name !== null) {
|
|
url += "&screen_name=" + params.screen_name;
|
|
}
|
|
}
|
|
callback(url);
|
|
return true;
|
|
};
|
|
|
|
/**
|
|
* Gets the OAuth bearer token
|
|
*
|
|
* @return string The OAuth bearer token
|
|
*/
|
|
|
|
var oauth2_token = function (callback) {
|
|
if (_oauth_consumer_key === null) {
|
|
console.warn("To obtain a bearer token, the consumer key must be set.");
|
|
}
|
|
|
|
if (typeof callback === "undefined") {
|
|
callback = function () {};
|
|
}
|
|
|
|
var post_fields = "grant_type=client_credentials";
|
|
var url = _endpoint_oauth + "oauth2/token";
|
|
|
|
if (_use_proxy) {
|
|
url = url.replace(
|
|
_endpoint_base,
|
|
_endpoint_proxy
|
|
);
|
|
}
|
|
|
|
var xml;
|
|
try {
|
|
xml = new XMLHttpRequest();
|
|
} catch (e) {
|
|
xml = new ActiveXObject("Microsoft.XMLHTTP");
|
|
}
|
|
xml.open("POST", url, true);
|
|
xml.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
|
|
xml.setRequestHeader(
|
|
(_use_proxy ? "X-" : "") + "Authorization",
|
|
"Basic " + base64_encode(_oauth_consumer_key + ":" + _oauth_consumer_secret)
|
|
);
|
|
|
|
xml.onreadystatechange = function () {
|
|
if (xml.readyState >= 4) {
|
|
var httpstatus = 12027;
|
|
try {
|
|
httpstatus = xml.status;
|
|
} catch (e) {}
|
|
var reply = _parseApiReply("oauth2/token", xml.responseText);
|
|
reply.httpstatus = httpstatus;
|
|
if (httpstatus === 200) {
|
|
setBearerToken(reply.access_token);
|
|
}
|
|
callback(reply);
|
|
}
|
|
};
|
|
xml.send(post_fields);
|
|
|
|
};
|
|
|
|
/**
|
|
* Signing helpers
|
|
*/
|
|
|
|
/**
|
|
* URL-encodes the given data
|
|
*
|
|
* @param mixed data
|
|
*
|
|
* @return mixed The encoded data
|
|
*/
|
|
var _url = function (data) {
|
|
if (typeof data === "array") {
|
|
/*
|
|
return array_map(
|
|
[ // TODO
|
|
this, "_url"
|
|
],
|
|
data
|
|
);
|
|
*/
|
|
} else if ((/boolean|number|string/).test(typeof data)) {
|
|
return encodeURIComponent(data).replace(/!/g, "%21").replace(/'/g, "%27").replace(/\(/g, "%28").replace(/\)/g, "%29").replace(/\*/g, "%2A");
|
|
} else {
|
|
return "";
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Gets the base64-encoded SHA1 hash for the given data
|
|
*
|
|
* @param string data The data to calculate the hash from
|
|
*
|
|
* @return string The hash
|
|
*/
|
|
var _sha1 = function (data) {
|
|
if (_oauth_consumer_secret === null) {
|
|
console.warn("To generate a hash, the consumer secret must be set.");
|
|
}
|
|
if (typeof b64_hmac_sha1 !== "function") {
|
|
console.warn("To generate a hash, the Javascript SHA1.js must be available.");
|
|
}
|
|
/*jshint -W020 */
|
|
b64pad = "=";
|
|
/*jshint +W020 */
|
|
return b64_hmac_sha1(_oauth_consumer_secret + "&" + (_oauth_token_secret !== null ? _oauth_token_secret : ""), data);
|
|
};
|
|
|
|
var base64_encode = function (data) {
|
|
// http://kevin.vanzonneveld.net
|
|
// + original by: Tyler Akins (http://rumkin.com)
|
|
// + improved by: Bayron Guevara
|
|
// + improved by: Thunder.m
|
|
// + improved by: Kevin van Zonneveld (http://kevin.vanzonneveld.net)
|
|
// + bugfixed by: Pellentesque Malesuada
|
|
// + improved by: Kevin van Zonneveld (http://kevin.vanzonneveld.net)
|
|
// + improved by: Rafał Kukawski (http://kukawski.pl)
|
|
// * example 1: base64_encode('Kevin van Zonneveld');
|
|
// * returns 1: 'S2V2aW4gdmFuIFpvbm5ldmVsZA=='
|
|
// mozilla has this native
|
|
// - but breaks in 2.0.0.12!
|
|
//if (typeof this.window['btoa'] == 'function') {
|
|
// return btoa(data);
|
|
//}
|
|
var b64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=";
|
|
var o1, o2, o3, h1, h2, h3, h4, bits, i = 0,
|
|
ac = 0,
|
|
enc = "",
|
|
tmp_arr = [];
|
|
|
|
if (! data) {
|
|
return data;
|
|
}
|
|
|
|
do { // pack three octets into four hexets
|
|
o1 = data.charCodeAt(i++);
|
|
o2 = data.charCodeAt(i++);
|
|
o3 = data.charCodeAt(i++);
|
|
|
|
bits = o1 << 16 | o2 << 8 | o3;
|
|
|
|
h1 = bits >> 18 & 0x3f;
|
|
h2 = bits >> 12 & 0x3f;
|
|
h3 = bits >> 6 & 0x3f;
|
|
h4 = bits & 0x3f;
|
|
|
|
// use hexets to index into b64, and append result to encoded string
|
|
tmp_arr[ac++] = b64.charAt(h1) + b64.charAt(h2) + b64.charAt(h3) + b64.charAt(h4);
|
|
} while (i < data.length);
|
|
|
|
enc = tmp_arr.join("");
|
|
|
|
var r = data.length % 3;
|
|
|
|
return (r ? enc.slice(0, r - 3) : enc) + "===".slice(r || 3);
|
|
};
|
|
|
|
var http_build_query = function (formdata, numeric_prefix, arg_separator) {
|
|
// http://kevin.vanzonneveld.net
|
|
// + original by: Kevin van Zonneveld (http://kevin.vanzonneveld.net)
|
|
// + improved by: Legaev Andrey
|
|
// + improved by: Michael White (http://getsprink.com)
|
|
// + improved by: Kevin van Zonneveld (http://kevin.vanzonneveld.net)
|
|
// + improved by: Brett Zamir (http://brett-zamir.me)
|
|
// + revised by: stag019
|
|
// + input by: Dreamer
|
|
// + bugfixed by: Brett Zamir (http://brett-zamir.me)
|
|
// + bugfixed by: MIO_KODUKI (http://mio-koduki.blogspot.com/)
|
|
// % note 1: If the value is null, key and value is skipped in http_build_query of PHP. But, phpjs is not.
|
|
var value, key, tmp = [];
|
|
|
|
var _http_build_query_helper = function (key, val, arg_separator) {
|
|
var k, tmp = [];
|
|
if (val === true) {
|
|
val = "1";
|
|
} else if (val === false) {
|
|
val = "0";
|
|
}
|
|
if (val !== null) {
|
|
if(typeof(val) === "object") {
|
|
for (k in val) {
|
|
if (val[k] !== null) {
|
|
tmp.push(_http_build_query_helper(key + "[" + k + "]", val[k], arg_separator));
|
|
}
|
|
}
|
|
return tmp.join(arg_separator);
|
|
} else if (typeof(val) !== "function") {
|
|
return _url(key) + "=" + _url(val);
|
|
} else {
|
|
throw new Error("There was an error processing for http_build_query().");
|
|
}
|
|
} else {
|
|
return "";
|
|
}
|
|
};
|
|
|
|
if (!arg_separator) {
|
|
arg_separator = "&";
|
|
}
|
|
for (key in formdata) {
|
|
value = formdata[key];
|
|
if (numeric_prefix && !isNaN(key)) {
|
|
key = String(numeric_prefix) + key;
|
|
}
|
|
var query=_http_build_query_helper(key, value, arg_separator);
|
|
if(query !== "") {
|
|
tmp.push(query);
|
|
}
|
|
}
|
|
|
|
return tmp.join(arg_separator);
|
|
};
|
|
|
|
/**
|
|
* Generates a (hopefully) unique random string
|
|
*
|
|
* @param int optional length The length of the string to generate
|
|
*
|
|
* @return string The random string
|
|
*/
|
|
var _nonce = function (length) {
|
|
if (typeof length === "undefined") {
|
|
length = 8;
|
|
}
|
|
if (length < 1) {
|
|
console.warn("Invalid nonce length.");
|
|
}
|
|
var nonce = "";
|
|
for (var i = 0; i < length; i++) {
|
|
var character = Math.floor(Math.random() * 61);
|
|
nonce += "0123456789ABCDEFGHIJKLMNOPQRSTUVWXTZabcdefghiklmnopqrstuvwxyz".substring(character, character + 1);
|
|
}
|
|
return nonce;
|
|
};
|
|
|
|
var _ksort = function (inputArr) {
|
|
var keys = [], sorter, k;
|
|
|
|
sorter = function (a, b) {
|
|
var aFloat = parseFloat(a),
|
|
bFloat = parseFloat(b),
|
|
aNumeric = aFloat + "" === a,
|
|
bNumeric = bFloat + "" === b;
|
|
if (aNumeric && bNumeric) {
|
|
return aFloat > bFloat ? 1 : aFloat < bFloat ? -1 : 0;
|
|
} else if (aNumeric && !bNumeric) {
|
|
return 1;
|
|
} else if (!aNumeric && bNumeric) {
|
|
return -1;
|
|
}
|
|
return a > b ? 1 : a < b ? -1 : 0;
|
|
};
|
|
|
|
// Make a list of key names
|
|
for (k in inputArr) {
|
|
if (inputArr.hasOwnProperty(k)) {
|
|
keys.push(k);
|
|
}
|
|
}
|
|
keys.sort(sorter);
|
|
return keys;
|
|
};
|
|
|
|
/**
|
|
* Clone objects
|
|
*
|
|
* @param object obj The object to clone
|
|
*
|
|
* @return object clone The cloned object
|
|
*/
|
|
var _clone = function (obj) {
|
|
var clone = {};
|
|
for (var i in obj) {
|
|
if (typeof(obj[i]) === "object") {
|
|
clone[i] = clone(obj[i]);
|
|
} else {
|
|
clone[i] = obj[i];
|
|
}
|
|
}
|
|
return clone;
|
|
};
|
|
|
|
/**
|
|
* Generates an OAuth signature
|
|
*
|
|
* @param string httpmethod Usually either 'GET' or 'POST' or 'DELETE'
|
|
* @param string method The API method to call
|
|
* @param array optional params The API call parameters, associative
|
|
* @param bool optional append_to_get Whether to append the OAuth params to GET
|
|
*
|
|
* @return string Authorization HTTP header
|
|
*/
|
|
var _sign = function (httpmethod, method, params, append_to_get) {
|
|
if (typeof params === "undefined") {
|
|
params = {};
|
|
}
|
|
if (typeof append_to_get === "undefined") {
|
|
append_to_get = false;
|
|
}
|
|
if (_oauth_consumer_key === null) {
|
|
console.warn("To generate a signature, the consumer key must be set.");
|
|
}
|
|
var sign_params = {
|
|
consumer_key: _oauth_consumer_key,
|
|
version: "1.0",
|
|
timestamp: Math.round(new Date().getTime() / 1000),
|
|
nonce: _nonce(),
|
|
signature_method: "HMAC-SHA1"
|
|
};
|
|
var sign_base_params = {};
|
|
var value;
|
|
for (var key in sign_params) {
|
|
value = sign_params[key];
|
|
sign_base_params["oauth_" + key] = _url(value);
|
|
}
|
|
if (_oauth_token !== null) {
|
|
sign_base_params.oauth_token = _url(_oauth_token);
|
|
}
|
|
var oauth_params = _clone(sign_base_params);
|
|
for (key in params) {
|
|
value = params[key];
|
|
sign_base_params[key] = value;
|
|
}
|
|
var keys = _ksort(sign_base_params);
|
|
var sign_base_string = "";
|
|
for (var i = 0; i < keys.length; i++) {
|
|
key = keys[i];
|
|
value = sign_base_params[key];
|
|
sign_base_string += key + "=" + _url(value) + "&";
|
|
}
|
|
sign_base_string = sign_base_string.substring(0, sign_base_string.length - 1);
|
|
var signature = _sha1(httpmethod + "&" + _url(method) + "&" + _url(sign_base_string));
|
|
|
|
params = append_to_get ? sign_base_params : oauth_params;
|
|
params.oauth_signature = signature;
|
|
keys = _ksort(params);
|
|
var authorization = "";
|
|
if (append_to_get) {
|
|
for(i = 0; i < keys.length; i++) {
|
|
key = keys[i];
|
|
value = params[key];
|
|
authorization += key + "=" + _url(value) + "&";
|
|
}
|
|
return authorization.substring(0, authorization.length - 1);
|
|
}
|
|
authorization = "OAuth ";
|
|
for (i = 0; i < keys.length; i++) {
|
|
key = keys[i];
|
|
value = params[key];
|
|
authorization += key + "=\"" + _url(value) + "\", ";
|
|
}
|
|
return authorization.substring(0, authorization.length - 2);
|
|
};
|
|
|
|
/**
|
|
* Detects HTTP method to use for API call
|
|
*
|
|
* @param string method The API method to call
|
|
* @param array params The parameters to send along
|
|
*
|
|
* @return string The HTTP method that should be used
|
|
*/
|
|
var _detectMethod = function (method, params) {
|
|
// multi-HTTP method endpoints
|
|
switch(method) {
|
|
case "account/settings":
|
|
method = params.length ? method + "__post" : method;
|
|
break;
|
|
}
|
|
|
|
var httpmethods = {};
|
|
httpmethods.GET = [
|
|
// Timelines
|
|
"statuses/mentions_timeline",
|
|
"statuses/user_timeline",
|
|
"statuses/home_timeline",
|
|
"statuses/retweets_of_me",
|
|
|
|
// Tweets
|
|
"statuses/retweets/:id",
|
|
"statuses/show/:id",
|
|
"statuses/oembed",
|
|
|
|
// Search
|
|
"search/tweets",
|
|
|
|
// Direct Messages
|
|
"direct_messages",
|
|
"direct_messages/sent",
|
|
"direct_messages/show",
|
|
|
|
// Friends & Followers
|
|
"friendships/no_retweets/ids",
|
|
"friends/ids",
|
|
"followers/ids",
|
|
"friendships/lookup",
|
|
"friendships/incoming",
|
|
"friendships/outgoing",
|
|
"friendships/show",
|
|
"friends/list",
|
|
"followers/list",
|
|
|
|
// Users
|
|
"account/settings",
|
|
"account/verify_credentials",
|
|
"blocks/list",
|
|
"blocks/ids",
|
|
"users/lookup",
|
|
"users/show",
|
|
"users/search",
|
|
"users/contributees",
|
|
"users/contributors",
|
|
"users/profile_banner",
|
|
|
|
// Suggested Users
|
|
"users/suggestions/:slug",
|
|
"users/suggestions",
|
|
"users/suggestions/:slug/members",
|
|
|
|
// Favorites
|
|
"favorites/list",
|
|
|
|
// Lists
|
|
"lists/list",
|
|
"lists/statuses",
|
|
"lists/memberships",
|
|
"lists/subscribers",
|
|
"lists/subscribers/show",
|
|
"lists/members/show",
|
|
"lists/members",
|
|
"lists/show",
|
|
"lists/subscriptions",
|
|
|
|
// Saved searches
|
|
"saved_searches/list",
|
|
"saved_searches/show/:id",
|
|
|
|
// Places & Geo
|
|
"geo/id/:place_id",
|
|
"geo/reverse_geocode",
|
|
"geo/search",
|
|
"geo/similar_places",
|
|
|
|
// Trends
|
|
"trends/place",
|
|
"trends/available",
|
|
"trends/closest",
|
|
|
|
// OAuth
|
|
"oauth/authenticate",
|
|
"oauth/authorize",
|
|
|
|
// Help
|
|
"help/configuration",
|
|
"help/languages",
|
|
"help/privacy",
|
|
"help/tos",
|
|
"application/rate_limit_status"
|
|
];
|
|
httpmethods.POST = [
|
|
// Tweets
|
|
"statuses/destroy/:id",
|
|
"statuses/update",
|
|
"statuses/retweet/:id",
|
|
"statuses/update_with_media",
|
|
|
|
// Direct Messages
|
|
"direct_messages/destroy",
|
|
"direct_messages/new",
|
|
|
|
// Friends & Followers
|
|
"friendships/create",
|
|
"friendships/destroy",
|
|
"friendships/update",
|
|
|
|
// Users
|
|
"account/settings__post",
|
|
"account/update_delivery_device",
|
|
"account/update_profile",
|
|
"account/update_profile_background_image",
|
|
"account/update_profile_colors",
|
|
"account/update_profile_image",
|
|
"blocks/create",
|
|
"blocks/destroy",
|
|
"account/update_profile_banner",
|
|
"account/remove_profile_banner",
|
|
|
|
// Favorites
|
|
"favorites/destroy",
|
|
"favorites/create",
|
|
|
|
// Lists
|
|
"lists/members/destroy",
|
|
"lists/subscribers/create",
|
|
"lists/subscribers/destroy",
|
|
"lists/members/create_all",
|
|
"lists/members/create",
|
|
"lists/destroy",
|
|
"lists/update",
|
|
"lists/create",
|
|
"lists/members/destroy_all",
|
|
|
|
// Saved Searches
|
|
"saved_searches/create",
|
|
"saved_searches/destroy/:id",
|
|
|
|
// Places & Geo
|
|
"geo/place",
|
|
|
|
// Spam Reporting
|
|
"users/report_spam",
|
|
|
|
// OAuth
|
|
"oauth/access_token",
|
|
"oauth/request_token",
|
|
"oauth2/token",
|
|
"oauth2/invalidate_token"
|
|
];
|
|
for (var httpmethod in httpmethods) {
|
|
if (httpmethods[httpmethod].indexOf(method) > -1) {
|
|
return httpmethod;
|
|
}
|
|
}
|
|
console.warn("Can't find HTTP method to use for \"" + method + "\".");
|
|
};
|
|
|
|
/**
|
|
* Detects if API call should use multipart/form-data
|
|
*
|
|
* @param string method The API method to call
|
|
*
|
|
* @return bool Whether the method should be sent as multipart
|
|
*/
|
|
var _detectMultipart = function (method) {
|
|
var multiparts = [
|
|
// Tweets
|
|
"statuses/update_with_media",
|
|
|
|
// Users
|
|
"account/update_profile_background_image",
|
|
"account/update_profile_image",
|
|
"account/update_profile_banner"
|
|
];
|
|
return multiparts.indexOf(method) > -1;
|
|
};
|
|
|
|
/**
|
|
* Build multipart request from upload params
|
|
*
|
|
* @param string method The API method to call
|
|
* @param array params The parameters to send along
|
|
*
|
|
* @return string The built multipart request body
|
|
*/
|
|
var _buildMultipart = function (method, params) {
|
|
// well, files will only work in multipart methods
|
|
if (! _detectMultipart(method)) {
|
|
return;
|
|
}
|
|
|
|
// only check specific parameters
|
|
var possible_methods = [
|
|
// Tweets
|
|
"statuses/update_with_media",
|
|
// Accounts
|
|
"account/update_profile_background_image",
|
|
"account/update_profile_image",
|
|
"account/update_profile_banner"
|
|
];
|
|
var possible_files = {
|
|
// Tweets
|
|
"statuses/update_with_media": "media[]",
|
|
// Accounts
|
|
"account/update_profile_background_image": "image",
|
|
"account/update_profile_image": "image",
|
|
"account/update_profile_banner": "banner"
|
|
};
|
|
// method might have files?
|
|
if (possible_methods.indexOf(method) === -1) {
|
|
return;
|
|
}
|
|
|
|
// check for filenames
|
|
possible_files = possible_files[method].split(" ");
|
|
|
|
var multipart_border = "--------------------" + _nonce();
|
|
var multipart_request = "";
|
|
for (var key in params) {
|
|
multipart_request +=
|
|
"--" + multipart_border + "\r\n"
|
|
+ "Content-Disposition: form-data; name=\"" + key + "\"";
|
|
if (possible_files.indexOf(key) > -1) {
|
|
multipart_request +=
|
|
"\r\nContent-Transfer-Encoding: base64";
|
|
}
|
|
multipart_request +=
|
|
"\r\n\r\n" + params[key] + "\r\n";
|
|
}
|
|
multipart_request += "--" + multipart_border + "--";
|
|
return multipart_request;
|
|
};
|
|
|
|
/**
|
|
* Builds the complete API endpoint url
|
|
*
|
|
* @param string method The API method to call
|
|
*
|
|
* @return string The URL to send the request to
|
|
*/
|
|
var _getEndpoint = function (method) {
|
|
var url;
|
|
if (method.substring(0, 5) === "oauth") {
|
|
url = _endpoint_oauth + method;
|
|
} else {
|
|
url = _endpoint + method + ".json";
|
|
}
|
|
return url;
|
|
};
|
|
|
|
/**
|
|
* Calls the API using cURL
|
|
*
|
|
* @param string httpmethod The HTTP method to use for making the request
|
|
* @param string method The API method to call
|
|
* @param string method_template The templated API method to call
|
|
* @param array optional params The parameters to send along
|
|
* @param bool optional multipart Whether to use multipart/form-data
|
|
* @param bool optional $app_only_auth Whether to use app-only bearer authentication
|
|
* @param function callback The function to call with the API call result
|
|
*
|
|
* @return mixed The API reply, encoded in the set return_format
|
|
*/
|
|
|
|
var _callApi = function (httpmethod, method, method_template, params, multipart, app_only_auth, callback) {
|
|
if (typeof params === "undefined") {
|
|
params = {};
|
|
}
|
|
if (typeof multipart === "undefined") {
|
|
multipart = false;
|
|
}
|
|
if (typeof app_only_auth === "undefined") {
|
|
app_only_auth = false;
|
|
}
|
|
if (typeof callback !== "function") {
|
|
callback = function () {};
|
|
}
|
|
|
|
var url = _getEndpoint(method);
|
|
var authorization = null;
|
|
|
|
var xml, post_fields;
|
|
try {
|
|
xml = new XMLHttpRequest();
|
|
} catch (e) {
|
|
xml = new ActiveXObject("Microsoft.XMLHTTP");
|
|
}
|
|
if (httpmethod === "GET") {
|
|
var url_with_params = url;
|
|
if (JSON.stringify(params) !== "{}") {
|
|
url_with_params += "?" + http_build_query(params);
|
|
}
|
|
authorization = _sign(httpmethod, url, params);
|
|
|
|
// append auth params to GET url for IE7-9, to send via JSONP
|
|
if (_use_jsonp) {
|
|
if (JSON.stringify(params) !== "{}") {
|
|
url_with_params += "&";
|
|
} else {
|
|
url_with_params += "?";
|
|
}
|
|
var callback_name = _nonce();
|
|
window[callback_name] = function (reply) {
|
|
reply.httpstatus = 200;
|
|
callback(reply);
|
|
};
|
|
params.callback = callback_name;
|
|
url_with_params = url + "?" + _sign(httpmethod, url, params, true);
|
|
var tag = document.createElement("script");
|
|
tag.type = "text/javascript";
|
|
tag.src = url_with_params;
|
|
var body = document.getElementsByTagName("body")[0];
|
|
body.appendChild(tag);
|
|
return;
|
|
|
|
} else if (_use_proxy) {
|
|
url_with_params = url_with_params.replace(
|
|
_endpoint_base,
|
|
_endpoint_proxy
|
|
);
|
|
}
|
|
xml.open(httpmethod, url_with_params, true);
|
|
} else {
|
|
if (_use_jsonp) {
|
|
console.warn("Sending POST requests is not supported for IE7-9.");
|
|
return;
|
|
}
|
|
if (multipart) {
|
|
authorization = _sign(httpmethod, url, {});
|
|
params = _buildMultipart(method, params);
|
|
} else {
|
|
authorization = _sign(httpmethod, url, params);
|
|
params = http_build_query(params);
|
|
}
|
|
post_fields = params;
|
|
if (_use_proxy || multipart) { // force proxy for multipart base64
|
|
url = url.replace(
|
|
_endpoint_base,
|
|
_endpoint_proxy
|
|
);
|
|
}
|
|
xml.open(httpmethod, url, true);
|
|
if (multipart) {
|
|
xml.setRequestHeader("Content-Type", "multipart/form-data; boundary="
|
|
+ post_fields.split("\r\n")[0].substring(2));
|
|
} else {
|
|
xml.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
|
|
}
|
|
}
|
|
if (app_only_auth) {
|
|
if (_oauth_consumer_key === null) {
|
|
console.warn("To make an app-only auth API request, the consumer key must be set.");
|
|
}
|
|
// automatically fetch bearer token, if necessary
|
|
if (_oauth_bearer_token === null) {
|
|
return oauth2_token(function () {
|
|
_callApi(httpmethod, method, method_template, params, multipart, app_only_auth, callback);
|
|
});
|
|
}
|
|
authorization = "Bearer " + _oauth_bearer_token;
|
|
}
|
|
if (authorization !== null) {
|
|
xml.setRequestHeader((_use_proxy ? "X-" : "") + "Authorization", authorization);
|
|
}
|
|
xml.onreadystatechange = function () {
|
|
if (xml.readyState >= 4) {
|
|
var httpstatus = 12027;
|
|
try {
|
|
httpstatus = xml.status;
|
|
} catch (e) {}
|
|
var reply = _parseApiReply(method_template, xml.responseText);
|
|
reply.httpstatus = httpstatus;
|
|
callback(reply);
|
|
}
|
|
};
|
|
xml.send(httpmethod === "GET" ? null : post_fields);
|
|
return true;
|
|
};
|
|
|
|
/**
|
|
* Parses the API reply to encode it in the set return_format
|
|
*
|
|
* @param string method The method that has been called
|
|
* @param string reply The actual reply, JSON-encoded or URL-encoded
|
|
*
|
|
* @return array|object The parsed reply
|
|
*/
|
|
var _parseApiReply = function (method, reply) {
|
|
if (reply === "[]") {
|
|
return [];
|
|
}
|
|
var parsed = false;
|
|
try {
|
|
parsed = JSON.parse(reply);
|
|
} catch (e) {
|
|
parsed = {};
|
|
if (reply.indexOf("<" + "?xml version=\"1.0\" encoding=\"UTF-8\"?" + ">") === 0) {
|
|
// we received XML...
|
|
// since this only happens for errors,
|
|
// don't perform a full decoding
|
|
parsed.request = reply.match(/<request>(.*)<\/request>/)[1];
|
|
parsed.error = reply.match(/<error>(.*)<\/error>/)[1];
|
|
} else {
|
|
// assume query format
|
|
var elements = reply.split("&");
|
|
for (var i = 0; i < elements.length; i++) {
|
|
var element = elements[i].split("=", 2);
|
|
if (element.length > 1) {
|
|
parsed[element[0]] = decodeURIComponent(element[1]);
|
|
} else {
|
|
parsed[element[0]] = null;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return parsed;
|
|
};
|
|
|
|
return {
|
|
setConsumerKey: setConsumerKey,
|
|
getVersion: getVersion,
|
|
setToken: setToken,
|
|
setBearerToken: setBearerToken,
|
|
setUseProxy: setUseProxy,
|
|
setProxy: setProxy,
|
|
__call: __call,
|
|
oauth_authenticate: oauth_authenticate,
|
|
oauth_authorize: oauth_authorize,
|
|
oauth2_token: oauth2_token
|
|
};
|
|
};
|