mambax7 / references

     * @internal param $string [optional] $userId        Specfies the screen name of the user for whom to return results for. Helpful for disambiguating when a valid screen name is also a user ID.

     * @internal param $string [optional] $screenName    Specfies the ID of the user for whom to return results for. Helpful for disambiguating when a valid user ID is also a valid screen name.

     */

    public function directMessagesNew($text, $id = null, $userId = null, $screenName = null)

    {

        // validate

        if ($id == '' && $userId == '' && $screenName == '') throw new TwitterException('Specify an id or an userId or a screenName.');

        // build parameters

        $parameters['text'] = (string)$text;

        if ($id != null) $parameters['user'] = (string)$id;

        if ($userId != null) $parameters['user_id'] = (string)$userId;

        if ($screenName != null) $parameters['screen_name'] = (string)$screenName;

        // make the call

        return (array)$this->doCall('direct_messages/new.json', $parameters, true, 'POST');

    }

    /**

     * Destroys the direct message specified in the required ID parameter. The authenticating user must be the recipient of the specified direct message.

     * @internal param $string [optional] $screenName    Specfies the ID of the user for whom to return results for. Helpful for disambiguating when a valid user ID is also a valid screen name.

     * @internal param $bool [optional] $follow            Returns public statuses that reference the given set of users.

     */

    public function friendshipsCreate($id = null, $userId = null, $screenName = null, $follow = false)

    {

        // validate

        if ($id == '' && $userId == '' && $screenName == '') throw new TwitterException('Specify an id or an userId or a screenName.');

        // build parameters

        if ($id != null) $parameters['id'] = (string)$id;

        if ($userId != null) $parameters['user_id'] = (string)$userId;

        if ($screenName != null) $parameters['screen_name'] = (string)$screenName;

        $parameters['follow'] = $follow ? 'true' : 'false';

        // make the call

        return (array)$this->doCall('friendships/create.json', $parameters, true, 'POST');

    }

    /**

     * Allows the authenticating users to unfollow the user specified in the ID parameter.

     * @internal param $string [optional] $screenName    Specfies the ID of the user for whom to return results for. Helpful for disambiguating when a valid user ID is also a valid screen name.

     * @internal param $string [optional] $cursor    Breaks the results into pages. This is recommended for users who are following many users. Provide a value of -1  to begin paging. Provide values as returned to in the response body's next_cursor  and previous_cursor attributes to page back and forth in the list.

     */

    public function friendsIds($id = null, $userId = null, $screenName = null, $cursor = null)

    {

        // validate

        if ($id == '' && $userId == '' && $screenName == '') throw new TwitterException('Specify an id or an userId or a screenName.');

        // build parameters

        if ($id != null) $parameters['id'] = (string)$id;

        if ($userId != null) $parameters['user_id'] = (string)$userId;

        if ($screenName != null) $parameters['screen_name'] = (string)$screenName;

        if ($cursor != null) $parameters['cursor'] = (string)$cursor;

        // make the call

        return (array)$this->doCall('friends/ids.json', $parameters);

    }

    /**

     * Returns an array of numeric IDs for every user following the specified user.

     * @internal param $string [optional] $screenName    Specfies the ID of the user for whom to return results for. Helpful for disambiguating when a valid user ID is also a valid screen name.

     * @internal param $string [optional] $cursor    Breaks the results into pages. This is recommended for users who are following many users. Provide a value of -1  to begin paging. Provide values as returned to in the response body's next_cursor  and previous_cursor attributes to page back and forth in the list.

     */

    public function followersIds($id = null, $userId = null, $screenName = null, $cursor = null)

    {

        // validate

        if ($id == '' && $userId == '' && $screenName == '') throw new TwitterException('Specify an id or an userId or a screenName.');

        // build parameters

        if ($id != null) $parameters['id'] = (string)$id;

        if ($userId != null) $parameters['user_id'] = (string)$userId;

        if ($screenName != null) $parameters['screen_name'] = (string)$screenName;

        if ($cursor != null) $parameters['cursor'] = (string)$cursor;

        // make the call

        return (array)$this->doCall('followers/ids.json', $parameters);

    }

    // Account resources