منصة المطوّرين

ابنِ على
CouthActs.

واجهة برمجة للوكلاء وخادم MCP لمساعدي الذكاء الاصطناعي، وواجهة للمزوّدين لأنظمة التوزيع والتتبع عن بُعد، ونقاط نهاية عامة للتحقق من سجلات الحيازة الموقّعة. JSON بسيط عبر HTTPS بمفاتيح Bearer.

احصل على مفاتيح API تحدّث إلينا

المفاتيح والحدود

اختر مفتاحك.

مفاتيح الوكلاء

بدون رسوم خطة

لوكلاء ومساعدي الذكاء الاصطناعي الذين يعملون نيابةً عن حساب عميل.

صلاحيات تختارها: التسعير والمهام والحجوزات والمحفظة والثقة
حدود إنفاق لكل مهمة وشهرية، إضافة إلى حد للموافقة
حتى 120 طلبًا في الدقيقة لكل مفتاح
أنشئه من الإعدادات ← وكلاء الذكاء الاصطناعي، أو اربط مساعدًا عبر OAuth

إنشاء مفتاح وكيل

واجهة المزوّدين

خطة Basic

للمزوّدين الذين يربطون أنظمة التوزيع أو التتبع عن بُعد الخاصة بهم.

Basic: ‏500 استدعاء شهريًا، وبعدها تُرفض الاستدعاءات
المهام المفتوحة، وحجوزاتك، ومحفظتك، وتحديثات الموقع
Professional ‏(5,000 استدعاء شهريًا) وEnterprise: قريبًا
أنشئ المفاتيح من الإعدادات ← مفاتيح API للمزوّد

إدارة مفاتيح المزوّد

واجهة العملاء

بالاتفاق

نقاط نهاية REST لمهام العميل وعروضه ومحفظته.

Starter: ‏1,000 استدعاء شهريًا، وبعدها تُرفض الاستدعاءات
Growth: ‏5,000 استدعاء شهريًا، ثم 0.20 دولار أمريكي لكل استدعاء تُخصم من محفظتك في الشهر التالي
Enterprise: حدود حسب الاتفاق
المفاتيح ليست ذاتية الخدمة بعد؛ وينبغي لمعظم العملاء استخدام مفتاح وكيل بدلًا منها

تواصل معنا

خطط واجهة المزوّدين المدفوعة (Professional وEnterprise) قادمة قريبًا؛ تواصل معنا إذا احتجت إلى حدود أعلى الآن. تظهر خطتك الحالية واستخدامك في الإعدادات. تُقدَّم الواجهات دون التزام بمستوى خدمة.

بداية سريعة

ثلاث خطوات إلى أول استدعاء.

الخطوة 01

احصل على مفتاحك

العملاء ووكلاء الذكاء الاصطناعي: الإعدادات ← وكلاء الذكاء الاصطناعي. المزوّدون: الإعدادات ← مفاتيح API للمزوّد. يظهر المفتاح كاملًا مرة واحدة فقط عند إنشائه.

الخطوة 02

أرسل أول طلب

أرسل مفتاحك في Authorization: Bearer. يمكن للمزوّدين البدء بـ GET /api/provider/v1/jobs.

الخطوة 03

استكشف أدوات الوكلاء

مفاتيح الوكلاء: اقرأ وصف OpenAPI على ‎/api/agent/openapi.json، أو وجّه عميل MCP إلى ‎/api/mcp.

مثال على طلب

curl -X GET https://couthacts.com/api/provider/v1/jobs \
  -H "Authorization: Bearer ca_provider_your_key_here" \
  -H "Content-Type: application/json"

# Response
{
  "success": true,
  "data": [
    {
      "id": "clx...",
      "mode": "FREIGHT_TRUCKING",
      "title": "Freight: Dallas, TX → Houston, TX",
      "status": "OPEN",
      "originAddress": "Dallas, TX",
      "destinationAddress": "Houston, TX",
      "pickupDate": "2026-11-05T08:00:00.000Z",
      "budgetUsd": "2500",
      "insuranceTier": "NONE",
      "_count": { "bids": 3 }
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1, "pages": 1, "requestId": "…", "timestamp": "…" }
}

نقاط النهاية

المرجع الكامل.

جميع المبالغ في استجابات واجهة البرمجة والوكلاء وMCP بالدولار الأمريكي (الحقول المنتهية بـ Usd): تحتسب CouthActs المدفوعات وتصرفها بالدولار الأمريكي فقط. لعرض ما يعادلها بالعملة المحلية، استدعِ GET /api/currency/display مرة واحدة لكل شاشة واضرب: المحلي ≈ amountUsd × rate. اعرض مبلغ الدولار أولًا والمبلغ المحلي كتقدير.

واجهة الوكلاء وMCP

GET/api/agent/v1/tools
يعرض الإجراءات التي يسمح بها مفتاح الوكيل، مع مخططات المدخلات.
مفتاح وكيل
POST/api/agent/v1/tools/{name}
ينفّذ إجراءً (مثل get_quote أو post_job) ضمن صلاحيات مفتاحك وحدود إنفاقه وقواعد الموافقة.
مفتاح وكيل
GET/api/agent/openapi.json
وصف OpenAPI 3.1 لأدوات الوكلاء.
لا شيء
POST/api/mcp
الإجراءات نفسها عبر بروتوكول Model Context Protocol، لـ Claude وChatGPT وغيرها من المساعدين المتوافقين مع MCP.
مفتاح وكيل / OAuth

واجهة المزوّدين

GET/api/provider/v1/jobs
المهام المفتوحة في وسائل النقل المسجّلة لديك (مع تصفية حسب الوسيلة وتقسيم إلى صفحات).
مفتاح API للمزوّد
GET/api/provider/v1/bookings
حجوزاتك مع الحالة ورمز التتبع وحالة حجز الدفعة.
مفتاح API للمزوّد
POST/api/provider/v1/tracking
يبلّغ عن موقع لحجز نشط؛ يظهر للعميل ويُسجَّل في سجل الحيازة.
مفتاح API للمزوّد
GET/api/provider/v1/wallet
رصيد محفظتك وأحدث معاملاتك.
مفتاح API للمزوّد

واجهة العملاء

GET · POST/api/v1/jobs
يعرض مهامك، أو ينشر مهمة (يخصم الرسوم ويحجز الميزانية من محفظتك).
مفتاح API للعميل
GET · PATCH/api/v1/jobs/{id}
يجلب مهمة واحدة، أو يعدّل ميزانيتها أو وصفها، أو يلغيها.
مفتاح API للعميل
GET · POST/api/v1/bids
يعرض العروض على مهامك، أو يقبل عرضًا أو يرفضه.
مفتاح API للعميل
GET/api/v1/wallet
رصيد محفظتك.
مفتاح API للعميل

عامة (دون مفتاح)

GET/api/track/{code}
حالة الحجز ومساره وأحداث التتبع عبر رمز التتبع. دون بيانات مالية.
لا شيء
GET/api/custody/public/{trackingCode}
دليل عام على سلامة سجل الحيازة للحجز (أنواع الأحداث وأوقاتها والتجزئات والتواقيع).
لا شيء
GET/api/credentials/provider/{id}
بيانات الاعتماد الموقّعة للمزوّد (حالة التوثيق وسجل الأداء).
لا شيء
GET/.well-known/couthacts-keys.json
مفاتيح CouthActs العامة من نوع Ed25519 للتحقق من التواقيع.
لا شيء
POST/api/trust/verify
يتحقق من شهادة حيازة أو بيانات اعتماد مزوّد.
لا شيء
GET/api/currency/display
عملة العرض للمستخدم وسعرها مقابل الدولار (تكون rate بقيمة null عند عدم توفر سعر مباشر: اعرض الدولار فقط).
لا شيء
GET/api/currency/supported
عملات العرض لأداة الاختيار: الرمز والاسم والعلامة وعدد المنازل العشرية.
لا شيء

تتبع المزوّد

أبلغ عن الموقع من أنظمتك.

أرسل موقعًا لحجز مؤكد أو جارٍ. يظهر للعميل لحظيًا ويُسجَّل كنقطة تحقق في سجل الحيازة الموقّع. يمكنك وسم مصدر كل قراءة باسم طبقة. تسجّل CouthActs هذا الوسم، لكنها لا تتصل بنفسها ببيانات AIS أو الرحلات الجوية أو ELD أو المستشعرات أو الأقمار الصناعية ولا تتحقق منها: البيانات هي ما تبلّغ عنه.

أوسام الطبقات المقبولة

MOBILE_GPS

GPS الجوال

موقع من GPS الهاتف أو المركبة (الافتراضي).

AIS_MARITIME

AIS (بحري)

موقع سفينة من مصدر AIS لديك.

FLIGHT_TRACKING

تتبع الرحلات

موقع طائرة من مصدر تتبع الرحلات لديك.

ELD_INTEGRATION

ELD

موقع شاحنة من جهاز التسجيل الإلكتروني لديك.

QR_PIN_CONFIRMATION

التسليم برمز PIN

موقع عند التسليم. يُدخل رمز PIN للتسليم نفسه في التطبيق.

IOT_DEVICE

جهاز إنترنت الأشياء

موقع من جهاز التتبع لديك. لا تُخزَّن قراءات المستشعرات.

SATELLITE

قمر صناعي

موقع من جهاز التتبع عبر الأقمار الصناعية لديك.

DOCUMENT_POD_AI

إثبات التسليم

وسم موقع فقط. لا تحلّل CouthActs المستندات.

BIOMETRIC

القياسات الحيوية

وسم موقع فقط. لا تُجري CouthActs أي فحص حيوي عند التسليم.

الإبلاغ عن موقع

POST /api/provider/v1/tracking
Authorization: Bearer ca_provider_your_key_here
Content-Type: application/json

{
  "bookingId": "clx...",
  "lat": 32.7767,
  "lng": -96.7970,
  "layer": "MOBILE_GPS",
  "status": "IN_TRANSIT",
  "note": "Departed Dallas warehouse"
}

المصادقة والأمان

كيف يُضبط الوصول.

مفاتيح Bearer

يحتاج كل طلب إلى Authorization: Bearer. تُنشأ المفاتيح في الإعدادات، وتظهر مرة واحدة، ويمكن إلغاؤها في أي وقت.

HTTPS فقط

أرسل المفاتيح عبر HTTPS فقط. لا تضعها أبدًا في شيفرة عامة أو تطبيقات تعمل لدى العميل.

الحدود

مفاتيح الوكلاء: 120 طلبًا في الدقيقة. مفاتيح API للمزوّدين والعملاء: عدد الاستدعاءات الشهرية لخطتها، ويظهر في ترويستي X-RateLimit-Limit وX-RateLimit-Remaining.

سجل النشاط

يُسجَّل كل إجراء للوكيل مع الأداة والحالة والمبلغ والمدخلات والنتيجة، ويظهر في الإعدادات. وتعرض مفاتيح المزوّد عدد طلباتها وآخر استخدام.

حدود الإنفاق والموافقات

لا يمكن لمفاتيح الوكلاء تجاوز حدها لكل مهمة أو الحد الشهري، وتنتظر الإجراءات التي تتجاوز حد الموافقة موافقة صاحب الحساب (تنتهي الطلبات بعد 72 ساعة).

سجلات موقّعة، لا طلبات موقّعة

تُوقَّع سجلات الحيازة وبيانات اعتماد المزوّدين بمفتاح Ed25519 الخاص بـ CouthActs، ليتمكن أي شخص من التحقق منها. أما طلبات الواجهة واستجاباتها فغير موقّعة، ولا ترسل CouthActs خطافات ويب صادرة.

صيغة الاستجابة

متّسقة. متوقَّعة.

تستخدم استجابات واجهتي المزوّدين والعملاء الصيغة أدناه. أما استجابات واجهة الوكلاء فتتضمن بدلًا من ذلك الحقول status وactionId وresult؛ راجع وصف OpenAPI.

نجاح (2xx)

{
  "success": true,
  "data": { ... },
  "meta": {
    "requestId": "req_...",
    "timestamp": "2026-04-01T..."
  }
}

خطأ (4xx/5xx)

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "bookingId, lat, lng required"
  },
  "meta": {
    "requestId": "req_...",
    "timestamp": "2026-04-01T..."
  }
}

المطوّرون مرحَّب بهم

مستعد للتكامل؟

أنشئ مفتاحًا في الإعدادات وأجرِ أول استدعاء خلال دقائق. للحصول على حدود أعلى أو خطة Enterprise، تواصل معنا.

احصل على مفاتيح API تحدّث إلينا

ابنِ علىCouthActs.

اختر مفتاحك.

مفاتيح الوكلاء

واجهة المزوّدين

واجهة العملاء

ثلاث خطوات إلى أول استدعاء.

احصل على مفتاحك

أرسل أول طلب

استكشف أدوات الوكلاء

المرجع الكامل.

واجهة الوكلاء وMCP

واجهة المزوّدين

واجهة العملاء

عامة (دون مفتاح)

أبلغ عن الموقع من أنظمتك.

أوسام الطبقات المقبولة

GPS الجوال

AIS (بحري)

تتبع الرحلات

ELD

التسليم برمز PIN

جهاز إنترنت الأشياء

قمر صناعي

إثبات التسليم

القياسات الحيوية

كيف يُضبط الوصول.

مفاتيح Bearer

HTTPS فقط

الحدود

سجل النشاط

حدود الإنفاق والموافقات

سجلات موقّعة، لا طلبات موقّعة

متّسقة. متوقَّعة.

مستعد للتكامل؟

ابنِ على
CouthActs.