المصادر

يزامن المصدر تطبيقًا مع مساحة أسماء واحدة: تُكتب السجلات الجديدة والمعدّلة، وتُحذف السجلات المحذوفة. تحتاج المصادر إلى مفتاح بصلاحية وصول كامل؛ أما للحاويات، فراجع Google Cloud Storage.

ربط مصدر

POST /sources

curl https://api.conare.ai/sources \
  -H "Authorization: Bearer $CONARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "hubspot", "namespace": "crm", "redirect_url": "https://yourapp.com/settings"}'

const { source, connectUrl } = await conare.sources.connect({
  type: "hubspot",
  namespace: "crm",
  redirectUrl: "https://yourapp.com/settings",
});

Response

{
  "source": {
    "id": "src_1cff2c6ea888bbc8343b6e38",
    "type": "hubspot",
    "name": "HubSpot",
    "namespace": "crm",
    "status": "connecting",
    "error": null,
    "documents": 0,
    "last_synced_at": null,
    "created_at": "2026-10-21T21:40:39.704618Z",
    "sync_interval_s": null,
    "sync_interval_auto": true,
    "next_sync_at": null,
    "cost": { "rows_billed": true, "usd_per_million_rows": 100, "options": [ ... ] }
  },
  "connect_url": "https://..."
}

أرسل مالك التطبيق إلى connect_url (صالح لمدة 7 أيام)؛ تبدأ المزامنة الأولى عندما يربط حسابه.

الخيار	النوع	ما يفعله
`type`	string، مطلوب	التطبيق، من القائمة
`namespace`	string، مطلوب	مساحة الأسماء التي تتم المزامنة إليها
`name`	string	اسم للعرض، حتى 100 حرف
`redirect_url`	string	الوجهة التي يُرسَل إليها المستخدم بعد الربط
`sync_interval_s`	integer	الثواني بين المزامنات، من 300 إلى 2,592,000 (30 يومًا)؛ يختار Conare قيمة إذا لم تُحدَّد
`config`	object	للتطبيقات التي تُربط بمفتاح (Twenty وGranola وGitHub): `api_key`، و`base_url` لـ Twenty المستضاف ذاتيًا؛ تتزامن هذه فورًا، دون `connect_url`

لربط تطبيقات مستخدميك، امنح كل مستخدم مساحة أسماء، مثل user-42. المخطط الكامل: ربط مصدر.

المستندات المتزامنة


المعرّف	`<source id>:<schema>:<record key>`
البيانات الوصفية	`source` و`source_id` و`schema` و`title`، و`url` و`author` و`created_at` و`updated_at` عندما تتوفر في السجل
البحث في مصدر واحد	صفِّ حسب `source_id`

جلب مصدر

GET /sources/:id

curl

curl https://api.conare.ai/sources/src_1cff2c6ea888bbc8343b6e38 \
  -H "Authorization: Bearer $CONARE_API_KEY"

الحقل	المعنى
`id`، `type`، `name`، `namespace`	كما عند الربط
`status`	`connecting` (بانتظار تسجيل الدخول)، أو `syncing`، أو `ready`، أو `error`
`error`	ما الذي فشل، أو `null`
`documents`	المستندات التي زامنها
`progress`	أثناء المزامنة، `records_pulled` حتى الآن
`created_at`، `last_synced_at`، `next_sync_at`	متى رُبط، ومتى تزامن آخر مرة، ومتى يتزامن تاليًا
`sync_interval_s`، `sync_interval_auto`	الثواني بين المزامنات، وما إذا كان Conare يختارها
`cost`	ما تقرؤه المزامنة، وتكلفة كل تواتر مزامنة شهريًا

المخطط الكامل: جلب مصدر.

سرد المصادر

GET /sources يُرجع sources، كلٌّ منها كما يُرجعه الجلب؛ أما المصدر الذي له kind، مثل files أو gcs، فله كائن sync بدلًا من ذلك.

الخيار	النوع	ما يفعله
`namespace`، `user`، `type`	string	المصادر التي يساوي حقلها القيمة فقط، مثل `?namespace=crm&type=hubspot`

المخطط الكامل: سرد المصادر.

المزامنة الآن

POST /sources/:id/sync يبدأ مزامنة خلال ثوانٍ ويُرجع المصدر؛ المصدر الذي لا يزال connecting يُرجع 409 conflict.

الخيار	النوع	ما يفعله
`full`	boolean، الافتراضي `false`	قراءة كل شيء مجددًا، لا التغييرات فقط (Gmail وTwenty وGranola وGitHub)؛ تُحتسب مزامنة Gmail الكاملة كمزامنة أولى، ويشير `resync` إلى ذلك

المخطط الكامل: مزامنة مصدر الآن.

تغيير فاصل المزامنة

PATCH /sources/:id

الخيار	النوع	ما يفعله
`sync_interval_s`	integer أو null	من 300 إلى 2,592,000 ثانية؛ `null` يترك الاختيار لـ Conare

يُرجع المصدر. المخطط الكامل: تحديد تواتر مزامنة المصدر.

فصل مصدر

DELETE /sources/:id يوقف المزامنة ويُرجع { "deleted": true }.

الخيار	النوع	ما يفعله
`delete_documents`	boolean، الافتراضي `false`	حذف المستندات التي زامنها أيضًا

المخطط الكامل: فصل مصدر.

سرد التطبيقات

GET /sources/types

Response

{
  "types": [
    { "type": "affinity", "name": "Affinity", "logo_url": "https://..." },
    { "type": "airtable", "name": "Airtable", "logo_url": "https://..." }
  ]
}

لكلٍّ منها type المستخدم للربط، وname وlogo_url الخاصان به، وauth: "api_key" للتطبيقات التي تُربط باستخدام config.
تكون partial بقيمة true عندما يتعذّر سرد سوى تلك التطبيقات: أعد المحاولة لاحقًا.

المخطط الكامل: سرد أنواع المصادر.

البدء

الأساسيات

الملفات

المزامنة

النماذج

الأدوات

المصادر

ربط مصدر

المستندات المتزامنة

جلب مصدر

سرد المصادر

المزامنة الآن

تغيير فاصل المزامنة

فصل مصدر

سرد التطبيقات

​ربط مصدر

​المستندات المتزامنة

​جلب مصدر

​سرد المصادر

​المزامنة الآن

​تغيير فاصل المزامنة

​فصل مصدر

​سرد التطبيقات

ربط مصدر

المستندات المتزامنة

جلب مصدر

سرد المصادر

المزامنة الآن

تغيير فاصل المزامنة

فصل مصدر

سرد التطبيقات