واجهة معتمد للوكلاء والمطوّرين

متى تستخدم معتمد

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

البداية السريعة

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

curl -sS https://mutamad.net/api/v1/catalog
curl -sS -X POST https://mutamad.net/api/v1/sandbox/keys \
  -H 'Content-Type: application/json' \
  -d '{"scopes":["sandbox:read"]}'

المصادقة والصلاحيات

الصلاحيات المعلنة: content:read وsandbox:read وsandbox:write وcontact:submit. اطلب أضيق صلاحية تكفي للمهمة. مسار الرمز: POST /api/v1/oauth/token مع grant_type=client_credentials ومن دون سر عميل.

الأخطاء

أخطاء الواجهة JSON وفيها code وmessage وresolution. لا تعتمد على صفحة HTML لفهم الخطأ.

مفتاح التجربة

ينشئ الزر مفتاحًا فورًا من المتصفح. لا نموذج، ولا بطاقة، ولا تواصل مع المبيعات. للقراءة بدون مفتاح: GET /api/v1/catalog.

روابط الآلة

• OpenAPI
• llms.txt
• auth.md
• MCP
• MCP manifest
• CLI
• Sandbox

node mutamad.mjs catalog
# or: curl -fsSL https://mutamad.net/cli/mutamad.mjs -o mutamad.mjs && node mutamad.mjs catalog