3DEFree Tools
3DE / Développeurs

Vos workflows.
Nos outils.

Intégrez 3DE dans vos scripts et automatisations, avec une API commune et des limites claires.

100 / jourappels gratuits par compte
5 / minutequota commun à tous les outils
20 Miomaximum, selon l’opération

Clé disponible après connexion avec ChatGPT. Vous pouvez demander davantage d’appels depuis votre espace ; les augmentations sont examinées manuellement.

Compresser un PDF

Envoyez un PDF brut avec votre clé Bearer. La réponse contient directement le PDF allégé (200 pages maximum).

POST https://freetools.3de-scs.be/api/v1/pdf/compress?level=balanced
curl --fail-with-body \
  'https://freetools.3de-scs.be/api/v1/pdf/compress?level=strong' \
  -H "Authorization: Bearer $THREEDE_API_KEY" \
  -H 'Content-Type: application/pdf' \
  --data-binary @document.pdf \
  --output document-compresse.pdf

light : optimisation sans perte · balanced : compromis (défaut) · strong : réduction accrue des images compatibles.

Le texte et les tracés sont conservés. Les images non compatibles ou dépassant 2 millions de pixels restent intactes. Le gain dépend du contenu du PDF.

Compresser une image

JPEG, PNG et WebP fixes. Envoyez les octets avec le Content-Type correspondant ; la réponse est directement l’image.

POST https://freetools.3de-scs.be/api/v1/images/compress?format=webp&quality=76
curl --fail-with-body \
  'https://freetools.3de-scs.be/api/v1/images/compress?format=webp&quality=76' \
  -H "Authorization: Bearer $THREEDE_API_KEY" \
  -H 'Content-Type: image/jpeg' \
  --data-binary @photo.jpg \
  --output photo.webp

format : original (défaut), jpeg, png ou webp. quality : entier de 10 à 95, 76 par défaut, pour JPEG/WebP. Le PNG reste sans perte. Sans gain dans le même format, l’original est retourné ; une conversion peut augmenter la taille.

Redimensionner une image

POST https://freetools.3de-scs.be/api/v1/images/resize?width=1200&format=webp

Utilisez la même requête binaire avec width ou height pour conserver les proportions. Les deux axes ensemble imposent la taille exacte. Ou utilisez percent=50 (de 1 à 400), sans axes. Les options format et qualité sont identiques à la compression.

Limites API images : 20 Mio, 2 millions de pixels et 4 000 px par côté, en entrée comme en sortie pour les dimensions. Les applications locales acceptent jusqu’à 24 millions de pixels. Les animations sont refusées. L’orientation des photos est appliquée, la transparence conservée en PNG/WebP et remplacée par du blanc en JPEG.

Les réponses indiquent les dimensions dans X-Image-Width et X-Image-Height, les tailles dans X-Input-Bytes et X-Output-Bytes. X-Image-Unchanged: true indique que l’original, avec ses métadonnées, est conservé. Sinon les métadonnées sont retirées. Un redimensionnement peut produire un fichier plus lourd.

Toutes les autres opérations

PDF, images, archives, audio et données : la même clé et les mêmes quotas pour tous les outils. Une tentative admise compte pour un appel. Les API reçoivent explicitement vos fichiers ; les applications du répertoire les traitent sur votre appareil.

PDF (6)
Point d’accèsFonction et limites
POST /api/v1/pdf/mergeFusionner des PDF

Authentification Bearer et admission persistante communes à tous les traitements. 20 MiB maximum pour la requête entière, enveloppe multipart comprise, et 200 pages maximum. Une tentative admise consomme une unité de chaque quota même en cas de fichier invalide. Résultat dans un nouveau document ; les formulaires interactifs, signets et signatures numériques ne sont pas préservés.

POST /api/v1/pdf/from-imagesConvertir des images en PDF

Authentification Bearer et admission persistante communes à tous les traitements. 20 MiB maximum pour la requête entière, enveloppe multipart comprise, et 200 pages maximum. Une tentative admise consomme une unité de chaque quota même en cas de fichier invalide. Résultat dans un nouveau document ; les formulaires interactifs, signets et signatures numériques ne sont pas préservés. JPEG/PNG fixes uniquement, 2 000 000 pixels par image, 4 000 000 pixels cumulés, 12 000 pixels par côté. Une image par page A4 avec marge de 24 points, orientation selon les dimensions affichées. EXIF 1–8 appliqué sans réencodage du JPEG.

POST /api/v1/pdf/organizeExtraire, réordonner et tourner des pages PDF

Authentification Bearer et admission persistante communes à tous les traitements. 20 MiB maximum pour la requête entière, enveloppe multipart comprise, et 200 pages maximum. Une tentative admise consomme une unité de chaque quota même en cas de fichier invalide. Résultat dans un nouveau document ; les formulaires interactifs, signets et signatures numériques ne sont pas préservés.

POST /api/v1/pdf/watermarkAjouter un filigrane texte au PDF

Traitement explicite serveur, identité/quota/bail de capacité communs. Requête limitée à 20 MiB, multipart compris ; PDF déverrouillé de 200 pages maximum. Paramètres inconnus/répétés refusés. Coordonnées selon page affichée après rotation/CropBox ; une page ou un placement hors limites donne 400 invalid_request. Les modifications peuvent invalider une signature numérique existante. Le résultat peut être plus lourd. Texte latin centré, taille réduite si nécessaire ; pas de saut de ligne ni emoji.

POST /api/v1/pdf/numberNuméroter les pages du PDF

Traitement explicite serveur, identité/quota/bail de capacité communs. Requête limitée à 20 MiB, multipart compris ; PDF déverrouillé de 200 pages maximum. Paramètres inconnus/répétés refusés. Coordonnées selon page affichée après rotation/CropBox ; une page ou un placement hors limites donne 400 invalid_request. Les modifications peuvent invalider une signature numérique existante. Le résultat peut être plus lourd.

POST /api/v1/pdf/signAjouter une signature visuelle PNG au PDF

Traitement explicite serveur, identité/quota/bail de capacité communs. Requête limitée à 20 MiB, multipart compris ; PDF déverrouillé de 200 pages maximum. Paramètres inconnus/répétés refusés. Coordonnées selon page affichée après rotation/CropBox ; une page ou un placement hors limites donne 400 invalid_request. Les modifications peuvent invalider une signature numérique existante. Le résultat peut être plus lourd. Signature visuelle uniquement, sans certificat ni garantie cryptographique.

QR (1)
Point d’accèsFonction et limites
POST /api/v1/qr/generateCréer un QR code statique SVG

Traitement serveur explicite. Chaque tentative authentifiée admise consomme une unité des quotas communs par compte; refus de capacité avant admission non compté. Aucun contenu conservé ou journalisé. Identité Bearer et en-têtes de quota communs. Corps JSON limité à 16 384 octets (ou limite du compte si inférieure). Contenu encodé limité à 2 000 octets UTF-8, incluant les champs générés WIFI/vCard; dépassement du contenu: 400 invalid_request. Correction M, marge blanche de 4 modules. Les champs Wi-Fi et vCard sont échappés. Format SVG uniquement dans cette API; PNG disponible dans l’interface locale.

Texte (4)
Point d’accèsFonction et limites
POST /api/v1/text/analyzeCompter les mots et caractères

Traitement serveur explicite. Chaque tentative authentifiée admise consomme une unité des quotas communs par compte; refus de capacité avant admission non compté. Aucun contenu conservé ou journalisé. Identité Bearer et en-têtes de quota communs. Le corps JSON entier, syntaxe et échappements inclus, est limité à 1 048 576 octets (ou limite du compte si inférieure). Un mauvais type de champ ou option retourne 400 invalid_request. Les caractères sont des points de code Unicode, pas des graphèmes.

POST /api/v1/text/cleanNettoyer les espaces et sauts de ligne

Traitement serveur explicite. Chaque tentative authentifiée admise consomme une unité des quotas communs par compte; refus de capacité avant admission non compté. Aucun contenu conservé ou journalisé. Identité Bearer et en-têtes de quota communs. Le corps JSON entier, syntaxe et échappements inclus, est limité à 1 048 576 octets (ou limite du compte si inférieure). Un mauvais type de champ ou option retourne 400 invalid_request. Les caractères sont des points de code Unicode, pas des graphèmes. Le nettoyage uniformise toujours CRLF et CR en LF. Toutes les options omises prennent leur défaut. Le résultat signale changed=false quand aucun changement n’est nécessaire.

POST /api/v1/text/diffComparer deux textes ligne par ligne

Traitement serveur explicite, sans conservation ni journalisation du contenu. Authentification Bearer et quotas par compte partagés entre toutes les clés et tous les outils. Chaque tentative admise coûte une unité ; un refus de capacité avant admission ne consomme rien. Corps JSON entier limité à 1 048 576 octets, ou limite du compte si inférieure. Le dépassement du corps donne 413 file_too_large ; un champ invalide ou une limite métier dépassée donne 400 invalid_request. Limites : 1 000 lignes par texte, 200 000 unités UTF-16 au total, un million de paires de lignes. Comparaison par plus longue sous-séquence commune. CRLF/CR normalisés en LF ; espaces et ligne vide finale conservés. beforeLine existe pour equal/remove ; afterLine pour equal/add. Un texte vide représente zéro ligne.

POST /api/v1/text/base64Encoder ou décoder du texte UTF-8 Base64

Traitement serveur explicite, sans conservation ni journalisation du contenu. Authentification Bearer et quotas par compte partagés entre toutes les clés et tous les outils. Chaque tentative admise coûte une unité ; un refus de capacité avant admission ne consomme rien. Corps JSON entier limité à 1 048 576 octets, ou limite du compte si inférieure. Le dépassement du corps donne 413 file_too_large ; un champ invalide ou une limite métier dépassée donne 400 invalid_request. Base64 standard strict, padding requis lorsque nécessaire, bits de padding canoniques. Refuse espaces, préfixe data:, alphabet URL-safe et contenu décodé non UTF-8. Préserve un BOM UTF-8 encodé. Les paires Unicode incomplètes sont refusées à l’encodage. Texte vide accepté. Base64 n’est pas du chiffrement.

Images (5)
Point d’accèsFonction et limites
POST /api/v1/images/convertConvertir une image

Image fixe JPEG, PNG ou WebP brute, 20 MiB, 2 000 000 pixels et 4 000 px par côté. HEIC réservé à l’outil local (415 via API). Orientation EXIF appliquée. Réencodage systématique sans métadonnées d’origine ; JPEG/WebP avec perte, PNG sans perte, JPEG sur fond blanc. Résultat éventuellement plus lourd. Quotas/admission et capacité partagés avec les autres outils. Paramètres inconnus ou répétés refusés.

POST /api/v1/images/blurFlouter ou masquer une zone

Image fixe JPEG, PNG ou WebP brute, 20 MiB, 2 000 000 pixels et 4 000 px par côté. HEIC réservé à l’outil local (415 via API). Orientation EXIF appliquée. Réencodage systématique sans métadonnées d’origine ; JPEG/WebP avec perte, PNG sans perte, JPEG sur fond blanc. Résultat éventuellement plus lourd. Quotas/admission et capacité partagés avec les autres outils. Paramètres inconnus ou répétés refusés.

POST /api/v1/images/strip-metadataSupprimer les métadonnées d’une image

Image fixe JPEG, PNG ou WebP brute, 20 MiB, 2 000 000 pixels et 4 000 px par côté. HEIC réservé à l’outil local (415 via API). Orientation EXIF appliquée. Réencodage systématique sans métadonnées d’origine ; JPEG/WebP avec perte, PNG sans perte, JPEG sur fond blanc. Résultat éventuellement plus lourd. Quotas/admission et capacité partagés avec les autres outils. Paramètres inconnus ou répétés refusés.

POST /api/v1/images/cropRecadrer une image

Image brute fixe JPEG/PNG/WebP ; 20 MiB, 2 000 000 pixels, 4 000 px par côté. Orientation EXIF appliquée, métadonnées retirées au réencodage. Identité/admission/quota/bail de capacité communs. Les paramètres inconnus/répétés sont refusés. Région ou boîte de texte hors image : 422 invalid_image. JPEG sur blanc ; PNG sans perte, JPEG/WebP avec qualité et perte possible. Carré/cercle : dimensions égales. Cercle : PNG avec coins transparents ; format png sélectionné si absent, autre format explicite refusé400.

POST /api/v1/images/watermarkAjouter un filigrane texte à une image

Image brute fixe JPEG/PNG/WebP ; 20 MiB, 2 000 000 pixels, 4 000 px par côté. Orientation EXIF appliquée, métadonnées retirées au réencodage. Identité/admission/quota/bail de capacité communs. Les paramètres inconnus/répétés sont refusés. Région ou boîte de texte hors image : 422 invalid_image. JPEG sur blanc ; PNG sans perte, JPEG/WebP avec qualité et perte possible. Texte latin Roboto ; boîte réservée de text.length × fontSize pixels et ceil(fontSize × 1.5) pixels de hauteur, entièrement dans l’image.

Données (2)
Point d’accèsFonction et limites
POST /api/v1/data/jsonValider, formater ou minifier du JSON

Traitement serveur explicite, sans conservation ni journalisation du contenu. Authentification Bearer et quotas par compte partagés entre toutes les clés et tous les outils. Chaque tentative admise coûte une unité ; un refus de capacité avant admission ne consomme rien. Corps JSON entier limité à 1 048 576 octets, ou limite du compte si inférieure. Le dépassement du corps donne 413 file_too_large ; un champ invalide ou une limite métier dépassée donne 400 invalid_request. JSON texte limité à 1 Mio, profondeur 128. La sortie text est limitée à 8 Mio. Le formatage conserve la représentation lexicale des nombres, des chaînes et des clés dupliquées ; il ne les réécrit pas via JSON.stringify. validate retourne le texte original sans modification.

POST /api/v1/data/csvConvertir CSV et JSON

Traitement serveur explicite, sans conservation ni journalisation du contenu. Authentification Bearer et quotas par compte partagés entre toutes les clés et tous les outils. Chaque tentative admise coûte une unité ; un refus de capacité avant admission ne consomme rien. Corps JSON entier limité à 1 048 576 octets, ou limite du compte si inférieure. Le dépassement du corps donne 413 file_too_large ; un champ invalide ou une limite métier dépassée donne 400 invalid_request. 10 000 lignes de données, 200 colonnes et 100 000 cellules, en-tête compris. CSV vers JSON exige des en-têtes non vides uniques et un nombre de cellules identique par ligne. Les valeurs CSV restent des chaînes, les guillemets doublés et champs multilignes sont pris en charge. Un BOM UTF-8 initial du CSV est retiré. JSON vers CSV exige un tableau non vide d’objets à valeurs scalaires ; colonnes = union des propriétés dans l’ordre de rencontre, null/absent deviennent vides. Les grands entiers hors précision sûre sont refusés : les fournir comme chaînes. Sortie CSV CRLF sans BOM. protectFormulas est désactivé par défaut ; l’activer modifie explicitement certaines cellules et en-têtes. Résultat limité à 8 Mio.

Liens (1)
Point d’accèsFonction et limites
POST /api/v1/urls/cleanRetirer les paramètres de suivi connus

Traitement serveur explicite, sans conservation ni journalisation du contenu. Authentification Bearer et quotas par compte partagés entre toutes les clés et tous les outils. Chaque tentative admise coûte une unité ; un refus de capacité avant admission ne consomme rien. Corps JSON entier limité à 1 048 576 octets, ou limite du compte si inférieure. Le dépassement du corps donne 413 file_too_large ; un champ invalide ou une limite métier dépassée donne 400 invalid_request. Supprime utm_* et les noms gclid,fbclid,dclid,msclkid,mc_cid,mc_eid,igshid,gbraid,wbraid,ttclid,twclid,li_fat_id,vero_id,oly_anon_id,oly_enc_id,mkt_tok,sc_cid,srsltid,yclid,_ga,_gl, sans distinction de casse après décodage du nom. Préserve les paramètres inconnus, leur ordre, leur encodage et le fragment. Les noms retirés sont listés pour chaque occurrence. N’ouvre aucun lien. Ne garantit pas la validité d’un lien signé après retrait ni la suppression de tout suivi.

Calculs (2)
Point d’accèsFonction et limites
POST /api/v1/calculate/percentageCalculer un pourcentage, une variation ou une remise

Traitement serveur explicite, sans conservation ni journalisation du contenu. Authentification Bearer et quotas par compte partagés entre toutes les clés et tous les outils. Chaque tentative admise coûte une unité ; un refus de capacité avant admission ne consomme rien. Corps JSON entier limité à 1 048 576 octets, ou limite du compte si inférieure. Le dépassement du corps donne 413 file_too_large ; un champ invalide ou une limite métier dépassée donne 400 invalid_request. of : value × percent / 100. proportion : part / whole × 100. change : (to − from) / abs(from) × 100 ; cette convention est explicite pour départ négatif. discount : price − price × percent / 100. Zéro accepté sauf dénominateur nul, prix non négatif, remise 0–100. Nombres finis et résultats finis obligatoires. Précision IEEE-754, sans arrondi monétaire automatique.

POST /api/v1/calculate/dateCalculer une durée ou décaler une date

Traitement serveur explicite, sans conservation ni journalisation du contenu. Authentification Bearer et quotas par compte partagés entre toutes les clés et tous les outils. Chaque tentative admise coûte une unité ; un refus de capacité avant admission ne consomme rien. Corps JSON entier limité à 1 048 576 octets, ou limite du compte si inférieure. Le dépassement du corps donne 413 file_too_large ; un champ invalide ou une limite métier dépassée donne 400 invalid_request. Dates réelles AAAA-MM-JJ entre 0001 et 9999. difference calcule end − start en jours UTC signés, sans inclusion supplémentaire de la borne de fin. add applique les mois avant les jours, avec jour ramené au dernier jour du mois cible si nécessaire, puis jours calendaires UTC. Deltas entiers ; résultat hors plage refusé. Les heures et fuseaux ne sont pas acceptés.

Couleurs (1)
Point d’accèsFonction et limites
POST /api/v1/colors/analyzeConvertir les couleurs et mesurer le contraste WCAG

Traitement serveur explicite, sans conservation ni journalisation du contenu. Authentification Bearer et quotas par compte partagés entre toutes les clés et tous les outils. Chaque tentative admise coûte une unité ; un refus de capacité avant admission ne consomme rien. Corps JSON entier limité à 1 048 576 octets, ou limite du compte si inférieure. Le dépassement du corps donne 413 file_too_large ; un champ invalide ou une limite métier dépassée donne 400 invalid_request. Alpha, rgba/hsla, transparence et couleurs nommées refusés. sRGB 8 bits : RGB entiers 0–255 ; HSL converti puis arrondi aux canaux entiers. HSL retourné arrondi à deux décimales. Ratio calculé selon luminance sRGB WCAG avec seuil 0.04045 ; conformité évaluée AVANT tout arrondi d’affichage. AA normal ≥4.5, AA large ≥3, AAA normal ≥7, AAA large ≥4.5. Le ratio seul n’est pas un audit complet.

Fichiers (3)
Point d’accèsFonction et limites
POST /api/v1/archives/createCréer une archive ZIP

Authentification Bearer, compte, admission et quotas communs. Chaque tentative admise consomme une unité, succès ou erreur. Requête entière limitée à 20 MiB (20 971 520 octets), enveloppe multipart comprise, ou limite du compte si inférieure. Pas de conservation des fichiers, pas de cache, pas de déduplication ni relance automatique. Au plus 100 fichiers/entrées. Noms UTF-8/ASCII de 240 octets maximum ; chemins absolus, traversal, liens symboliques, noms ambigus/collisions insensibles à la casse, ZIP chiffrés et ZIP64 refusés. Le ZIP de sortie utilise le mode stockage : aucun gain de compression garanti ; sa taille peut dépasser légèrement 20 MiB du fait des en-têtes ZIP.

POST /api/v1/archives/extractExtraire et normaliser une archive ZIP

Authentification Bearer, compte, admission et quotas communs. Chaque tentative admise consomme une unité, succès ou erreur. Requête entière limitée à 20 MiB (20 971 520 octets), enveloppe multipart comprise, ou limite du compte si inférieure. Pas de conservation des fichiers, pas de cache, pas de déduplication ni relance automatique. Au plus 100 fichiers/entrées. Noms UTF-8/ASCII de 240 octets maximum ; chemins absolus, traversal, liens symboliques, noms ambigus/collisions insensibles à la casse, ZIP chiffrés et ZIP64 refusés. Le ZIP de sortie utilise le mode stockage : aucun gain de compression garanti ; sa taille peut dépasser légèrement 20 MiB du fait des en-têtes ZIP. Décompression bornée à 20 MiB cumulés, contrôlée avant allocation puis pendant chaque expansion. Formats d’entrée stockage et Deflate. CRC32 et tailles validés. Renvoie un ZIP normalisé contenant les fichiers décompressés, en mode stockage ; aucun JSON/base64. Noms et dossiers non vides conservés, dossiers vides/commentaires/attributs/timestamps retirés.

POST /api/v1/files/renameRenommer des copies de fichiers dans un ZIP

Authentification Bearer, compte, admission et quotas communs. Chaque tentative admise consomme une unité, succès ou erreur. Requête entière limitée à 20 MiB (20 971 520 octets), enveloppe multipart comprise, ou limite du compte si inférieure. Pas de conservation des fichiers, pas de cache, pas de déduplication ni relance automatique. Au plus 100 fichiers/entrées. Noms UTF-8/ASCII de 240 octets maximum ; chemins absolus, traversal, liens symboliques, noms ambigus/collisions insensibles à la casse, ZIP chiffrés et ZIP64 refusés. Le ZIP de sortie utilise le mode stockage : aucun gain de compression garanti ; sa taille peut dépasser légèrement 20 MiB du fait des en-têtes ZIP. Ordre du nom : préfixe, numéro suivi de tiret si activé, nom sans extension après remplacement littéral sensible à la casse, suffixe, extension originale. Numérotation dans l’ordre de transmission. Les contenus ne changent pas ; pas de renommage sur le système du client.

Audio (2)
Point d’accèsFonction et limites
POST /api/v1/audio/trimDécouper un WAV PCM

Authentification Bearer, compte, admission et quotas communs. Chaque tentative admise consomme une unité, succès ou erreur. Requête entière limitée à 20 MiB (20 971 520 octets), enveloppe multipart comprise, ou limite du compte si inférieure. Pas de conservation des fichiers, pas de cache, pas de déduplication ni relance automatique. WAV RIFF PCM entier 8/16/24/32 bits ou IEEE float32, 1–2 canaux, fréquence source de 8 à 96 kHz, 10 minutes maximum. Les WAV extensibles/compressés ou à blocs data multiples sont refusés. Sortie PCM16 limitée à 20 MiB, fréquence/canaux conservés sauf options. Le passage stéréo vers mono moyenne les canaux ; mono vers stéréo duplique le canal. Rééchantillonnage linéaire, métadonnées retirées.

POST /api/v1/audio/convertConvertir fréquence et canaux d’un WAV PCM

Authentification Bearer, compte, admission et quotas communs. Chaque tentative admise consomme une unité, succès ou erreur. Requête entière limitée à 20 MiB (20 971 520 octets), enveloppe multipart comprise, ou limite du compte si inférieure. Pas de conservation des fichiers, pas de cache, pas de déduplication ni relance automatique. WAV RIFF PCM entier 8/16/24/32 bits ou IEEE float32, 1–2 canaux, fréquence source de 8 à 96 kHz, 10 minutes maximum. Les WAV extensibles/compressés ou à blocs data multiples sont refusés. Sortie PCM16 limitée à 20 MiB, fréquence/canaux conservés sauf options. Le passage stéréo vers mono moyenne les canaux ; mono vers stéréo duplique le canal. Rééchantillonnage linéaire, métadonnées retirées.

Les paramètres, exemples et schémas des réponses sont dans la spécification OpenAPI. Vérifiez le statut HTTP avant d’enregistrer une réponse comme fichier.

Fonctions réservées au navigateur

PDF vers images et extraction audio des vidéos dépendent des moteurs du navigateur et n’ont pas d’API serveur. Les API audio acceptent le WAV PCM pris en charge ; les interfaces peuvent aussi décoder les formats reconnus par votre navigateur. HEIC et export QR PNG restent également locaux. Les différences de tailles et formats figurent dans chaque opération.

Créer un QR code

curl --silent --show-error --fail-with-body \
  'https://freetools.3de-scs.be/api/v1/qr/generate' \
  -H "Authorization: Bearer $THREEDE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"kind":"url","url":"https://example.com"}'

La réponse réussie contient un SVG. Pour un QR Wi-Fi ou un contact, adaptez les champs selon le schéma. Le téléchargement PNG est disponible dans l’outil local.

Analyser un texte

curl --silent --show-error --fail-with-body \
  'https://freetools.3de-scs.be/api/v1/text/analyze' \
  -H "Authorization: Bearer $THREEDE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"text":"Bonjour le monde"}'

Les textes et fichiers ne sont pas conservés. Pour le nettoyage de texte, utilisez /text/clean avec les options souhaitées.

Consulter votre usage

GET https://freetools.3de-scs.be/api/v1/usage

Ce point d’accès nécessite la même clé et ne consomme pas votre quota de traitement. Les réponses indiquent les appels restants et les prochaines remises à zéro.

Les quotas sont appliqués atomiquement côté serveur à toutes les clés du compte. La journée commence à 00:00 UTC ; la limite minute utilise des fenêtres fixes.

Des réponses prévisibles

StatutSignification
400Paramètres ou données invalides
401 / 403Clé invalide, révoquée ou compte suspendu
413 / 415 / 422Fichier trop lourd, format non accepté ou fichier impossible à traiter
429Quota atteint ; respectez l’en-tête Retry-After
503Capacité temporairement occupée ; réessayez après Retry-After

Chaque réponse possède un identifiant X-Request-Id. Les erreurs applicatives sont des objets JSON avec error.code et error.message. Les tentatives admises sont décomptées, même lorsqu’elles produisent une erreur. Les POST ne sont pas dédupliqués automatiquement.

Confidentialité et disponibilité

L’API traite votre fichier sur le serveur, en mémoire, puis renvoie le résultat. Aucun fichier ni contenu traité n’est enregistré dans notre base ou notre stockage de fichiers. Les clés sont stockées sous forme d’empreintes ; l’identité du compte, les compteurs et les demandes de quota sont conservés pour gérer l’accès.

Le service limite les traitements simultanés par un verrou temporaire et peut refuser une requête si elle est occupée. Elle nécessite une connexion internet et s’utilise côté serveur : aucune ouverture CORS des clés dans les pages publiques.

Pour garder les fichiers sur votre appareil, utilisez nos applications locales, gratuites et sans clé.