Retrouvez-ci dessous la liste des API proposées, un descriptif de leur fonctionnement ainsi qu'un exemple d'appel.
Attention : les appels aux API sont loggés, par conséquent, les API ne sont disponibles qu'aux utilisateurs enregistrés.
Cliquez sur le bouton ci-dessous pour afficher l'aide technique générale à la mise en place de votre appel API.
Affiche la liste des albums créés par l'utilisateur enregistré.
Paramètres (headers) :
x-api-key : clé API de l'utilisateur [GUID, requis]
Appel (exemple) :
GET /API/GetAlbums HTTP/1.1
Host: https://rehost.diberie.com
x-api-key: [votre clé API ici]
Sortie (exemple) :
[{
"IdAlbum": 0,
"IdUser": 2,
"Name": "[Dossier racine]",
"Description": null,
"DateCreated": "\"2020-02-20T10:27:20.73\"",
"DateUpdated": null,
"DateDeleted": "null",
"PictureCount": 10
},
...
]
Affiche la liste des liens générés par Rehost pour l'image demandée.
Paramètres (headers) :
x-api-key : clé API de l'utilisateur [GUID, requis]
pictureId : ID de l'image pour laquelle on souhaite afficher les liens [Entier, requis]
Appel (exemple) :
GET /API/GetLinks HTTP/1.1
Host: https://rehost.diberie.com
x-api-key: [votre clé API ici]
pictureId: [ID de l'image]
Sortie (exemple) :
{
"IdPicture": 38358,
"IdAlbum": 83,
"IdUser": 2,
"PictureViewCount": 1,
"IsPrivate": false,
"OriginalFilename": "doom-logo-big.png",
"DateUploaded": "\"2021-04-08T10:56:10.42\"",
"Comment": "",
"PictureURLFull": "https://rehost.diberie.com/Picture/Get/f/38358",
"PictureURLResized": "https://rehost.diberie.com/Picture/Get/r/38358",
"PictureURLThumbnail": "https://rehost.diberie.com/Picture/Get/t/38358",
"PictureBBFull": "[img]https://rehost.diberie.com/Picture/Get/f/38358[/img]",
"PictureBBResized": "[img]https://rehost.diberie.com/Picture/Get/r/38358[/img]",
"PictureBBThumbnail": "[img]https://rehost.diberie.com/Picture/Get/t/38358[/img]",
"PictureBBLinkFull": "[url=https://rehost.diberie.com/Picture/Get/f/38358][img]https://rehost.diberie.com/Uploads/2/20210408-105610-3114e54c-a439-4300-8fe8-48804dea7ace.2.pic.png[/img][/url]",
"PictureBBLinkResized": "[url=https://rehost.diberie.com/Picture/Get/f/38358][img]https://rehost.diberie.com/Uploads/2/20210408-105610-3114e54c-a439-4300-8fe8-48804dea7ace.2.res.jpg[/img][/url]",
"PictureBBLinkThumbnail": "[url=https://rehost.diberie.com/Picture/Get/f/38358][img]https://rehost.diberie.com/Uploads/2/20210408-105610-3114e54c-a439-4300-8fe8-48804dea7ace.2.min.jpg[/img][/url]"
}
Affiche la liste des images non supprimées de l'utilisateur, filtrée ou pas sur un album donné.
Si aucun ID d'album n'est fourni, la liste de toutes les images de l'utilisateur est fournie.
Paramètres (headers) :
x-api-key : clé API de l'utilisateur [GUID, requis]
albumId : ID de l'album dont on veut lister les images [Entier, optionnel]
Appel (exemple) :
GET /API/GetPictures HTTP/1.1
Host: https://rehost.diberie.com
x-api-key: [votre clé API ici]
albumId: [ID de l'album]
Sortie (exemple) :
[{
"IdPicture": 20880,
"IdAlbum": 7,
"IdUser": 2,
"PictureViewCount": 40,
"IsPrivate": false,
"OriginalFilename": "2020-05-31 10_53_28-Se connecter - Rehost - Personnel - Microsoft Edge.png",
"DateUploaded": "\"2020-05-31T10:54:44.423\"",
"Comment": null,
"PictureURLFull": "https://rehost.diberie.com/Picture/Get/f/20880",
"PictureURLResized": "https://rehost.diberie.com/Picture/Get/r/20880",
"PictureURLThumbnail": "https://rehost.diberie.com/Picture/Get/t/20880",
"PictureBBFull": "[img]https://rehost.diberie.com/Picture/Get/f/20880[/img]",
"PictureBBResized": "[img]https://rehost.diberie.com/Picture/Get/r/20880[/img]",
"PictureBBThumbnail": "[img]https://rehost.diberie.com/Picture/Get/t/20880[/img]",
"PictureBBLinkFull": "[url=https://rehost.diberie.com/Picture/Get/f/20880][img]https://rehost.diberie.com/Uploads/2/20200531-105444-76ed8baa-eda5-448f-b13b-f46315503e8f.2.pic.png[/img][/url]",
"PictureBBLinkResized": "[url=https://rehost.diberie.com/Picture/Get/f/20880][img]https://rehost.diberie.com/Uploads/2/20200531-105444-76ed8baa-eda5-448f-b13b-f46315503e8f.2.res.jpg[/img][/url]",
"PictureBBLinkThumbnail": "[url=https://rehost.diberie.com/Picture/Get/f/20880][img]https://rehost.diberie.com/Uploads/2/20200531-105444-76ed8baa-eda5-448f-b13b-f46315503e8f.2.min.jpg[/img][/url]"
},
[...]
]
Télécharge l'image pointée par l'URL fournie (formats pris en charge identiques aux autres méthodes d'upload)
et retourne l'image hostée à la taille choisie (optionnel).
Cette API ne sauvegarde pas l'image dans la gallerie de l'utilisateur, elle ne fait que Rehoster l'image.
NB : Cette API peut être appelée depuis la barre d'adresse du navigateur, ou une balise image, elle accepte des paramètres d'URL,
mais ne prend pas en charge les paramètres d'en-têtes (headers) HTTP.
Paramètres (URL) :
url= : URL de l'image à rehoster [URL, requis]
size= : Spécifie la taille de sortie désirée (pleine, redimensionnée, miniature) [full|res|min, optionnel]
lifespan= : Spécifie la durée de vie désirée avant auto suppression (infinie, 1j, 2j, 3j, 7j, 30j, Automatique) [0|1|2|3|7|30|A, optionnel]
Appel (exemple) :
https://rehost.diberie.com/Rehost?url=https://mydomain.com/images/test/maxresdefault.jpg&size=min&lifespan=2
Sortie (exemple) :
Télécharge l'image pointée par l'URL fournie (formats pris en charge identiques aux autres méthodes d'upload) et la stocke dans l'album fourni.
Si aucun album n'est fourni, l'image sera stocké dans l'album racine de l'utilisateur.
Paramètres (headers) :
x-api-key : clé API de l'utilisateur [GUID, requis]
picURL : URL de l'image source à télécharger [URL, requis]
albumId : ID de l'album dans lequel uploader l'image [Entier, optionnel]
isPrivate : Spécifie si l'image uploadée doit être privée ou non [Booléen, optionnel]
keepTags : Spécifie si les éventuelles métadonnées EXIF de l'image doivent être conservés [Booléen, optionnel]
lifespan : Spécifie la durée de vie désirée avant auto suppression (infinie, 1j, 2j, 3j) [0|1|2|3, optionnel]
Appel (exemple) :
POST /API/Upload HTTP/1.1
Host: https://rehost.diberie.com
x-api-key: [votre clé API ici]
picURL: [URL de la source]
albumId: [ID de l'album]
isPrivate: [true|false]
keepTags: [true|false]
lifespan: [0|1|2|3]
Sortie (exemple) :
{
"IdPicture": 30716,
"IdAlbum": 7,
"IdUser": 2,
"PictureViewCount": 0,
"IsPrivate": true,
"OriginalFilename": "Webp.net-resizeimage-3-768x443.jpg",
"DateUploaded": "\"2021-09-13T14:24:14.247\"",
"Comment": "[Source : https://www.dtgtesting.com/wp-content/uploads/2020/01/Webp.net-resizeimage-3-768x443.jpg]",
"PictureURLFull": "https://rehost.diberie.com/Picture/Get/f/30716",
"PictureURLResized": "https://rehost.diberie.com/Picture/Get/r/30716",
"PictureURLThumbnail": "https://rehost.diberie.com/Picture/Get/t/30716",
"PictureBBFull": "[img]https://rehost.diberie.com/Picture/Get/f/30716[/img]",
"PictureBBResized": "[img]https://rehost.diberie.com/Picture/Get/r/30716[/img]",
"PictureBBThumbnail": "[img]https://rehost.diberie.com/Picture/Get/t/30716[/img]",
"PictureBBLinkFull": "[url=https://rehost.diberie.com/Picture/Get/f/30716][img]https://rehost.diberie.com/Uploads/2/20210913-142414-4b998163-058c-4918-8717-8a2c7cb807b3.2.pic.jpg[/img][/url]",
"PictureBBLinkResized": "[url=https://rehost.diberie.com/Picture/Get/f/30716][img]https://rehost.diberie.com/Uploads/2/20210913-142414-4b998163-058c-4918-8717-8a2c7cb807b3.2.res.jpg[/img][/url]",
"PictureBBLinkThumbnail": "[url=https://rehost.diberie.com/Picture/Get/f/30716][img]https://rehost.diberie.com/Uploads/2/20210913-142414-4b998163-058c-4918-8717-8a2c7cb807b3.2.min.jpg[/img][/url]"
}