REST API مستند
طرحها، نسخهها، بافت روی هر دار و دادههای برنامهٔ شما، همه زیر /v1. سند OpenAPI 3.1 از همان تعریفهایی ساخته میشود که سرویس درخواستها را با آن میسنجد، پس این دو از هم جدا نمیافتند.
API و اتصال
فروشگاهی که رنگبندیها را نشان میدهد، سیستم کارخانهای که منتظر نقشهٔ تأییدشده است، یا پیکربندی روی سایت خودتان. همه از راه API عمومی به همان سرویسی وصل میشوند که طراحهایتان با آن کار میکنند.
# طرحهای یک فضای کار
$ {
"data": [{
"id": "cmh2x...",
"title": "Medallion, indigo",
"drawnFor": { "technique": "HANDWOVEN", "raj": 40, "knotAspectRatio": 1.15 },
"latestVersion": { "sequence": 4, "status": "IN_REVIEW" }
}],
"next": null
}وبهوک رسید
POST https://your-shop.example/toranj
Toranj-Event: version.approved
Toranj-Signature: t=1793520000,v1=9f2c...طرحها، نسخهها، بافت روی هر دار و دادههای برنامهٔ شما، همه زیر /v1. سند OpenAPI 3.1 از همان تعریفهایی ساخته میشود که سرویس درخواستها را با آن میسنجد، پس این دو از هم جدا نمیافتند.
رویدادها در همان تراکنشی ثبت میشوند که خود تغییر انجام شده، و امضا و تلاش دوبارهٔ وبهوک در نرمافزار آماده است. ولی فرستادنش در نسخهٔ فعلی سایت روشن نیست. اگر لازمش دارید به ما بگویید.
سیستم شما میتواند لینکی یکباره بخواهد که ویرایشگر را برای یک نفر و روی یک طرح باز کند. آن شخص نه صفحهٔ ورودی میبیند و نه چیز دیگری.
کلید هر برنامه فقط در یک فضای کار و با همان دسترسیهایی کار میکند که داده شده: خواندن، نوشتن، داده. کلید را فعلاً خودمان برایتان میسازیم و باطل که شود از کار میافتد. هر کار در تاریخچه نام انجامدهندهاش را دارد.
سرور MCP همان ابزارهای طراح را به دستیاری مثل Claude میدهد: کشیدن، گذاشتن نقشمایه، گرفتن خروجی، خواندن تغییرها. با نام خودش در تاریخچه ثبت میشود و هرگز نمیتواند نسخهای را تأیید کند.