def find_shows_by_category(self, category, genre=None, area=None,
                            release_year=None, paid=None,
                            orderby='view-today-count',
                            streamtypes=None, person=None,
                            page=1, count=20):
     """doc: http://open.youku.com/docs/doc?id=62
     """
     url = 'https://openapi.youku.com/v2/shows/by_category.json'
     params = {
         'client_id': self.client_id,
         'category': category,
         'genre': genre,
         'area': area,
         'release_year': release_year,
         'paid': paid,
         'orderby': orderby,
         'streamtypes': streamtypes,
         'person': person,
         'page': page,
         'count': count
     }
     params = remove_none_value(params)
     r = requests.get(url, params=params)
     check_error(r)
     return r.json()

 def search_videos_by_keyword(self, keyword, category=None,
                              period='week', orderby='relevance',
                              public_type='all', paid=None,
                              timeless=None, timemore=None,
                              streamtypes=None,
                              page=1, count=20):
     """doc: http://open.youku.com/docs/doc?id=81
     """
     url = 'https://openapi.youku.com/v2/searches/video/by_keyword.json'
     params = {
         'client_id': self.client_id,
         'keyword': keyword,
         'category': category,
         'period': period,
         'orderby': orderby,
         'public_type': public_type,
         'paid': paid,
         'timeless': timeless,
         'timemore': timemore,
         'streamtypes': streamtypes,
         'page': page,
         'count': count
     }
     params = remove_none_value(params)
     r = requests.get(url, params=params)
     check_error(r)
     return r.json()

 def search_shows_by_keyword(self, keyword, unite=0, source_site=None,
                             category=None, release_year=None,
                             area=None, orderby='view-count',
                             paid=None, hasvideotype=None,
                             page=1, count=20):
     """doc: http://open.youku.com/docs/doc?id=82
     """
     url = 'https://openapi.youku.com/v2/searches/show/by_keyword.json'
     params = {
         'client_id': self.client_id,
         'keyword': keyword,
         'unite': unite,
         'source_site': source_site,
         'category': category,
         'release_year': release_year,
         'area': area,
         'orderby': orderby,
         'paid': paid,
         'hasvideotype': hasvideotype,
         'page': page,
         'count': count
     }
     params = remove_none_value(params)
     r = requests.get(url, params=params)
     check_error(r)
     return r.json()

 def comment_expression(self):
     """doc: http://open.youku.com/docs/doc?id=92
     """
     url = 'https://openapi.youku.com/v2/schemas/comment/expression.json'
     r = requests.get(url)
     check_error(r)
     return r.json()

    def create(self, params):
        # prepare file info
        params['file_name'] = self.file_name
        params['file_size'] = self.file_size
        params['file_md5'] = self.file_md5 = self.checksum_md5file(self.file)
        self.logger.info('upload file %s, size: %d bytes' %
                         (self.file_name, self.file_size))
        self.logger.info('md5 of %s: %s' %
                         (self.file_name, self.file_md5))

        params['client_id'] = self.client_id
        params['access_token'] = self.access_token

        url = 'https://openapi.youku.com/v2/uploads/create.json'
        r = requests.get(url, params=params)
        check_error(r, 201)
        result = r.json()

        self.upload_token = result['upload_token']
        self.logger.info('upload token of %s: %s' %
                         (self.file_name, self.upload_token))

        if result['instant_upload_ok'] == 'yes':
            # pass upload and finish
            # this case hasn't happen and test
            self.logger.info("instant upload %s" % self.file_name)
            return self.commit()

        self.upload_server_ip = socket.gethostbyname(
            result['upload_server_uri'])
        self.logger.info('upload_server_ip of %s: %s' %
                         (self.file_name, self.upload_server_ip))

 def playlist_category(self):
     """doc: http://open.youku.com/docs/doc?id=94
     """
     url = 'https://openapi.youku.com/v2/schemas/playlist/category.json'
     r = requests.get(url)
     check_error(r)
     return r.json()

 def searche_top_category(self):
     """doc: http://open.youku.com/docs/doc?id=95
     """
     url = 'https://openapi.youku.com/v2/schemas/searche/top/category.json'
     r = requests.get(url)
     check_error(r)
     return r.json()

 def upload_spec(self):
     """doc: http://open.youku.com/docs/doc?id=91
     """
     url = 'https://openapi.youku.com/v2/schemas/upload/spec.json'
     r = requests.get(url)
     check_error(r)
     return r.json()

 def check(self):
     params = {
         'upload_token': self.upload_token
     }
     url = 'http://%s/gupload/check' % self.upload_server_ip
     r = requests.get(url, params=params)
     check_error(r, 200)
     return r.json()

 def new_slice(self):
     params = {
         'upload_token': self.upload_token
     }
     url = 'http://%s/gupload/new_slice' % self.upload_server_ip
     r = requests.get(url, params=params)
     check_error(r, 201)
     self._save_slice_state(r.json())

 def my_info(self, access_token):
     """doc: http://open.youku.com/docs/doc?id=23
     """
     url = 'https://openapi.youku.com/v2/users/myinfo.json'
     data = {'client_id': self.client_id,
             'access_token': access_token}
     r = requests.post(url, data=data)
     check_error(r)
     return r.json()

 def new_slice(self):
     params = {
         'upload_token': self.upload_token
     }
     url = 'http://%s/gupload/new_slice' % self.upload_server_ip
     r = requests.get(url, params=params)
     check_error(r, 200, 201)
     # origin value is 201, but new_slice return status is 200,
     # GoTop 2016.2.9 change 201 to 200
     self._save_slice_state(r.json())

 def refresh_token(self, refresh_token):
     '''return origin json'''
     url = 'https://openapi.youku.com/v2/oauth2/token'
     data = {'client_id': self.client_id,
             'client_secret': self.client_secret,
             'grant_type': 'refresh_token',
             'refresh_token': refresh_token}
     r = requests.post(url, data=data)
     check_error(r)
     return r.json()

 def find_playlist_by_id(self, playlist_id):
     """doc: http://open.youku.com/docs/doc?id=66
     """
     url = 'https://openapi.youku.com/v2/playlists/show.json'
     params = {
         'client_id': self.client_id,
         'playlist_id': playlist_id
     }
     r = requests.get(url, params=params)
     check_error(r)
     return r.json()

 def subscribe_notice(self, access_token):
     """doc: http://open.youku.com/docs/doc?id=31
     """
     url = 'https://openapi.youku.com/v2/users/subscribe/notice.json'
     params = {
         'client_id': self.client_id,
         'access_token': access_token
     }
     r = requests.get(url, params=params)
     check_error(r)
     return r.json()

 def find_persons_by_ids(self, person_ids):
     """doc: http://open.youku.com/docs/docs?id=88
     """
     url = 'https://openapi.youku.com/v2/persons/show_batch.json'
     params = {
         'client_id': self.client_id,
         'person_ids': person_ids
     }
     r = requests.get(url, params=params)
     check_error(r)
     return r.json()

 def search_keyword_complete(self, keyword):
     """doc: http://open.youku.com/docs/doc?id=83
     """
     url = 'https://openapi.youku.com/v2/searches/keyword/complete.json'
     params = {
         'client_id': self.client_id,
         'keyword': keyword
     }
     r = requests.get(url, params=params)
     check_error(r)
     return r.json()

 def find_comments_by_ids(self, comment_ids):
     """doc: http://open.youku.com/docs/doc?id=34
     """
     url = 'https://openapi.youku.com/v2/comments/show_batch.json'
     params = {
         'client_id': self.client_id,
         'comment_ids': comment_ids
     }
     r = requests.get(url, params=params)
     check_error(r)
     return r.json()

 def find_show_by_id(self, show_id):
     """doc: http://open.youku.com/docs/doc?id=59
     """
     url = 'https://openapi.youku.com/v2/shows/show.json'
     params = {
         'client_id': self.client_id,
         'show_id': show_id
     }
     r = requests.get(url, params=params)
     check_error(r)
     return r.json()

 def get_token_by_code(self, code):
     '''return origin json'''
     url = 'https://openapi.youku.com/v2/oauth2/token'
     data = {'client_id': self.client_id,
             'client_secret': self.client_secret,
             'grant_type': 'authorization_code',
             'code': code,
             'redirect_uri': self.redirect_uri}
     r = requests.post(url, data=data)
     check_error(r)
     return r.json()