La API de Dropbox - Historial de revisió

http://wiki.joanillo.org/index.php?action=history&feed=atom&title=La_API_de_Dropbox La API de Dropbox - Historial de revisió 2026-08-30T10:01:36Z Historial de revisió per a aquesta pàgina del wiki MediaWiki 1.34.2 http://wiki.joanillo.org/index.php?title=La_API_de_Dropbox&diff=253130&oldid=prev Joan: /* Script administratiu cronificat. Exemple */ 2015-02-23T19:16:36Z

<p><span dir="auto"><span class="autocomment">Script administratiu cronificat. Exemple</span></span></p> <p><b>Pàgina nova</b></p><div>=Introducció=<br /> Avui en dia és habitual fer còpies de seguretat al núvol i compartir la informació. Per exemple, serveis al núvol que ofereixen força espai de disc al núvol de forma gratuïta:<br /> *Dropbox: https://www.dropbox.com/<br /> *ownCloud: https://owncloud.com/<br /> *Copy: https://www.copy.com/home/<br /> *Box: https://www.box.com/ <br /> <br /> Volem accedir al '''Dropbox''' des de la seva API. És a dir, volem programar scripts per accedir al Dropbox (típicament: pujar fitxers, descarregar fitxers, llistar contingut de carpetes). El primer de tot, tenir un compte de dropbox. Si no el tens, ara és el moment de fer-ho.<br /> *https://www.dropbox.com/developers/core<br /> <br /> =API de Dropbox. PHP=<br /> *https://www.dropbox.com/developers/core/start/php<br /> Hem de registrar una aplicació a la App Console. Necessitarem la '''app key''' per accedir a la '''Core API'''. Després haurem d'instal.lar el SDK per al llenguatge seleccionat (en el nostre cas, PHP SDK).<br /> <br /> Hem de crear una nova aplicació:<br /> *https://www.dropbox.com/developers/apps<br /> I contestar les preguntes que ens van fent:<br /> *Escollim una Dropbox API app. <br /> <br /> *What type of data does your app need to store on Dropbox?<br /> Escollim Files and datastores<br /> <br /> *Can your app be limited to its own folder?<br /> No My app needs access to files already on Dropbox.<br /> <br /> *What type of files does your app need access to?<br /> Specific file types My app only needs access to certain file types, like text or photos.<br /> <br /> Farem que la nostra aplicació només tingui accés a fitxers de text.<br /> <br /> *Last question, what type of files will your app use?<br /> Text files TXT, Markdown, Code files, HTML, etc.<br /> <br /> *Provide an app name, and you're on your way.<br /> prova1_api (escull el nom de la app que creguis convenient)<br /> <br /> I ara ja tenim la url de la nostra interface de desenvolupament d'aplicacions per a la API de Drobox. Per exemple, en el cas del professor:<br /> *https://www.dropbox.com/developers/apps/info/fqih5rcf32yak2l<br /> <br /> Hem d'obtenir les credencials. En el cas del professor:<br /> <pre><br /> App key: fqih5rcf32yak2l<br /> App secret: pyt7dcqu0cgz1l8<br /> <br /> Generate access token: rqDdcful8VMAAAAAAAAAPqRyGCCjH5v5Zoju1nZhs4Do4RcYKu6FTAVmrFshzvuu<br /> </pre><br /> '''NOTA''': És important el valor del ''access token'' generat, doncs és un ''access token'' comodí que farem servir després per poder executar els nostres scripts amb autenticació automatitzada.<br /> <br /> Si anem a core API tenim tutorials i documentació per als diferents llenguatges de programació:<br /> *https://www.dropbox.com/developers/core<br /> Podem fer scripts per als següents llenguatges:<br /> <pre><br /> PHP<br /> Python<br /> Ruby<br /> Java<br /> iOS<br /> OS X<br /> HTTP<br /> </pre><br /> There are also a number of third-party libraries maintained by the developer community.<br /> <br /> I ara seguim el tutorial de PHP:<br /> *https://www.dropbox.com/developers/core/start/php<br /> <br /> El primer que hem de fer és instal.lar el PHP SDK:<br /> *https://www.dropbox.com/developers/core/sdks/php<br /> Descarreguem ''dropbox-sdk-php-1.1.4.zip'' i descomprimim. I llegim:<br /> <pre><br /> The SDK is contained in the lib/ folder in the zip file so copy lib/ into your project and name it dropbox-sdk/ and include it in your app:<br /> <br /> require_once "dropbox-sdk/Dropbox/autoload.php";<br /> </pre><br /> Per tant, si hem llegit bé, hem de copiar la carpeta ''lib/'' a un directori que es digui ''dropbox-sdk/'', i aquesta carpeta estarà en l'arrel d'on tindrem els nostres scripts.<br /> <br /> Dit d'una altra manera, la carpeta que contingui els nostres scripts PHP contindrà una carpeta que es dirà ''dropbox-sdk/'', i aquesta carpeta té el mateix contingut que lib/<br /> <br /> Si continuem mirant el codi, ara cal fer la configuració de l'autenticació. Canviem:<br /> <pre><br /> $appInfo = dbx\AppInfo::loadFromJsonFile("INSERT_PATH_TO_JSON_CONFIG_PATH");<br /> </pre><br /> per <br /> <pre><br /> $appInfo = dbx\AppInfo::loadFromJsonFile("config.json");<br /> </pre><br /> i en el fitxer config.json posarem les nostres credencials:<br /> <pre><br /> {<br /> "key": "INSERT_APP_KEY",<br /> "secret": "INSERT_SECRET"<br /> }<br /> </pre><br /> En el cas del professor (no podeu utilitzar aquestes credencials):<br /> <pre><br /> {<br /> "key": "fqih5rcf32yak2l",<br /> "secret": "pyt7dcqu0cgz1l8"<br /> }<br /> </pre><br /> Provem d'executar l'exemple: (recordem que estem en PHP en mode CLI, línia de comanda):<br /> <pre><br /> $ php primer_exemple_dropbox.php<br /> </pre><br /> al professor li dóna l'error:<br /> <pre><br /> The Dropbox SDK uses 64-bit integers, but it looks like we're running on a version of PHP that doesn't support 64-bit integers<br /> </pre><br /> Fent una petita cerca per Internet:<br /> <pre><br /> Just comment the following line in \lib\Dropbox\RequestUtil.php(line.no : 19)<br /> <br /> if (strlen((string) PHP_INT_MAX) < 19) {<br /> // // Looks like we're running on a 32-bit build of PHP. This could cause problems because some of the numbers<br /> // // we use (file sizes, quota, etc) can be larger than 32-bit ints can handle.<br /> throw new \Exception("The Dropbox SDK uses 64-bit integers, but it looks like we're running on a version of PHP that doesn't support 64-bit integers (PHP_INT_MAX=" . ((string) PHP_INT_MAX) . "). Library: \"" . __FILE__ . "\"");<br /> }<br /> </pre><br /> Hem de comentar la línia que llença l'excepció, en el fitxer ''dropbox-sdk/Dropbox/RequestUtil.php''<br /> <br /> I ara ja funcionarà:<br /> <pre><br /> $ php primer_exemple_dropbox.php<br /> 1. Go to: https://www.dropbox.com/1/oauth2/authorize?locale=&client_id=fqih5rcf32yak2l&response_type=code<br /> 2. Click "Allow" (you might have to log in first).<br /> 3. Copy the authorization code.<br /> Enter the authorization code here: <br /> <br /> ...<br /> Array<br /> (<br /> [referral_link] => https://db.tt/iSr23qcS<br /> [display_name] => Joan Quintana<br /> [uid] => 329761<br /> [locale] => es_ES<br /> [country] => ES<br /> [team] => <br /> [quota_info] => Array<br /> (<br /> [datastores] => 0<br /> [shared] => 0<br /> [quota] => 2147483648<br /> [normal] => 189308719<br /> ...<br /> Array<br /> (<br /> [rev] => ce16e38000e6c76<br /> [thumb_exists] => <br /> [path] => /working-draft.txt<br /> [is_dir] => <br /> [client_mtime] => Fri, 20 Feb 2015 10:28:57 +0000<br /> [icon] => page_white_text<br /> [read_only] => <br /> [modifier] => <br /> [bytes] => 47<br /> [modified] => Fri, 20 Feb 2015 10:28:56 +0000<br /> [size] => 47 bytes<br /> [root] => dropbox<br /> [mime_type] => text/plain<br /> [revision] => 216100408<br /> )<br /> </pre><br /> Si hem mirat amb deteniment l'exemple que estem executant, fa tres coses:<br /> *puja un fitxer.<br /> *llista el contingut de la nostra arrel del Dropbox (/)<br /> *descarrega un fitxer (de fet copia el contingut d'un fitxer en un altre que prèviament ha d'existir en el nostre ordinador local)<br /> Ara podem anar al Dropbox i veure que efectivament hem pujat el fitxer<br /> <br /> Posem aquí una altra vegada el contingut del script '''primer_exemple_dropbox.php''':<br /> <pre><br /> <?php<br /> <br /> # Include the Dropbox SDK libraries<br /> require_once "dropbox-sdk/Dropbox/autoload.php";<br /> use \Dropbox as dbx;<br /> <br /> $appInfo = dbx\AppInfo::loadFromJsonFile("config.json");<br /> $webAuth = new dbx\WebAuthNoRedirect($appInfo, "PHP-Example/1.0");<br /> <br /> $authorizeUrl = $webAuth->start();<br /> <br /> echo "1. Go to: " . $authorizeUrl . "\n";<br /> echo "2. Click \"Allow\" (you might have to log in first).\n";<br /> echo "3. Copy the authorization code.\n";<br /> $authCode = \trim(\readline("Enter the authorization code here: "));<br /> <br /> list($accessToken, $dropboxUserId) = $webAuth->finish($authCode);<br /> print "Access Token: " . $accessToken . "\n";<br /> <br /> $dbxClient = new dbx\Client($accessToken, "PHP-Example/1.0");<br /> $accountInfo = $dbxClient->getAccountInfo();<br /> <br /> print_r($accountInfo);<br /> <br /> $f = fopen("working-draft.txt", "rb");<br /> $result = $dbxClient->uploadFile("/working-draft.txt", dbx\WriteMode::add(), $f);<br /> fclose($f);<br /> print_r($result);<br /> <br /> $folderMetadata = $dbxClient->getMetadataWithChildren("/");<br /> print_r($folderMetadata);<br /> <br /> $f = fopen("working-draft.txt", "w+b");<br /> $fileMetadata = $dbxClient->getFile("/working-draft.txt", $f);<br /> fclose($f);<br /> print_r($fileMetadata);<br /> <br /> </pre><br /> <br /> =Autenticació automàtica oauth=<br /> El procés d'autenticació anterior era molt engorrós: havíem de visitar una URL que ens proporcionava un ''authentication code'' que podem utilitzar. Si volem que aquest procés d'autenticació sigui automàtic la cosa està fàcil, només cal enrecordar-nos del ''authentication code'' que hem obtingut en generar l'aplicació, i posar-lo en el nostre codi. En el script ficarem: (fica el teu valor)<br /> <pre><br /> ...<br /> $accessToken = "rqDdcful8VMAAAAAAAAAUtpRna8_iipCFDWI0koOlTMqkF1pXNt4iFs_IDN4R-03";<br /> $dbxClient = new dbx\Client($accessToken, "PHP-Example/1.0");<br /> ...<br /> </pre><br /> '''primer_exemple_dropbox_v2.php''':<br /> <pre><br /> <?php<br /> <br /> # Include the Dropbox SDK libraries<br /> require_once "dropbox-sdk/Dropbox/autoload.php";<br /> use \Dropbox as dbx;<br /> <br /> $appInfo = dbx\AppInfo::loadFromJsonFile("config.json");<br /> $webAuth = new dbx\WebAuthNoRedirect($appInfo, "PHP-Example/1.0");<br /> <br /> $authorizeUrl = $webAuth->start();<br /> <br /> $accessToken = "rqDdcful8VMAAAAAAAAAUtpRna8_iipCFDWI0koOlTMqkF1pXNt4iFs_IDN4R-03";<br /> $dbxClient = new dbx\Client($accessToken, "PHP-Example/1.0");<br /> $accountInfo = $dbxClient->getAccountInfo();<br /> print_r($accountInfo);<br /> <br /> $f = fopen("el_meu_fitxer.txt", "rb");<br /> $result = $dbxClient->uploadFile("/Public/el_meu_fitxer.txt", dbx\WriteMode::add(), $f);<br /> fclose($f);<br /> print_r($result);<br /> <br /> ?><br /> </pre><br /> Això és important, doncs ara podem fer scripts automàtics i cronificats. Per exemple, podem fer una còpia de bases de dades i enviar-la al Dropbox.<br /> <br /> =API de Dropbox. Python=<br /> La idea és la mateixa que amb PHP. La info està a:<br /> *https://www.dropbox.com/developers/core/start/python<br /> Primer hem d'instal.lar el Python SDK:<br /> *https://www.dropbox.com/developers/core/sdks/python<br /> Descarreguem ''dropbox-python-sdk-2.2.0.zip'', descomprimim i instal.lem.<br /> <pre><br /> $ cd dropbox-python-sdk-2.2.0<br /> $ sudo python setup.py install<br /> </pre><br /> Primer haurem de fer:<br /> <pre><br /> $ sudo apt-get install python-setuptools<br /> </pre><br /> <pre><br /> $ python primer_exemple_dropbox.py<br /> 1. Go to: https://www.dropbox.com/1/oauth2/authorize?response_type=code&client_id=fqih5rcf32yak2l<br /> 2. Click "Allow" (you might have to log in first)<br /> 3. Copy the authorization code.<br /> Enter the authorization code here:<br /> <br /> linked account: {u'referral_link': u'https://db.tt/iSr23qcS', u'display_name': u'Joan Quintana', u'uid': 329761, u'email_verified': True, u'locale': u'es_ES', u'country': u'ES', u'email': u'joanqc@gmail.com'<br /> ...<br /> </pre><br /> Script '''primer_exemple_dropbox.py'''<br /> <pre><br /> # Include the Dropbox SDK<br /> import dropbox<br /> <br /> # Get your app key and secret from the Dropbox developer website<br /> app_key = 'INSERT_APP_KEY'<br /> app_secret = 'INSERT_APP_SECRET'<br /> <br /> //app_key = 'fqih5rcf32yak2l'<br /> //app_secret = 'pyt7dcqu0cgz1l8'<br /> <br /> flow = dropbox.client.DropboxOAuth2FlowNoRedirect(app_key, app_secret)<br /> <br /> # Have the user sign in and authorize this token<br /> authorize_url = flow.start()<br /> print '1. Go to: ' + authorize_url<br /> print '2. Click "Allow" (you might have to log in first)'<br /> print '3. Copy the authorization code.'<br /> code = raw_input("Enter the authorization code here: ").strip()<br /> <br /> # This will fail if the user enters an invalid authorization code<br /> access_token, user_id = flow.finish(code)<br /> <br /> client = dropbox.client.DropboxClient(access_token)<br /> print 'linked account: ', client.account_info()<br /> <br /> f = open('working-draft.txt', 'rb')<br /> response = client.put_file('/magnum-opus.txt', f)<br /> print 'uploaded: ', response<br /> <br /> folder_metadata = client.metadata('/')<br /> print 'metadata: ', folder_metadata<br /> <br /> f, metadata = client.get_file_and_metadata('/magnum-opus.txt')<br /> out = open('magnum-opus.txt', 'wb')<br /> out.write(f.read())<br /> out.close()<br /> print metadata<br /> </pre><br /> Si ens fixem bé en el codi, estem obrint el fitxer ''working-draft.txt'' en mode lectura, i pugem el seu contingut al dropbox amb el nom de ''magnum-opus.txt''. Després llistem el contingut de l'arrel del Dropbox (/), i finalment descarreguem a l'ordinador local el fitxer ''magnum-opus.txt''.<br /> <br /> =Script administratiu cronificat. Exemple=<br /> [[Fitxer:Logs script.jpg | thumbnail]]<br /> Com a administradors de sistema, tenim scripts que s'executen de forma desatesa i que realitzen diferents tasques administratives. Pot ser interessant que el resultat d'aquests scripts (per ex, els log i fitxers generats) es puguin penjar al núvol. Entre d'altres, els avantatges de tenir-ho al núvol:<br /> *No cal preocupar-se de les còpies de seguretat.<br /> *És fàcil compartir els fitxers amb el nostre equip de treball.<br /> Anem a posar un exemple sencer.<br /> <br /> Volem executar un script administratiu que realitzarà dues tasques:<br /> *comprovar que la IP 192.168.0.15 estigui aixecada<br /> *fer un resum de l'espai del disc dur local.<br /> El resultat d'aquest test es guardarà en un ''log'', i s'enviarà el ''log'' al Dropbox un cop al dia.<br /> <br /> D'una banda tenim el script bash, que farà el ''ping'', la comanda ''df'', i farà la crida al script ''php'':<br /> <br /> script '''script_admin.sh''':<br /> <pre><br /> #!/bin/bash<br /> tdate=`date +%d%m%y`<br /> ruta=/home/joan/M09_IAW_1415/dropbox<br /> ruta_logs=/home/joan/M09_IAW_1415/dropbox/logs<br /> <br /> /bin/echo "Màquina 192.168.0.15:" > $ruta_logs/ping_$tdate.txt<br /> /bin/ping -c 3 192.168.0.15 >> $ruta_logs/ping_$tdate.txt<br /> <br /> /bin/echo >> $ruta_logs/ping_$tdate.txt<br /> /bin/echo "Espai de disc del nostre disc dur:" >> $ruta_logs/ping_$tdate.txt<br /> /bin/df -h >> $ruta_logs/ping_$tdate.txt<br /> <br /> /bin/echo $ruta_logs/ping_$tdate.txt<br /> /usr/bin/php $ruta/enviar_log_a_dropbox.php ping_$tdate.txt<br /> <br /> exit 0<br /> </pre><br /> (Fixem-nos bé que hem de crear la carpeta ''logs/'' en el nostre directori de treball, que d'altra banda és hem estat ficant els nostres scripts PHP anteriors).<br /> <br /> El script '''enviar_log_a_dropbox.php''' està basat en les proves que hem estat fent (només interessa la part del upload), i si ens fixem bé rep un argument que és el nom del log. El log en realitat té extensió ''.txt'', doncs això ens facilita la seva lectura des de dins del Dropbox.<br /> <pre><br /> <?php<br /> //passar arguments a un script PHP:<br /> //http://php.net/manual/en/reserved.variables.argv.php<br /> //var_dump($argv);<br /> $ruta = "/home/joan/M09_IAW_1415/dropbox/";<br /> $ruta_logs = "/home/joan/M09_IAW_1415/dropbox/logs/";<br /> <br /> //$ruta .= "/";<br /> $fitxer_log = $argv[1];<br /> echo $fitxer_log."\n";<br /> <br /> # Include the Dropbox SDK libraries<br /> require_once $ruta . "dropbox-sdk/Dropbox/autoload.php";<br /> <br /> use \Dropbox as dbx;<br /> <br /> $appInfo = dbx\AppInfo::loadFromJsonFile($ruta . "config.json");<br /> $webAuth = new dbx\WebAuthNoRedirect($appInfo, "PHP-Example/1.0");<br /> <br /> $authorizeUrl = $webAuth->start();<br /> <br /> $accessToken = "rqDdcful8VMAAAAAAAAAUtpRna8_iipCFDWI0koOlTMqkF1pXNt4iFs_IDN4R-03";<br /> $dbxClient = new dbx\Client($accessToken, "PHP-Example/1.0");<br /> $accountInfo = $dbxClient->getAccountInfo();<br /> //print_r($accountInfo);<br /> <br /> $f = fopen($ruta_logs . $fitxer_log, "rb");<br /> $result = $dbxClient->uploadFile("/Public/logs/$fitxer_log", dbx\WriteMode::add(), $f);<br /> fclose($f);<br /> print_r($result);<br /> <br /> ?><br /> </pre><br /> Si executem el script hauria de funcionar (recorda posar sempre les teves dades):<br /> <pre><br /> $ ./script_admin.sh logs/ping_230215.txtArray<br /> (<br /> [revision] => 216100435<br /> [bytes] => 720<br /> [thumb_exists] => <br /> [rev] => ce16e53000e6c76<br /> [modified] => Mon, 23 Feb 2015 16:19:59 +0000<br /> [shareable] => <br /> [mime_type] => text/plain<br /> [path] => /Public/logs/ping_230215 (2).txt<br /> [is_dir] => <br /> [size] => 720 bytes<br /> [root] => dropbox<br /> [client_mtime] => Mon, 23 Feb 2015 16:19:59 +0000<br /> [icon] => page_white_text<br /> )<br /> </pre><br /> I ara fiquem aquest script dins del cron. Per provar, podem fer que s'executi cada minut:<br /> <pre><br /> $ sudo joe /etc/crontab<br /> */1 * * * * root /home/joan/M09_IAW_1415/dropbox/script_admin.sh<br /> $ sudo /etc/init.d/cron restart<br /> </pre><br /> '''NOTA'''. Fixem-nos bé que tant el script bash com el php tenen '''TOTES''' les rutes del fitxer absolutes. Això és important quan hem de llençar el script des del cron.<br /> <br /> =Feina per l'alumne=<br /> Els alumnes realitzaran tots els exercicis fets a classe, solucionant els possibles problemes que vagin sortint. Concretament, s'ha de realitzar el bash script (que cerca la IP i fa el df), i configurar el cron per tal de què s'executi de forma automàtica.<br /> <br /> *''Opcional''. Un cop funcioni, des del bash script es cridarà a una versió del script ''enviar_log_a_dropbox.php'' feta amb Python.<br /> *''Opcional''. També es valorarà de forma positiva millores en el script i cercar la utilitat i justificació en la feina diària dels administradors de sistema.<br /> <br /> =Entrega=<br /> Els alumnes entregaran al Schoology tots els fitxers generats. S'empaquetaran tots aquests fitxers i es pujaran al Schoology dins del termini d'entrega de la pràctica.<br /> <br /> Recorda la '''normativa''' per entregar les pràctiques al Schoology: [[ASIX-M10-UF2#Normativa_d.27entrega_de_les_pr.C3.A0ctiques_al_Schoology]]<br /> {{Autor}}, febrer 2015</div>

Joan