Téléchargez un document
download
GET https://collaboractor.com/api/v1/download/file?login=&password=&lang=
file est le nom du fichier dans votre espace personnel à télécharger.
login | Votre code d'identification. |
---|---|
password | Votre mot de passe. |
$ curl -X GET "https://collaboractor.com/api/v1/download/file_sample_500kB.doc"?login=abcdef&password=ABCDEF" > file_sample_500kB.doc
Si le nom du fichier est invalide, le service retourne l'erreur HTTP/1.1 400 Bad Request
.
Si aucun fichier n'a le nom spécifié dans votre espace personnel, le service retourne l'erreur HTTP/1.1 404 Not Found
.
Téléchargez le code de la fonction sendget
de la librairie iZend.
Copiez le fichier dans l'espace de votre application.
NOTE : Reportez-vous à la page Appelez l'API du service pour une description de la fonction sendget
.
Ajoutez le fichier filedownload.php avec le contenu suivant :
- require_once 'sendhttp.php';
Charge le code de la fonction sendget
.
- function file_download($login, $password, $filename) {
Définit la fonction file_download
.
$login
est votre code d'identification. $password
est votre mot de passe.
$filename
est le nom du fichier à télécharger.
- $curl = 'https://collaboractor.com/api/v1/download/' . urlencode($filename);
Met $curl
à l'URL de l'action download avec le nom du fichier à télécharger.
- $args = array(
- 'login' => $login,
- 'password' => $password,
- );
Prépare la liste des arguments du GET : le code d'identification et le mot de passe du compte de l'utilisateur.
- $response=sendget($curl, $args);
Envoie la requête HTTP avec sendget
.
- if (!$response or $response[0] != 200) {
- return false;
- }
Si $response
vaut false
, le serveur est inaccessible.
Si $response[0]
ne contient pas le code de retour HTTP 200 Ok, une erreur d'exécution s'est produite.
En cas d'erreur, file_download
retourne false.
- return file_put_contents($filename, $response[2]);
- }
Sauve le document dans un fichier du même nom dans le répertoire courant.
Retourne true
si le fichier a bien été créé, sinon false
.
EXEMPLE
En supposant que vous avez sauvé les fichiers sendhttp.php et filedownload.php dans le répertoire courant, lancez PHP en mode interactif, chargez la fonction file_download
et appelez-la avec en arguments votre code d'identification et votre mot de passe, le nom du fichier à télécharger :
$ php -a
php > require_once 'filedownload.php';
php > echo file_download('abcdef', 'ABCDEF', 'file_sample_500kB.doc') ? 'Ok' : 'Ko';
Ok
php > quit
Vérifiez le document :
$ libreoffice file_sample_500kB.doc
NOTE : Si file_download
retourne false
, éditez le code pour afficher $response
.
VOIR AUSSI
Appelez l'API du service, Téléversez un document, Supprimez un document
Commentaires