L'API v1 de Freeimage.host permet de téléverser des images.
Clé API
Appel à l'API
Méthode de requête
Les appels à l'API v1 peuvent être effectués avec les méthodes de requête POST ou GET, mais comme les requêtes GET sont limitées par la longueur maximale autorisée d'une URL, vous devriez privilégier la méthode POST.
URL de la requête
Paramètres
- clé (obligatoire) La clé API.
- action Ce que vous souhaitez faire [valeurs : upload].
- source Soit l'URL d'une image, soit une chaîne d'image encodée en base64. Vous pouvez aussi utiliser FILES["source"] dans votre requête.
- format Définit le format de retour [valeurs : json (par défaut), redirect, txt].
Exemple d'appel
Remarque : utilisez toujours POST lors du téléversement de fichiers locaux. L'encodage d'URL peut altérer la source base64 en raison des caractères encodés ou simplement à cause de la limite de longueur des requêtes URL en GET.
Réponse de l'API
Les réponses de l'API v1 affichent toutes les informations de l'image téléversée au format JSON.
Dans la réponse JSON, les en-têtes contiendront des codes d'état pour vous permettre de repérer facilement si la requête était OK ou non. Elle produira également les statut propriétés.