ساخت فرم
فرم با فیلدهای دلخواه میسازد.
POST
scope: broker.writehttps://api.irnoti.com/v1/sdk-apps/{id}/formsfields فهرست فیلد (نوع، برچسب، الزامی بودن). consentText تیک رضایت اجباری میگذارد. اگر تأیید پیامکی شمارهٔ موبایل لازم است، verifyLineId خطی را بدهید که کدها را میفرستد و هزینهاش را میپردازد.
پارامترها
| نام | محل | نوع | توضیح |
|---|---|---|---|
| id * | مسیر | string | شناسهٔ اپ. |
| name * | بدنه | string | نام داخلی (≤۸۰). |
| title * | بدنه | string | عنوان نمایشی (≤۱۲۰). |
| description | بدنه | string | توضیح (≤۵۰۰). |
| fields | بدنه | object[] | فیلدهای فرم. |
| groupName | بدنه | string | گروه دفترچه برای ثبتها. |
| consentText | بدنه | string | متن رضایت (≤۳۰۰). |
| submitText | بدنه | string | متن دکمه. |
| successMessage | بدنه | string | پیام موفقیت. |
| verifyLineId | بدنه | string | خط ارسال کد تأیید موبایل. |
خطاهای خاص این endpoint
| 401 | unauthorized | کلید API نامعتبر یا منقضی است. |
| 403 | insufficient_scope | کلید API دامنهٔ دسترسی لازم را ندارد. |
| 400 | validation_error | ورودی نامعتبر است (جزئیات در پاسخ). |
اجرای زنده (محیط تست)
باز کردن در کنسول کامل ←این endpoint در محیط تست پشتیبانی نمیشود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.