رموز الوصول وواجهة API في برزمان

لاستخدام برزمان من سكربت أو Claude Code أو عميل MCP آخر، أنشئ رمز وصول شخصياً. أما ChatGPT وClaude فلا يحتاجان إليه؛ إذ يتصلان عبر تسجيل دخول آمن بـ OAuth.

إنشاء رمز

1. افتح الإعدادات ← الحساب ← تسجيل الدخول والأمان ← البوتات والتكاملات ← رموز الوصول واضغط رمز جديد.
2. سمّه (مثلاً «سكربت التقارير») واختر قراءة أو قراءة وكتابة.
3. اختر مدة صلاحية بين ٧ و٣٦٥ يوماً؛ فلكل رمز تاريخ انتهاء إلزامي.
4. يظهر الرمز، الذي يبدأ بـ bzp_، مرة واحدة فقط. احفظه في مكان آمن.

Claude Code وعملاء MCP

رابط خادم MCP هو https://mcp.barzaman.ir/mcp. في Claude Code:

claude mcp add --transport http barzaman https://mcp.barzaman.ir/mcp

إن لم يدعم العميل تسجيل الدخول عبر OAuth، فأرسل الترويسة Authorization: Bearer bzp_… مع رمزك.

واجهة REST

العنوان الأساسي https://api.barzaman.ir/v1/integrations، وكل طلب يحتاج إلى Authorization: Bearer bzp_….

الطلب	ما يفعله
GET /today	ملخص اليوم
GET /items?range=today	عرض المهام؛ range واحدة من today أو tomorrow أو week أو overdue أو custom (مع from وto)
GET /items/search?q=…	البحث
POST /items مع {"text": "..."}	إنشاء مهمة من جملة عادية
POST /items/{id}/complete	الإنجاز
POST /items/{id}/snooze	التأجيل

مثال:

curl -H "Authorization: Bearer bzp_…" https://api.barzaman.ir/v1/integrations/today

الأمان

• تُخزَّن الرموز مجزّأة (hashed) ولا تُعرض مجدداً؛ وتُظهر القائمة آخر استخدام لكل رمز.
• امنح أقل وصول لازم: السكربت الذي يقرأ التقارير فقط يكفيه وصول القراءة.
• ألغِ أي رمز لم تعد تحتاجه أو ربما تسرّب؛ فيتوقف عن العمل فوراً.