Login

divShareApi

Author:
mamcx
Posted:
November 19, 2007
Language:
Python
Version:
.96
Tags:
files api media photos divshare video
Score:
0 (after 0 ratings)

A python module for integration with http://www.divshare.com/integrate/api.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
import elementtree.ElementTree as ET
import urllib, mechanize
from datetime import datetime
from decimal import Decimal
import md5

# -*- coding: iso-8859-15 -*-
""" Clase para comunicarse con DivShare basado en http://www.divshare.com/integrate/api"""

API_URL = 'http://www.divshare.com/api/'

class DivShareFile:
    id=None
    name=""
    description=""
    size=Decimal("0.0")
    downloads=0
    last_download=None
    uploadDate=None
    folderName=""
    folderId=0

    def __str__( self):
        return "%s - Id:%s" % (self.name,self.id)

class DivShareFolder:
    id=None
    name=""

    def __str__( self):
        return "%s - Id:%s" % (self.name,self.id)

class DivShareApi:
    def __init__(self,key, secret, session_key=''):
        self.key = key
        self.secret = secret
        self.session_key = session_key
        self.IsLogged = False
        self._lastXml = None
        
    def get_last_response(self):
        '''
        For debugging. Use ET.dump(xml) to print it
        '''
        return self._lastXml


    def _create_signature(self,params):
        '''
        Encode the signature for api calls
        '''
        #Must be alphabetical
        keys = params.keys()
        keys.sort()
        
        signature = self.secret+self.session_key
        
        for key in keys:
            if not(key in 'api_key, api_session_key, method, api_sig'):
                if params[key]<>None:
                    signature = signature + "%s%s" % (key,params[key])
        
        return md5.new(signature).hexdigest()

    def _get_files(self,xml):
        '''
        Get the files in a nice list
        '''
        files = []
        
        for file in xml.getiterator("file"):
            theFile = DivShareFile()
            
            theFile.id =  file.find('file_id').text
            theFile.name = file.find('file_name').text
            theFile.description = file.find('file_description').text
            theFile.size = Decimal(file.find('file_size').text)
            
            theFile.downloads = int(file.find('downloads').text)
            theFile.last_download = datetime.utcfromtimestamp(int(file.find('last_downloaded_at').text))
            theFile.uploadDate = datetime.utcfromtimestamp(int(file.find('uploaded_at').text))
            
            theFile.folderName = file.find('folder_title').text
            theFile.folderId = int(file.find('folder_id').text)
            
            files.append(theFile)
        
        return files
    
    def  _postData(self,method,TheParams={}):
        '''
        POST the data and get the info back.
        '''
        br = mechanize.Browser()
        
        api_id=""
        
        params={}
        
        for key,value in TheParams.iteritems():
            if value<>None:
                params[key]=value

        params['api_key'] = self.key
        params['method'] = method
        
        if self.IsLogged:
            #This must not be urlencode...
            api_id = 'api_session_key=' + self.session_key + '&api_sig=' + self._create_signature(params)+'&'

        data = api_id + urllib.urlencode(params)
        
        self._lastXml = br.open(API_URL, data)
        
        xml =  ET.parse(self._lastXml)
        
        #Informar de inmediato de los errores internos
        if xml.find('error')<>None:
            raise xml.find('error').text
        
        return xml
    
    def login(self,email,pwd):
        '''
        Logs in, and sets the api_session_key for internal use.
        '''

        res = self._postData('login',{'user_email': email,'user_password':pwd})
        
        api_key = res.find('api_session_key')
        
        if api_key is None:
            raise res.find('error').text
        else:
            self.session_key = api_key.text
            self.IsLogged = True

        return self.session_key 
    
    def logout(self):
        '''Logged out on successs, and deletes the current session key'''
        res = self._postData('logout')
        self.session_key=None
        

    def get_user_files(self,limit=50,offset=0):
        '''
        Gets all the files assigned to the logged in user
        limit sets the max number of files returned
        Use offset for pagination -- for example, page 2 has an offset of 10 and a limit of 10
        '''
        
        return self._get_files(self._postData('get_user_files',{'limit':limit,'offset':offset}))
    
    def get_folder_files(self,folder_id,limit=50,offset=0):
        '''
        Gets all the files in a folder owned by the logged in user
        '''
        return self._get_files(self._postData('get_folder_files',{'folder_id':folder_id,'limit':limit,'offset':offset}))

    def get_user_info(self):
        '''
        Gets user e-mail and first name. May add more info to this response in the future.
        '''
        xml = self._postData('get_user_info').find("user_info")
        
        return {'userName':xml.find('user_fname').text,'userMail':xml.find('user_email').text}
    
    def get_upload_ticket(self):
        '''
        Returns an upload ticket, which must then be inserted into the upload form.
        '''
        xml = self._postData('get_upload_ticket').find("upload_ticket")
        
        return xml.text

if __name__ == '__main__':
    divShare = DivShareApi('YOUR-KEY','YOUR-SECRET')
    
    print "Loging...."
    
    print divShare.login('[email protected]','pinkycerebro')
    
    print "Get all files..."
    files =divShare.get_user_files()
    for file in files:
        print file
    
    print "Get files of a folder..."
    files =divShare.get_folder_files(203635)
    for file in files:
        print file
    
    print "New upload ticket..."
    print divShare.get_upload_ticket()
    
    print "User info..."
    print divShare.get_user_info()
    
    print "Logout"
    divShare.logout()

More like this

Comments

Please login first before commenting.