Principes fondamentaux de l'API

L'API Développeur Fit-it-on offre un accès programmatique à nos modèles de génération d'IA. Elle suit les styles architecturaux REST standard, utilise des URL orientées ressources prévisibles et accepte les corps de requête encodés en JSON.

Exécution asynchrone

Toutes les générations d'images sont traitées de manière asynchrone. Les rendus IA haute résolution (échantillons 2k ou 2048x2048) prennent du temps, et une connexion synchrone expirerait inévitablement.

1. Soumettre une tâche : Vous envoyez une requête POST /v1/run avec vos données d'entrée.
2. Recevoir l'ID : L'API renvoie immédiatement un 200 OK avec un prediction_id.
3. Interroger le statut : Vous appelez périodiquement GET /v1/status/{predictionId}.
4. Achèvement : Lorsque le statut passe à succeeded, les URL de vos images générées seront disponibles dans le tableau output.

URL de base

Toutes les requêtes doivent être effectuées via HTTPS vers notre environnement de production :

https://fititon.app/api

Types de contenu

Toutes les requêtes POST et PATCH doivent inclure l'en-tête suivant pour spécifier le format de la charge utile :

Content-Type: application/json

L'API renvoie également toutes les réponses strictement au format JSON.

Webhooks

Si vous fournissez une webhook_url à la racine de votre charge utile JSON, nous enverrons une requête HTTP POST à cette URL dès que la tâche asynchrone sera terminée (qu'elle réussisse ou qu'elle échoue).

Exemple de charge utile de webhook :

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "success",
  "output": [
    "https://storage.fititon.com/results/result-123.jpg",
    "https://storage.fititon.com/results/result-124.jpg"
  ],
  "error": null,
  "created_at": "2026-07-03T10:00:00.000Z",
  "updated_at": "2026-07-03T10:00:15.000Z"
}

Limites et gestion des requêtes

Pour prévenir les abus, l'API applique une limite de débit basée sur le niveau de votre Plan Développeur actif.

Si vous dépassez votre limite, vous recevrez une erreur 429 Too Many Requests. Votre application doit gérer cela avec élégance en implémentant une temporisation exponentielle.