API REST v1
Automatiser l’hébergement de photos avec AnonShot
Envoyez une image, créez un lien privé ou un album et retirez les métadonnées EXIF depuis votre backend. L’API prévoit déjà scopes, quotas et comptage pour de futurs plans payants.
Authentification et sécurité
Créez un jeton depuis les paramètres du compte, puis envoyez-le dans l’en-tête Authorization. Le secret complet n’est affiché qu’une fois et n’est jamais stocké en clair par AnonShot.
Authorization: Bearer anon_live_…- Scopes :
photos:read,photos:write,albums:readetalbums:write. - Jetons révocables, limite par minute, quota mensuel et journal de facturation sans fichier ni secret.
- Gardez le jeton sur votre serveur. Ne l’intégrez jamais à une application distribuée ; aucun CORS public n’est activé.
Envoyer une photo
Le multipart accepte JPEG, PNG, WebP et GIF, jusqu’à 50 Mo par fichier et 20 fichiers par requête.
curl -X POST https://anonshot.com/api/v1/photos \
+ -H "Authorization: Bearer $ANONSHOT_TOKEN" \
+ -F "files=@photo.jpg" \
+ -F "burnAfterRead=true" \
+ -F "password=un-secret-distinct"La réponse contient l’identifiant, le lien de partage et l’URL API du fichier nettoyé. Pour un upload direct, demandez des URL signées à /api/v1/uploads/presign, puis transmettez les descripteurs obtenus à /api/v1/photos.
Nettoyer les métadonnées EXIF par API
Cette route serveur accepte une image et renvoie directement un WebP nettoyé, prêt à être enregistré par votre application.
curl -X POST https://anonshot.com/api/v1/exif/clean \
+ -H "Authorization: Bearer $ANONSHOT_TOKEN" \
+ -F "files=@photo.jpg" \
+ --output photo-sans-metadonnees.webpL’en-tête X-AnonShot-Photo-Id contient l’identifiant de l’opération. JPEG, PNG et WebP sont acceptés.
Routes disponibles
| Route | Fonction |
|---|---|
| GET /api/v1 | Découverte de l’API, sans authentification |
| GET · POST /api/v1/photos | Lister ou envoyer jusqu’à 20 images |
| GET · PATCH · DELETE /api/v1/photos/{shortUrl} | Lire, modifier ou supprimer un partage |
| GET /api/v1/photos/{shortUrl}/file | Télécharger la version WebP nettoyée |
| POST /api/v1/exif/clean | Nettoyer une image et recevoir le WebP |
| POST /api/v1/uploads/presign | Préparer un upload direct vers le stockage |
| GET · POST /api/v1/albums | Lister ou créer des albums |
| GET · PATCH · DELETE /api/v1/albums/{shortUrl} | Lire, modifier ou supprimer un album |
| POST · DELETE /api/v1/albums/{shortUrl}/photos | Ajouter ou retirer des photos |
Format des réponses
Les succès JSON utilisent {"data": …}. Les erreurs utilisent {"error":{"code":"…","message":"…"}}. Les en-têtes X-RateLimit-Remaining et X-Monthly-Remaining indiquent les quotas restants.