الوثائق والأدلة

كيف يعمل

1. يرسل خادمك قائمة بروابط الصفحات إلى IndexLaunch، موقَّعة بمفتاح API الخاص بك.
2. يتحقق IndexLaunch من كل رابط، ويخصم رصيدًا واحدًا لكل رابط، ثم يرسله إلى محركات البحث للزحف. تحصل على معرّف واحد لكل رابط.
3. استخدم هذه المعرّفات للتحقق من حالة كل رابط متى شئت.

الإعداد في 4 خطوات

1. سجّل الدخول وأنشئ مفتاحًا من الإعدادات ← الوصول إلى API. يُعرض المفتاح مرة واحدة فقط، لذا انسخه فورًا.
2. خزّن المفتاح كمتغير بيئة سري على خادمك أو في CI، مثل INDEXLAUNCH_API_KEY. لا تضعه أبدًا في كود المتصفح أو في مستودع عام.
3. تحقّق من كل نطاق سترسل روابطه (Settings → Domain Verification). ترفض محركات البحث الروابط من المواقع غير المُتحقَّق منها.
4. استدعِ واجهة API من الخادم الخلفي أو من سكربت أو من مسار النشر لديك. الأمثلة أدناه جاهزة للنسخ.

المصادقة

أرسل مفتاحك في ترويسة Authorization لكل طلب بالشكل Bearer YOUR_KEY. تستخدم جميع الطلبات HTTPS وJSON.

Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

إرسال الروابط

أرسل ما يصل إلى 500 رابط كامل (تبدأ بـ https://) في كل طلب. يكلّف كل رابط رصيدًا واحدًا. تتضمن الاستجابة معرّفًا واحدًا لكل رابط، بالترتيب نفسه الذي أرسلتها به.

POST https://www.indexlaunch.site/api/v1/submit
Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

{ "urls": ["https://example.com/page-1", "https://example.com/page-2"] }

200 OK
{ "submitted": 2, "ids": ["j57...", "j58..."] }

التحقق من حالة رابط

مرّر معرّفًا من استجابة الإرسال. يمكنك فقط قراءة الروابط التي أرسلها حسابك.

GET https://www.indexlaunch.site/api/v1/urls/j57...
Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

200 OK
{
  "id": "j57...",
  "url": "https://example.com/page-1",
  "status": "indexed",
  "submittedAt": 1757740800000,
  "indexedAt": 1757741100000
}

حقول الاستجابة

id

معرّف الإرسال.

url

الرابط الذي أرسلته.

status

إحدى قيم الحالة أدناه.

submittedAt

وقت الإرسال، بالمللي ثانية منذ بداية حقبة Unix.

indexedAt

وقت قبول محركات البحث له. لا يظهر قبل ذلك.

قيم الحالة

pending

تم الاستلام وبانتظار الإرسال. تنتقل معظم الروابط إلى المرحلة التالية خلال بضع دقائق.

indexed

قبلته محركات البحث ووُضع في قائمة انتظار الزحف. تعرضه لوحة التحكم على أنه “Submitted”. هذا لا يؤكد بعد أن الصفحة مفهرسة.

failed

لم تقبل محركات البحث الرابط، وغالبًا يكون السبب أن النطاق غير مُتحقَّق منه. يُعاد الرصيد تلقائيًا.

refunded

ظل الرابط عالقًا أكثر من 7 أيام، لذا أُعيد الرصيد تلقائيًا.

أمثلة برمجية

curl -X POST https://www.indexlaunch.site/api/v1/submit \
  -H "Authorization: Bearer $INDEXLAUNCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://example.com/new-post"]}'

const res = await fetch("https://www.indexlaunch.site/api/v1/submit", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INDEXLAUNCH_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    urls: ["https://example.com/new-post", "https://example.com/pricing"],
  }),
});

const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(`Submitted ${data.submitted} URLs`, data.ids);

import os
import requests

res = requests.post(
    "https://www.indexlaunch.site/api/v1/submit",
    headers={"Authorization": f"Bearer {os.environ['INDEXLAUNCH_API_KEY']}"},
    json={"urls": ["https://example.com/new-post"]},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"])
print(data["submitted"], data["ids"])

# .github/workflows/indexlaunch.yml
name: Submit new pages
on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  submit:
    runs-on: ubuntu-latest
    steps:
      - name: Send changed URLs to IndexLaunch
        env:
          INDEXLAUNCH_API_KEY: ${{ secrets.INDEXLAUNCH_API_KEY }}
        run: |
          curl --fail-with-body -X POST https://www.indexlaunch.site/api/v1/submit \
            -H "Authorization: Bearer $INDEXLAUNCH_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{"urls": ["https://example.com/new-post"]}'

الأخطاء

تُرجع الأخطاء JSON يحتوي على حقل error فيه رسالة يمكنك عرضها أو تسجيلها.

400

طلب غير صالح: لا يحتوي النص على قائمة urls، أو أن أحد الروابط غير صالح، أو أُرسل أكثر من 500 رابط، أو أن الأرصدة غير كافية، أو أن الطلبات تصل بسرعة كبيرة.

401

المفتاح مفقود أو غير صحيح أو تم إلغاؤه.

403

الحساب موقوف.

404

لا يوجد إرسال بهذا المعرّف ضمن حسابك.

ممارسات جيدة

• أرسل الصفحات الجديدة أو المعدّلة فقط، وليس موقعك بالكامل مع كل عملية نشر.
• اجمع الروابط في طلب واحد بدلًا من إرسال طلب لكل رابط.
• إذا تلقيت “Too many requests” أو رسالة حدّ المعدّل، فانتظر دقيقة ثم أعد المحاولة. تظهر الحدود الدقيقة لحسابك في الإعدادات ← الوصول إلى API.
• إذا تسرّب مفتاح، فألغِه من الإعدادات وأنشئ مفتاحًا جديدًا. تتوقف المفاتيح الملغاة عن العمل فورًا.