تكامل الويب / HTML – توثيق ByByBG API
🌐 تكامل الويب

تكامل API للويب / HTML

قم بدمج إزالة الخلفية بالذكاء الاصطناعي في مواقع الويب وتطبيقات الويب باستخدام نماذج HTML وJavaScript وواجهات الخلفية الآمنة.

المقدمة

تدفق التكامل الموصى به

لتحقيق أقصى درجات الأمان، يجب ألا يتم كشف مفتاح API الخاص بك مباشرة داخل أكواد JavaScript في الواجهة الأمامية.

موصى به: الواجهة الأمامية ترفع الصورة ← الخادم الخلفي يستدعي API ← الخادم الخلفي يعيد الصورة المعالجة.
📤

رفع الصورة

يقوم المستخدمون باختيار الصور ورفعها باستخدام نماذج HTML أو واجهات السحب والإفلات.

🔐

الخادم الوسيط

يقوم الخادم الخلفي بإرسال الطلبات بأمان إلى واجهة ByByBG API باستخدام مفتاح API الخاص بك.

المعالجة بالذكاء الاصطناعي

تتم معالجة الصورة باستخدام نماذج متقدمة لإزالة الخلفية بالذكاء الاصطناعي.

🖼️

إرجاع النتيجة

يتم إرجاع صورة PNG بخلفية شفافة إلى المتصفح فورًا.

STEP 1

نموذج رفع HTML

أنشئ واجهة رفع بسيطة تسمح للمستخدمين باختيار الصور ورفعها.

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

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

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

JavaScript للواجهة الأمامية

أرسل الصور المرفوعة بأمان إلى نقطة النهاية الخلفية باستخدام طلبات 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

مسؤوليات الخادم الخلفي

  • تخزين مفاتيح API بأمان على الخادم.
  • التحقق من ملفات الصور المرفوعة بشكل صحيح.
  • إرسال طلبات API آمنة إلى خوادم ByByBG.
  • إرجاع صور PNG المعالجة بخلفية شفافة.
  • التعامل الصحيح مع أخطاء API والطلبات غير الصالحة.
SECURITY

قواعد أمان مهمة

لا تعرض مفتاح API الخاص بك داخل JavaScript للواجهة الأمامية أو المستودعات العامة.
  • استخدم نقاط نهاية Proxy آمنة.
  • قم بتخزين مفاتيح API داخل متغيرات البيئة.
  • تحقق من الملفات المرفوعة على جانب الخادم.
  • طبّق حدودًا لحجم الملفات المرفوعة.
  • امنع إساءة الاستخدام باستخدام أنظمة تحديد المعدل.
ERRORS

أخطاء API الشائعة

Status
Description
401
مفتاح API غير صالح أو مفقود.
413
ملف الصورة المرفوع كبير جدًا.
429
طلبات كثيرة جدًا. تم تجاوز الحد المسموح.
500
خطأ داخلي أثناء المعالجة.

تابع إلى تكامل JavaScript المتقدم

تعرّف على كيفية بناء واجهات متقدمة مع أشرطة التقدم والمعاينات وسير العمل الفوري باستخدام JavaScript.