# مرجع الـ API

> اربط أنظمتك بـ TBit عبر واجهة REST API

- الصفحة: https://tbit.app/ar/docs/api
- عنوان URL الأساسي: `https://rest-api.tbit.app/v1`
- المصادقة: ترويسة `X-API-Key` تحمل مفتاحك في كل طلب (تقرأه الأمثلة من متغير البيئة `TBIT_API_KEY`)

> **عنوان URL الأساسي**
>
> `https://rest-api.tbit.app/v1`

> **حدود معدّل الطلبات**
>
> 100 طلب في الدقيقة لكل مفتاح API

### البدء السريع

نفّذ أول استدعاء للـ API في ثوانٍ:

> **مثال مفتوح المصدر**
>
> [مثال كامل لمتجر مبني على هذه الـ API ←](https://github.com/tbit-io/tbit-storefront-example)

- [المصادقة](https://tbit.app/ar/docs/api/authentication): تعرّف على طريقة مصادقة طلباتك إلى الـ API
- [الأنشطة](https://tbit.app/ar/docs/api/activities): أدِر المحادثات وجهات الاتصال
- [الوسوم](https://tbit.app/ar/docs/api/tags): أنشئ وسومًا لجهات اتصالك وأدِرها
- [جهات الاتصال](https://tbit.app/ar/docs/api/contacts): اقرأ بيانات جهات الاتصال وحدّثها
- [القوالب](https://tbit.app/ar/docs/api/templates): اعرض قوالب واتساب وأرسلها
- [المنتجات](https://tbit.app/ar/docs/api/products): اقرأ كتالوج منتجاتك وابحث فيه بحثًا دلاليًا
- [الفئات](https://tbit.app/ar/docs/api/categories): اعرض فئات كتالوجك
- [السلال](https://tbit.app/ar/docs/api/carts): سلال قابلة للمشاركة تُغلق الصفقة على واتساب
- [إعادة توجيه النماذج](https://tbit.app/ar/docs/api/forms-webhook): استقبل في الـ API الخاصة بك كل نموذج مكتمل (webhook)
- [الأدوات المخصّصة](https://tbit.app/ar/docs/api/custom-tools): دع الذكاء الاصطناعي يستدعي الـ API الخاصة بك أثناء المحادثة
- [الأخطاء](https://tbit.app/ar/docs/api/errors): رموز الأخطاء ومرجع التعامل معها

`GET /v1/activities`

```bash
curl "https://rest-api.tbit.app/v1/activities" \
  -H "X-API-Key: $TBIT_API_KEY"
```