Documentation de l’API d’envoi d’images

Authentification

Chaque requête doit envoyer l’identifiant attribué et la clé API correspondante dans les en-têtes.

• X-API-User-ID: assigned-user-id
• Authorization: Bearer mtu_live_your_key

Utilisation

Envoyez multipart/form-data. Utilisez file une fois pour une image ou répétez le champ pour un lot.

Envoyer une image

curl "https://api.mini-tools.uk/v1/upload" \
  -H "X-API-User-ID: assigned-user-id" \
  -H "Authorization: Bearer mtu_live_your_key" \
  -F "duration=7-day" \
  -F "file=@image.png"

Envoyer plusieurs images

curl "https://api.mini-tools.uk/v1/upload" \
  -H "X-API-User-ID: assigned-user-id" \
  -H "Authorization: Bearer mtu_live_your_key" \
  -F "duration=7-day" \
  -F "file=@first.png" \
  -F "file=@second.webp"

Nouvelles tentatives sûres

Pour un envoi susceptible d’être relancé, utilisez un Idempotency-Key unique. La même requête avec la même clé renvoie le premier résultat sans nouvel envoi ni double consommation du quota. Des fichiers différents avec la même clé renvoient HTTP 409.

Idempotency-Key: upload-request-001

Champs de requête

Réponse d’envoi

Un succès complet renvoie HTTP 201. Un lot partiellement réussi renvoie HTTP 207 et détaille chaque résultat.

{
  "success": true,
  "partial": false,
  "uploaded": [
    {
      "success": true,
      "key": "7-day/example.png",
      "url": "https://pub.mini-tools.uk/7-day/example.png",
      "duration": "7-day",
      "expires_at": "2026-08-05T12:00:00.000Z",
      "size": 24831,
      "mime": "image/png",
      "risk": "normal"
    }
  ],
  "failed": [],
  "usage": {
    "user_id": "assigned-user-id",
    "plan_type": "custom",
    "temporary": {
      "enabled": true,
      "limit": 100,
      "used": 1,
      "remaining": 99,
      "reset_at": "2026-08-05T16:00:00.000Z",
      "timezone": "Asia/Shanghai"
    },
    "permanent": {
      "enabled": false,
      "limit": 0,
      "used": 0,
      "remaining": 0
    },
    "usage_date": "2026-08-05"
  }
}

Champs renvoyés

Obtenir le quota utilisé et restant

Appelez cet endpoint avant ou après un envoi. La consultation ne consomme aucun quota.

curl "https://api.mini-tools.uk/v1/usage" \
  -H "X-API-User-ID: assigned-user-id" \
  -H "Authorization: Bearer mtu_live_your_key"

{
  "success": true,
  "usage": {
    "user_id": "assigned-user-id",
    "plan_type": "custom",
    "temporary": {
      "enabled": true,
      "limit": 100,
      "used": 24,
      "remaining": 76,
      "reset_at": "2026-08-05T16:00:00.000Z",
      "timezone": "Asia/Shanghai"
    },
    "permanent": {
      "enabled": false,
      "limit": 0,
      "used": 0,
      "remaining": 0
    },
    "usage_date": "2026-08-05"
  }
}

Consulter l’historique des envois

Renvoie uniquement les envois actifs de l’utilisateur API actuel. Chaque URL publique est directement utilisable. La durée, l’expiration et l’état de contrôle ne sont pas inclus.

curl "https://api.mini-tools.uk/v1/images?limit=20" \
  -H "X-API-User-ID: assigned-user-id" \
  -H "Authorization: Bearer mtu_live_your_key"

{
  "success": true,
  "records": [
    {
      "key": "7-day/example.png",
      "url": "https://pub.mini-tools.uk/7-day/example.png",
      "size": 24831,
      "mime": "image/png",
      "uploaded_at": "2026-08-05T12:00:00.000Z"
    }
  ],
  "next_cursor": null
}

limit vaut 20 par défaut et 100 au maximum. Lorsque next_cursor n’est pas null, transmettez-le comme paramètre cursor pour obtenir la page suivante.

Supprimer une image envoyée

Supprime une image de l’utilisateur API authentifié. Les images d’un autre utilisateur ne peuvent pas être supprimées. La suppression ne restaure pas le quota quotidien ou permanent.

curl -X DELETE "https://api.mini-tools.uk/v1/images/7-day/example.png" \
  -H "X-API-User-ID: assigned-user-id" \
  -H "Authorization: Bearer mtu_live_your_key"

{
  "success": true,
  "deleted": {
    "key": "7-day/example.png",
    "url": "https://pub.mini-tools.uk/7-day/example.png"
  }
}

Limites

• Formats acceptés : JPG, PNG, GIF et WebP.
• 5 Mo maximum par image.
• 10 images et 25 Mo au total par requête.
• Durée : 1-day, 7-day, 30-day ou permanent, selon les droits du compte.
• Seules les images réussies consomment le quota. Les quotas temporaires sont réinitialisés à minuit dans Asia/Shanghai ; les quotas permanents sont globaux.
• Utilisez un Idempotency-Key unique pour les envois susceptibles d’être relancés afin d’éviter les doublons et la double consommation du quota.
• Les identifiants API ne sont activés qu’après vérification de l’adresse e-mail par l’administrateur. Les envois API restent soumis au contrôle du contenu.
• Les mêmes règles s’appliquent aux envois API et Web. Les images illégales, nuisibles, privées ou contrefaisantes peuvent être supprimées.

Codes HTTP

• 200 Consultation ou suppression réussie.
• 201 Toutes les images ont été envoyées.
• 207 Lot partiellement réussi.
• 400 / 413 / 415 Requête, nombre, taille ou contenu invalide.
• 401 / 403 Identifiants invalides, compte désactivé ou type non autorisé.
• 404 L’image n’existe pas ou n’appartient pas à l’utilisateur API actuel.
• 409 L’Idempotency-Key est en cours de traitement ou a été réutilisé pour un autre envoi.
• 429 Quota quotidien ou permanent épuisé.
• 503 Base API temporairement indisponible.

Cas d’usage

• Envoyer des captures depuis un flux de déploiement ou de test.
• Envoyer plusieurs images de produit ou de documentation.
• Vérifier le quota avant un lot automatisé.

Outils associés

FAQ