]> git.mxchange.org Git - friendica.git/blobdiff - include/api.php
basic file upload/attach
[friendica.git] / include / api.php
index dadd33d455d17565cf97d2905ed47b118dc3f01f..84cb7b38f623e70e9a7f6a6f8273d230ddbc5965 100644 (file)
@@ -9,76 +9,7 @@
 
        $API = Array();
         
-       class XMLSerializer {
-       
-           // functions adopted from http://www.sean-barton.co.uk/2009/03/turning-an-array-or-object-into-xml-using-php/
-       
-           public static function generateValidXmlFromObj(stdClass $obj, $node_block='nodes', $node_name='node') {
-               $arr = get_object_vars($obj);
-               return self::generateValidXmlFromArray($arr, $node_block, $node_name);
-           }
-       
-           public static function generateValidXmlFromArray($array, $node_block='nodes', $node_name='node') {
-                       $attrs="";
-                       if ($array instanceof Container){
-                               $node_block=$array->name;
-                               foreach($array->attrs as $n=>$v){
-                                       $attrs .= " $n='$v'";
-                               }
-                       }
-       
-       
-               $xml = '<?xml version="1.0" encoding="UTF-8" ?>';
-       
-               $xml .= '<' . $node_block . $attrs. '>';
-               $xml .= self::generateXmlFromArray($array, $node_name);
-               $xml .= '</' . $node_block . '>';
-       
-               return $xml;
-           }
-       
-           private static function generateXmlFromArray($array, $node_name) {
-               $xml = '';
-                               
-               if (is_array($array) || is_object($array)) {
-                   foreach ($array as $key=>$value) {
-                       $attrs="";
-                                       if ($value instanceof Container){
-                                               $node_name=$value->name;
-                                               foreach($value->attrs as $n=>$v){
-                                                       $attrs .= " $n='$v'";
-                                               }
-                                       }                               
-                       if (is_numeric($key)) {
-                           $key = $node_name;
-                       }
-       
-       
-                       $xml .= '<' . $key . $attrs.'>' . self::generateXmlFromArray($value, $node_name) . '</' . $key . '>';
-                   }
-               } else {
-                       if (is_bool($array)) $array = ($array===true?"true":"false");
-                   $xml = htmlspecialchars($array, ENT_QUOTES);
-               }
-       
-               return $xml;
-           }
-       
-       }
-       
-       // this is used when json and xml are not translatable to arrays
-       // like [{text:'text'},{text:'text2'}]
-       //      and     <statuses type='array'><status><text>text</text></status><status><text>text2</text></status></statuses>
-       class Container extends ArrayObject{
-               public $name;
-               public $attrs=Array();
-               function __construct($name){
-                       $this->name = $name;
-                       $args = func_get_args();
-                       unset($args[0]);
-                       call_user_func_array(array(parent,'__construct'), $args);
-               }
-       }
+
        
        function api_date($str){
                //Wed May 23 06:01:13 +0000 2007
@@ -89,7 +20,7 @@
        function api_register_func($path, $func, $auth=false){
                global $API;
                $API[$path] = array('func'=>$func,
-                                                       'auth'=>auth);
+                                                       'auth'=>$auth);
        }
        
        /**
                $encrypted = hash('whirlpool',trim($_SERVER['PHP_AUTH_PW']));
                
                
-                       // da auth.php
-               
+                       /**
+                        *  next code from mod/auth.php. needs better solution
+                        */
+                       
                // process normal login request
 
                $r = q("SELECT * FROM `user` WHERE ( `email` = '%s' OR `nickname` = '%s' ) 
                        dbesc(trim($user)),
                        dbesc($encrypted)
                );
-               if(count($r))
+               if(count($r)){
                        $record = $r[0];
+               } else {
+                   header('WWW-Authenticate: Basic realm="Friendika"');
+                   header('HTTP/1.0 401 Unauthorized');
+                   die('This api require login');
+               }
                $_SESSION['uid'] = $record['uid'];
                $_SESSION['theme'] = $record['theme'];
                $_SESSION['authenticated'] = 1;
                $_SESSION['my_url'] = $a->get_baseurl() . '/profile/' . $record['nickname'];
                $_SESSION['addr'] = $_SERVER['REMOTE_ADDR'];
 
-               notice( t("Welcome back ") . $record['username'] . EOL);
+               //notice( t("Welcome back ") . $record['username'] . EOL);
                $a->user = $record;
 
                if(strlen($a->user['timezone'])) {
                header('X-Account-Management-Status: active; name="' . $a->user['username'] . '"; id="' . $a->user['nickname'] .'"');
        }
        
+       /**************************
+        *  MAIN API ENTRY POINT  *
+        **************************/
        function api_call(&$a){
                GLOBAL $API;
                foreach ($API as $p=>$info){
                        if (strpos($a->query_string, $p)===0){
-                               if ($info['auth']===true) api_login($a);
-                               
-                               $r = call_user_func($info['func'], $a);
-                               if ($r===false) return;
-                               
-                               if ($r instanceof Container){
-                                       $name=NULL; $values=$r;
-                               } else {                                                
-                                       foreach($r as $name=>$values){}
+                               #unset($_SERVER['PHP_AUTH_USER']);
+                               if ($info['auth']===true && local_user()===false) {
+                                               api_login($a);
                                }
+               
+                               $type="json";           
+                               if (strpos($a->query_string, ".xml")>0) $type="xml";
+                               if (strpos($a->query_string, ".json")>0) $type="json";
+                               if (strpos($a->query_string, ".rss")>0) $type="rss";
+                               if (strpos($a->query_string, ".atom")>0) $type="atom";                          
                                
-                               // return xml
-                               if (strpos($a->query_string, ".xml")>0){
-                                       return XMLSerializer::generateValidXmlFromArray($values, $name);
-                               }
-                               // return json
-                               if (strpos($a->query_string, ".json")>0){
-                                       if ($values instanceof Container) $values= iterator_to_array($values);
-                                       return json_encode($values);
+                               $r = call_user_func($info['func'], $a, $type);
+                               if ($r===false) return;
+
+                               switch($type){
+                                       case "xml":
+                                               $r = mb_convert_encoding($r, "UTF-8",mb_detect_encoding($r));
+                                               header ("Content-Type: text/xml");
+                                               return '<?xml version="1.0" encoding="UTF-8"?>'."\n".$r;
+                                               break;
+                                       case "json": 
+                                               header ("Content-Type: application/json");  
+                                               return json_encode($r);
+                                               break;
+                                       case "rss":
+                                               header ("Content-Type: application/rss+xml");
+                                               return '<?xml version="1.0" encoding="UTF-8"?>'."\n".$r;
+                                               break;
+                                       case "atom":
+                                               #header ("Content-Type: application/atom+xml");
+                                               return '<?xml version="1.0" encoding="UTF-8"?>'."\n".$r;
+                                               break;
+                                               
                                }
                                //echo "<pre>"; var_dump($r); die();
                        }
                }
                return false;
        }
-       
-               
+
        /**
-        * Returns extended information of a given user, specified by ID or screen name as per the required id parameter.
-        * The author's most recent status will be returned inline.
-        * http://developer.twitter.com/doc/get/users/show
+        * RSS extra info
         */
-       function api_users_show(&$a){
+       function api_rss_extra(&$a, $arr, $user_info){
+               if (is_null($user_info)) $user_info = api_get_user($a);
+               $arr['$rss'] = array(
+                       'alternate' => $user_info['url'],
+                       'self' => $a->get_baseurl(). "/". $a->query_string,
+                       'updated' => api_date(null),
+                       'language' => $user_info['language'],
+                       'logo'  => $a->get_baseurl()."/images/friendika-32.png",
+               );
                
+               return $arr;
+       }
+        
+       /**
+        * Returns user info array.
+        */
+       function api_get_user(&$a){
                $user = null;
                $extra_query = "";
                if(x($_GET, 'user_id')) {
                        $user = intval($_GET['user_id']);       
-                       $extra_query = "AND `user`.`uid` = %d ";
+                       $extra_query = "AND `contact`.`id` = %d ";
                }
                if(x($_GET, 'screen_name')) {
                        $user = dbesc($_GET['screen_name']);    
-                       $extra_query = "AND `user`.`nickname` = '%s' ";
+                       $extra_query = "AND `contact`.`nick` = '%s' ";
                }
                
                if ($user===null){
                        list($user, $null) = explode(".",$a->argv[3]);
                        if(is_numeric($user)){
                                $user = intval($user);
-                               $extra_query = "AND `user`.`uid` = %d ";
+                               $extra_query = "AND `contact`.`id` = %d ";
                        } else {
                                $user = dbesc($user);
-                               $extra_query = "AND `user`.`nickname` = '%s' ";
+                               $extra_query = "AND `contact`.`nick` = '%s' ";
                        }
                }
                
                if ($user==='') {
-                       return False;
+                       if (local_user()===false) {
+                               api_login($a); return False;
+                       } else {
+                               $user = $_SESSION['uid'];
+                               $extra_query = "AND `user`.`uid` = %d ";
+                       }
+                       
                }
                
 
                // user info            
-               $uinfo = q("SELECT * FROM `user`, `contact`
+               $uinfo = q("SELECT *, `contact`.`id` as `cid` FROM `user`, `contact`
                                WHERE `user`.`uid`=`contact`.`uid` AND `contact`.`self`=1
                                $extra_query",
                                $user
                                intval($uinfo[0]['uid'])
                );
                $countfriends = $r[0]['count'];
-               
-               // get last public wall message
-               $lastwall = q("SELECT * FROM `item`
-                               WHERE  `uid` = %d
-                               AND `type`='wall' 
-                               AND `allow_cid`='' AND `allow_gid`='' AND `deny_cid`='' AND `deny_gid`=''
-                               ORDER BY `created` DESC LIMIT 1",
-                               intval($uinfo[0]['uid'])
-               );
-       
-               //echo "<pre>"; var_dump($lastwall); die();
-               
-               $ret = Array(
-                       'user' => Array(
-                               'id' => $uinfo[0]['uid'],
-                               'name' => $uinfo[0]['username'],
-                               'screen_name' => $uinfo[0]['nickname'],
-                               'location' => $uinfo[0]['default-location'],
-                               'profile_image_url' => $uinfo[0]['photo'],
-                               'url' => $uinfo[0]['url'],
-                               'protected' => false,   #
-                               'friends_count' => $countfriends,
-                               'created_at' => api_date($uinfo[0]['created']),
-                               'utc_offset' => 0, #XXX: fix me
-                               'time_zone' => $uinfo[0]['timezone'],
-                               'geo_enabled' => false,
-                               'statuses_count' => $countitms, #XXX: fix me 
-                               'lang' => 'en', #XXX: fix me
-                               'status' => array(
-                                       'created_at' => api_date($lastwall[0]['created']),
-                                       'id' => $lastwall[0]['id'],
-                                       'text' => bbcode($lastwall[0]['body']),
-                                       'source' => 'web',
-                                       'truncated' => false,
-                                       'in_reply_to_status_id' => '',
-                                       'in_reply_to_user_id' => '',
-                                       'favorited' => false,
-                                       'in_reply_to_screen_name' => '',
-                                       'geo' => '',
-                               'coordinates' => $lastwall[0]['coord'],
-                               'place' => $lastwall[0]['location'],
-                               'contributors' => ''                                    
-                               )
                                
-                       )
+
+               $ret = Array(
+                       'id' => $uinfo[0]['cid'],
+                       'name' => $uinfo[0]['username'],
+                       'screen_name' => $uinfo[0]['nickname'],
+                       'location' => $uinfo[0]['default-location'],
+                       'profile_image_url' => $uinfo[0]['micro'],
+                       'url' => $uinfo[0]['url'],
+                       'protected' => false,   #
+                       'friends_count' => $countfriends,
+                       'created_at' => api_date($uinfo[0]['created']),
+                       'utc_offset' => 0, #XXX: fix me
+                       'time_zone' => $uinfo[0]['timezone'],
+                       'geo_enabled' => false,
+                       'statuses_count' => $countitms, #XXX: fix me 
+                       'lang' => 'en', #XXX: fix me
+                       'description' => '',
+                       'followers_count' => $countfriends, #XXX: fix me
+                       'lang' => 'en', #XXX: fix me
+                       'favourites_count' => 0,
+                       'contributors_enabled' => false,
+                       'follow_request_sent' => false,
+                       'profile_background_color' => 'cfe8f6',
+                       'profile_text_color' => '000000',
+                       'profile_link_color' => 'FF8500',
+                       'profile_sidebar_fill_color' =>'AD0066',
+                       'profile_sidebar_border_color' => 'AD0066',
+                       'profile_background_image_url' => '',
+                       'profile_background_tile' => false,
+                       'profile_use_background_image' => false,
+                       'notifications' => false,
+                       'verified' => true, #XXX: fix me
+                       'followers' => '', #XXX: fix me
+                       #'status' => null
                );
+       
+               return $ret;
                
+       }
+
+       /**
+        * apply xmlify() to all values of array $val, recursively
+        */
+       function api_xmlify($val){
+               if (is_bool($val)) return $val?"true":"false";
+               if (is_array($val)) return array_map('api_xmlify', $val);
+               return xmlify($val);
+       }
+
+       /**
+        *  load api $templatename for $type and replace $data array
+        */
+       function api_apply_template($templatename, $type, $data){
+               switch($type){
+                       case "rss":
+                       case "atom":
+                       case "xml":
+                               $data = api_xmlify($data);
+                               $tpl = get_markup_template("api_".$templatename."_".$type.".tpl");
+                               $ret = replace_macros($tpl, $data);
+                               break;
+                       case "json":
+                               $ret = $data;
+                               break;
+               }
                return $ret;
+       }
+       
+       /**
+        ** TWITTER API
+        */
+       
+       /**
+        * Returns an HTTP 200 OK response code and a representation of the requesting user if authentication was successful; 
+        * returns a 401 status code and an error message if not. 
+        * http://developer.twitter.com/doc/get/account/verify_credentials
+        */
+       function api_account_verify_credentials(&$a, $type){
+               if (local_user()===false) return false;
+               $user_info = api_get_user($a);
+               
+               return api_apply_template("user", $type, array('$user' => $user_info));
+
+       }
+       api_register_func('api/account/verify_credentials','api_account_verify_credentials', true);
+               
+       
+               
+       /**
+        * Returns extended information of a given user, specified by ID or screen name as per the required id parameter.
+        * The author's most recent status will be returned inline.
+        * http://developer.twitter.com/doc/get/users/show
+        */
+       function api_users_show(&$a, $type){
+               $user_info = api_get_user($a);
+               // get last public wall message
+               $lastwall = q("SELECT `item`.*, `i`.`contact-id` as `reply_uid`, `i`.`nick` as `reply_author`
+                               FROM `item`, `contact`,
+                                       (SELECT `item`.`id`, `item`.`contact-id`, `contact`.`nick` FROM `item`,`contact` WHERE `contact`.`id`=`item`.`contact-id`) as `i` 
+                               WHERE `item`.`contact-id` = %d
+                                       AND `i`.`id` = `item`.`parent`
+                                       AND `contact`.`id`=`item`.`contact-id` AND `contact`.`self`=1
+                                       AND `type`!='activity'
+                                       AND `item`.`allow_cid`='' AND `item`.`allow_gid`='' AND `item`.`deny_cid`='' AND `item`.`deny_gid`=''
+                               ORDER BY `created` DESC 
+                               LIMIT 1",
+                               intval($user_info['id'])
+               );
+
+               if (count($lastwall)>0){
+                       $lastwall = $lastwall[0];
+                       
+                       $in_reply_to_status_id = '';
+                       $in_reply_to_user_id = '';
+                       $in_reply_to_screen_name = '';
+                       if ($lastwall['parent']!=$lastwall['id']) {
+                               $in_reply_to_status_id=$lastwall['parent'];
+                               $in_reply_to_user_id = $lastwall['reply_uid'];
+                               $in_reply_to_screen_name = $lastwall['reply_author'];
+                       }  
+                       $user_info['status'] = array(
+                               'created_at' => api_date($lastwall['created']),
+                               'id' => $lastwall['contact-id'],
+                               'text' => strip_tags(bbcode($lastwall['body'])),
+                               'source' => 'web',
+                               'truncated' => false,
+                               'in_reply_to_status_id' => $in_reply_to_status_id,
+                               'in_reply_to_user_id' => $in_reply_to_user_id,
+                               'favorited' => false,
+                               'in_reply_to_screen_name' => $in_reply_to_screen_name,
+                               'geo' => '',
+                               'coordinates' => $lastwall['coord'],
+                               'place' => $lastwall['location'],
+                               'contributors' => ''                                    
+                       );
+               }
+               return  api_apply_template("user", $type, array('$user' => $user_info));
                
        }
        api_register_func('api/users/show','api_users_show');
        /**
         * 
         * http://developer.twitter.com/doc/get/statuses/home_timeline
+        * 
+        * TODO: Optional parameters
+        * TODO: Add reply info
         */
-       function api_statuses_home_timeline(&$a){
+       function api_statuses_home_timeline(&$a, $type){
                if (local_user()===false) return false;
                
-               // count public wall messages
-               $r = q("SELECT COUNT(`id`) as `count` FROM `item`
-                               WHERE  `uid` = %d
-                               AND `type`='wall' 
-                               AND `allow_cid`='' AND `allow_gid`='' AND `deny_cid`='' AND `deny_gid`=''",
-                               intval($uinfo[0]['uid'])
-               );
-               $countitms = $r[0]['count'];
+               $user_info = api_get_user($a);
                
                // get last newtork messages
                $sql_extra = " AND `item`.`parent` IN ( SELECT `parent` FROM `item` WHERE `id` = `parent` ) ";
-               
+
                $r = q("SELECT `item`.*, `item`.`id` AS `item_id`, 
                        `contact`.`name`, `contact`.`photo`, `contact`.`url`, `contact`.`rel`,
                        `contact`.`network`, `contact`.`thumb`, `contact`.`dfrn-id`, `contact`.`self`,
                        `contact`.`id` AS `cid`, `contact`.`uid` AS `contact-uid`
                        FROM `item`, `contact`, `user`
-                       WHERE `item`.`uid` = %d AND `user`.`uid` = `item`.`uid` 
+                       WHERE `item`.`contact-id` = %d AND `user`.`uid` = `item`.`uid` 
                        AND `item`.`visible` = 1 AND `item`.`deleted` = 0
                        AND `contact`.`id` = `item`.`contact-id`
                        AND `contact`.`blocked` = 0 AND `contact`.`pending` = 0
                        $sql_extra
                        ORDER BY `item`.`created` DESC LIMIT %d ,%d ",
-                       intval($_SESSION['uid']),
-                       intval($a->pager['start']),
-                       intval($a->pager['itemspage'])
+                       intval($user_info['id']),
+                       0,20
                );
-               $ret = new Container("statuses");
-               $ret->attrs['type']='array';
+               $ret = Array();
 
-               #foreach($r as $item) {
-               {
-                       $item = $r[0];
-                       $status = new Container('status', array(
+               foreach($r as $item) {
+                       $status = array(
                                'created_at'=> api_date($item['created']),
                                'id'            => $item['id'],
-                               'text'          => bbcode($item['body']),
-                               'source'        => 'web',       #XXX: Fix me!
+                               'text'          => strip_tags(bbcode($item['body'])),
+                               'html'          => bbcode($item['body']),
+                               'source'        => 'web',
+                               'url'           => ($item['plink']!=''?$item['plink']:$item['author-link']),
                                'truncated' => False,
-                               'in_reply_to_status_id' => '',
+                               'in_reply_to_status_id' => ($item['parent']!=$item['id']?$item['id']:''),
                                'in_reply_to_user_id' => '',
                                'favorited' => false,
                                'in_reply_to_screen_name' => '',
                                'contributors' => '',
                                'annotations'  => '',
                                'entities'  => '',
-                               'user' => Array(
-                                       'id' => $item['uid'],
-                                       'name' => $item['username'],
-                                       'screen_name' => $item['nickname'],
-                                       'location' => $item['default-location'],
-                                       'description' => '',
-                                       'profile_image_url' => $item['photo'],
-                                       'url' => $item['url'],
-                                       'protected' => false,   #
-                                       'followers_count' => $countfriends, #XXX: fix me
-                                       'friends_count' => $countfriends,
-                                       'created_at' => api_date($item['created']),
-                                       'utc_offset' => 0, #XXX: fix me
-                                       'time_zone' => $item['timezone'],
-                                       'geo_enabled' => false,
-                                       'statuses_count' => $countitms, #XXX: fix me 
-                                       'lang' => 'en', #XXX: fix me
-                                       'favourites_count' => 0,
-                                       'contributors_enabled' => false,
-                                       'follow_request_sent' => false,
-                                       'profile_background_color' => 'cfe8f6',
-                               'profile_text_color' => '000000',
-                               'profile_link_color' => 'FF8500',
-                                       'profile_sidebar_fill_color' =>'AD0066',
-                                       'profile_sidebar_border_color' => 'AD0066',
-                                       'profile_background_image_url' => '',
-                                       'profile_background_tile' => false,
-                                       'profile_use_background_image' => false,
-                                       'notifications' => false,                                       
-                               )                                       
-                       
-                       ));
+                               'user' =>  $user_info,
+                               'objecttype' => $item['object-type'],
+                               'verb' => $item['verb'],
+                               'self' => $a->get_baseurl()."/api/statuses/show/".$ite['id'].".".$type,
+                               'edit' => $a->get_baseurl()."/api/statuses/show/".$ite['id'].".".$type,                         
+                       );
                        $ret[]=$status;
                };
                
-               return $ret;
+               $data = array('$statuses' => $ret);
+               switch($type){
+                       case "atom":
+                       case "rss":
+                               $data = api_rss_extra($a, $data, $user_info);
+               }
+                               
+               return  api_apply_template("timeline", $type, $data);
        }
        api_register_func('api/statuses/home_timeline','api_statuses_home_timeline', true);
+       api_register_func('api/statuses/friends_timeline','api_statuses_home_timeline', true);
+       api_register_func('api/statuses/user_timeline','api_statuses_home_timeline', true);
+       # TODO: user_timeline should be profile view
+