Documentation de l'API

Démarrage rapide

Notre API est entièrement gratuite et ne nécessite aucune authentification. Il suffit d'envoyer des requêtes HTTP aux endpoints.

URL de base: https://fancytextdecorator.com/api.php

Limite de débit: 100 requêtes par heure par IP

Format de réponse: JSON

Localisation

Tous les endpoints acceptent un paramètre optionnel lang pour renvoyer des champs name et url spécifiques à la locale. Valeurs prises en charge : en, es, fr, tr. Sans ce paramètre, la réponse est en anglais par défaut. Les messages d'erreur restent en anglais quelle que soit la locale — ils s'adressent aux développeurs, pas aux utilisateurs finaux.

Paramètres:

Paramètre	Type	Requis	Description
lang	string	Non	Code de locale — parmi en, es, fr, tr. Vaut en par défaut si omis ou invalide.

Exemple : réponse localisée pour ?lang=tr:

curl https://fancytextdecorator.com/api.php?action=get_generator&slug=aesthetic&lang=tr

{
  "success": true,
  "lang": "tr",
  "generator": {
    "slug": "aesthetic",
    "name": "Estetik",
    "url": "https://fancytextdecorator.com/tr/aesthetic-text-generator",
    "example": "ａｅｓｔｈｅｔｉｃ",
    "characters": { ... }
  }
}

GET Lister tous les générateurs

Endpoint: /api.php?action=list_generators

Récupère la liste de tous les générateurs de texte disponibles.

Exemple de requête:

curl https://fancytextdecorator.com/api.php?action=list_generators

Exemple de réponse:

{
  "success": true,
  "count": 150,
  "generators": [
    {
      "slug": "aesthetic",
      "name": "Aesthetic",
      "url": "https://fancytextdecorator.com/aesthetic-text-generator",
      "example": "ａｅｓｔｈｅｔｉｃ"
    }
  ]
}

GET Détails d'un générateur

Endpoint: /api.php?action=get_generator&slug={slug}

Récupère les détails d'un générateur spécifique, y compris sa table de caractères.

Paramètres:

Paramètre	Type	Requis	Description
slug	string	Oui	Identifiant du générateur (par exemple, « aesthetic », « bold », « italic »)

Exemple de requête:

curl https://fancytextdecorator.com/api.php?action=get_generator&slug=aesthetic

Exemple de réponse:

{
  "success": true,
  "generator": {
    "slug": "aesthetic",
    "name": "Aesthetic",
    "url": "https://fancytextdecorator.com/aesthetic-text-generator",
    "example": "ａｅｓｔｈｅｔｉｃ",
    "characters": {
      "a": "ａ",
      "b": "ｂ"
    }
  }
}

POST Transformer du texte

Endpoint: /api.php?action=generate

Transforme du texte brut en texte Unicode stylé à l'aide d'un générateur spécifique.

Paramètres:

Paramètre	Type	Requis	Description
slug	string	Oui	Identifiant du générateur
text	string	Oui	Texte à transformer
update_stats	boolean	Non	Mettre à jour les statistiques d'utilisation (par défaut : true)

Exemple de requête:

curl -X POST https://fancytextdecorator.com/api.php \
  -d "action=generate" \
  -d "slug=aesthetic" \
  -d "text=Hello World"

Exemple de réponse:

{
  "success": true,
  "input": "Hello World",
  "output": "Ｈｅｌｌｏ Ｗｏｒｌｄ",
  "generator": "aesthetic",
  "length": {
    "input": 11,
    "output": 11
  }
}

GET Récupérer les statistiques

Endpoint: /api.php?action=stats

Récupère les statistiques d'utilisation actuelles.

Exemple de requête:

curl https://fancytextdecorator.com/api.php?action=stats

Exemple de réponse:

{
  "success": true,
  "statistics": {
    "sets": 150,
    "uses": 1583,
    "characters": 79480
  }
}

Gestion des erreurs

Toutes les erreurs renvoient une réponse JSON avec success: false et le code de statut HTTP approprié.

Codes d'erreur courants:

Code	Description
400	Mauvaise requête — Paramètres manquants ou invalides
404	Introuvable — Le générateur n'existe pas
429	Limite de débit dépassée — Trop de requêtes
500	Erreur interne du serveur

Exemple de réponse d'erreur:

{
  "success": false,
  "error": "Generator not found",
  "message": "The requested generator does not exist"
}

Exemples de code

JavaScript (Fetch API)

// List all generators
fetch('https://fancytextdecorator.com/api.php?action=list_generators')
  .then(response => response.json())
  .then(data => console.log(data.generators));

// Transform text
fetch('https://fancytextdecorator.com/api.php', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({
    action: 'generate',
    slug: 'aesthetic',
    text: 'Hello World'
  })
})
  .then(response => response.json())
  .then(data => console.log(data.output));

Python

import requests

# List all generators
response = requests.get(
    'https://fancytextdecorator.com/api.php',
    params={'action': 'list_generators'}
)
print(response.json())

# Transform text
response = requests.post(
    'https://fancytextdecorator.com/api.php',
    data={
        'action': 'generate',
        'slug': 'aesthetic',
        'text': 'Hello World'
    }
)
print(response.json()['output'])

PHP

// Transform text
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://fancytextdecorator.com/api.php');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'action' => 'generate',
    'slug' => 'aesthetic',
    'text' => 'Hello World'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo $data['output'];

Limitation de débit

Pour garantir un usage équitable, nous limitons les requêtes API à 100 requêtes par heure par adresse IP.

Si vous dépassez la limite, vous recevrez une réponse 429 Too Many Requests contenant un champ retry_after qui indique quand vous pourrez à nouveau envoyer des requêtes.

Réponse en cas de dépassement:

{
  "success": false,
  "error": "Rate limit exceeded",
  "message": "Maximum 100 requests per hour allowed",
  "retry_after": 1847
}

Assistance

Besoin d'aide ou vous avez des questions ? Contactez-nous :

• 📧 E-mail: [email protected]
• 🐦 Twitter: @textdecorator
• 💬 GitHub Issues: Signaler un bug