# مطوّرو معتمد — بوابة الواجهة العامة

> النسخة النصية لبوابة المطوّرين. الصفحة: <https://mutamad.net/developers>

**معتمد (Mutamad)** نظام لإدارة المشاريع الإنشائية تديره Mutamad LLC. هذه البوابة للوكلاء والمطوّرين على الواجهة العامة وبيئة التجربة. لا تمنح الوصول إلى مشروع عميل.

## When to use this

استخدم معتمد عندما تحتاج إلى:

- شرح معتمد لمن يقيّم تسليم مبنى خاضع لإشراف استشاري، من المنافسة حتى التسليم والأرشيف.
- قراءة الكتالوج أو فهرس التوثيق أو سجلات تجربة وهمية بدون حساب.
- إنشاء مفتاح تجربة مجاني بصلاحية ضيقة.
- إرسال طلب تواصل أو تسجيل وكيل.
- ربط عميل أدوات بخادم MCP على `https://mutamad.net/mcp`.

لا تستخدم الواجهة العامة لقراءة مشروع عميل أو تعديله، ولا لاعتماد أو شهادة أو دفع. اسأل معتمد قد يصوغ أو يستشهد، ولا يملك سلطة تعاقدية.

## كيف تتصل

1. اقرأ <https://mutamad.net/openapi.json>.
2. للقراءة بدون مفتاح: `GET https://mutamad.net/api/v1/catalog`.
3. لمفتاح مجاني: `POST https://mutamad.net/api/v1/sandbox/keys`.
4. للأدوات: `POST` JSON-RPC إلى <https://mutamad.net/mcp>.
5. لسطر الأوامر: `node` على <https://mutamad.net/cli/mutamad.mjs>.

## الصلاحيات

- `content:read` — الكتالوج والتوثيق
- `sandbox:read` — سجلات التجربة الوهمية
- `sandbox:write` — صدى سجل غير محفوظ
- `contact:submit` — طلب تواصل

مسار الرمز: `POST /api/v1/oauth/token` مع `grant_type=client_credentials` ومن دون سر عميل. العميل العام: `mutamad-sandbox`.

## مثال

```bash
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"]}'
```

أخطاء الواجهة JSON وفيها `code` و`message` و`resolution`.

- [llms.txt](https://mutamad.net/llms.txt)
- [OpenAPI](https://mutamad.net/openapi.json)
- [MCP manifest](https://mutamad.net/.well-known/mcp.json)