Intégration Web / HTML – Documentation API ByByBG
🌐 Intégration Web

Intégration API Web / HTML

Intégrez la suppression d’arrière-plan alimentée par l’IA dans les sites web et les applications web à l’aide de formulaires HTML, JavaScript et d’API backend sécurisées.

INTRODUCTION

Flux d’intégration recommandé

Pour une sécurité maximale, votre clé API ne doit jamais être exposée directement dans le code JavaScript frontend.

Recommandé : Le frontend téléverse l’image → Le backend appelle l’API → Le backend renvoie l’image traitée.
📤

Téléverser une image

Les utilisateurs sélectionnent et téléversent des images à l’aide de formulaires HTML ou d’interfaces glisser-déposer.

🔐

Proxy Backend

Votre backend envoie les requêtes de manière sécurisée à l’API ByByBG en utilisant votre clé API privée.

Traitement par IA

L’image est traitée à l’aide de modèles avancés de suppression d’arrière-plan par IA.

🖼️

Retour du résultat

Une image PNG transparente est renvoyée instantanément au navigateur.

STEP 1

Formulaire de téléversement HTML

Créez une interface de téléversement simple permettant aux utilisateurs de sélectionner et d’envoyer des images.

<input type="file" id="imageInput">

<button onclick="removeBg()">
    Remove Background
</button>

<div id="result"></div>
STEP 2

JavaScript Frontend

Envoyez les images téléversées de manière sécurisée à votre point de terminaison backend à l’aide des requêtes JavaScript fetch.

async function removeBg(){

    const fileInput =
    document.getElementById("imageInput");

    const result =
    document.getElementById("result");

    if(!fileInput.files.length){
        alert("Select image");
        return;
    }

    const formData = new FormData();

    formData.append(
        "file",
        fileInput.files[0]
    );

    result.innerHTML = "Processing...";

    const response = await fetch(
        "/web/remove-bg",
        {
            method:"POST",
            body:formData
        }
    );

    if(!response.ok){

        result.innerHTML =
        "Something went wrong";

        return;
    }

    const blob =
    await response.blob();

    const url =
    URL.createObjectURL(blob);

    result.innerHTML = `
        <img src="${url}">
    `;
}
STEP 3

Responsabilités du Backend

  • Stocker les clés API de manière sécurisée sur le serveur.
  • Valider correctement les fichiers image téléversés.
  • Envoyer des requêtes API sécurisées aux serveurs ByByBG.
  • Renvoyer les images PNG transparentes traitées.
  • Gérer correctement les erreurs API et les requêtes invalides.
SECURITY

Règles de sécurité importantes

N’exposez jamais votre clé API dans le code JavaScript frontend ou dans des dépôts publics.
  • Utilisez des points de terminaison proxy backend sécurisés.
  • Stockez les clés API dans des variables d’environnement.
  • Validez les téléversements côté serveur.
  • Appliquez des limites de taille de fichier pour plus de sécurité.
  • Empêchez les abus à l’aide de systèmes de limitation du débit des requêtes (rate limiting).
ERRORS

Erreurs API courantes

Status
Description
401
Clé API invalide ou manquante.
413
Le fichier image téléversé est trop volumineux.
429
Trop de requêtes. Limite de requêtes dépassée.
500
Erreur interne du serveur lors du traitement.

Passer à l’intégration JavaScript avancée

Découvrez comment créer des intégrations frontend avancées, des barres de progression, des aperçus et des flux de travail en temps réel avec JavaScript.