شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات
همانطور که در بخشهای بعدی توضیح داده شده است، توسعهدهندگان برنامه خود را ثبت و مدیریت کنید. (ثبت برنامه یک فرآیند جداگانه است، همانطور که در ثبت برنامهها و مدیریت کلیدهای API توضیح داده شده است).
مقدمه
اج مزایای زیادی ارائه میدهد که کاملاً به دانستن اینکه چه کسی APIهای شما را فراخوانی میکند، وابسته است. به عنوان مثال، امنیت API، مدیریت ترافیک و مقدار قابل توجهی از دادههای تحلیلی به دانستن اینکه چه کسی فراخوانی میکند بستگی دارد. و اج چگونه میداند چه کسی APIهای شما را فراخوانی میکند؟ با خواندن اطلاعات منحصر به فرد در هر فراخوانی API، مانند شناسه کاربر، کلید API یا توکن OAuth. این اطلاعات منحصر به فرد، عملکردی را که در پروکسیهای API خود ایجاد میکنید، قفل یا باز میکند و به شما کنترل کامل بر دسترسی و رفتار API را میدهد.
به همین دلیل است که توسعهدهندگان برنامه برای استفاده از APIهای شما باید ثبتنام کنند. پس از اضافه شدن، توسعهدهندگان برنامههای خود را ثبتنام میکنند، APIهایی را که میخواهند استفاده کنند انتخاب میکنند و اعتبارنامههای API منحصر به فرد (کلیدهای مصرفکننده و اسرار) مورد نیاز برای دسترسی به APIهای شما را دریافت میکنند.
نحوه ثبت نام توسعه دهندگان اپلیکیشن
توسعهدهندگان اپلیکیشن را با استفاده از یکی از روشهای زیر ثبتنام کنید:
- اگر حساب کاربری پولی Edge دارید، توسعهدهندگان میتوانند از طریق پورتال توسعهدهندگان، خودشان ثبتنام کنند. برای اطلاعات بیشتر، بر اساس نوع پورتال توسعهدهندگان، به یکی از بخشهای زیر مراجعه کنید:
- پورتال یکپارچه: یک حساب توسعهدهنده در پورتال یکپارچه ایجاد کنید
- دروپال ۱۰: ثبت نام یک حساب توسعهدهنده اپلیکیشن
- دروپال ۷: افزودن و مدیریت حسابهای کاربری
- مدیران میتوانند توسعهدهندگان برنامه را با استفاده از API ثبت کنند .
- به عنوان مدیر پورتال توسعهدهندگان، همانطور که در بخشهای زیر توضیح داده شده است، توسعهدهندگان را مستقیماً در پورتال خود مدیریت کنید:
- پورتال یکپارچه: مدیریت حسابهای توسعهدهنده برای مدیریت حسابهای توسعهدهنده.
- دروپال ۱۰: چگونه توسعهدهندگان اپلیکیشن با ماژول Apigee Edge تعامل میکنند
- دروپال ۷: افزودن و مدیریت حسابهای کاربری
- به عنوان مدیر سازمان، توسعهدهندگان را با استفاده از رابط کاربری یا API اج، همانطور که در بخشهای بعدی توضیح داده شده است، مدیریت کنید.
توصیههایی برای مدیریت حسابهای توسعهدهندگان در پورتالهای توسعهدهندگان
شرکت Apigee توصیه میکند که حسابهای توسعهدهندگان را مستقیماً در پورتال توسعهدهندگان خود مدیریت کنید.
اگر از پورتال یکپارچه استفاده میکنید، این تنها راه برای اطمینان از همگام ماندن حسابهای توسعهدهنده در پورتال یکپارچه و Edge است.
اگر از پورتال توسعهدهندگان مبتنی بر دروپال استفاده میکنید، مدیریت حسابهای توسعهدهندگان به طور مستقیم در پورتال توسعهدهندگان مزایای زیر را ارائه میدهد:
- وقتی یک توسعهدهنده را از طریق رابط کاربری مدیر در پورتال اضافه میکنید، میتوانید رمز عبور توسعهدهنده را برای پورتال تنظیم کنید و یک ایمیل خودکار برای توسعهدهنده ارسال کنید.
هنگام اضافه کردن یا تغییر یک توسعهدهنده با استفاده از Edge، هیچ ایمیلی برای توسعهدهنده ارسال نمیشود و شما نمیتوانید رمز عبور را برای توسعهدهنده در پورتال تنظیم کنید. بنابراین، توسعهدهنده باید قبل از ورود به پورتال، رمز عبور خود را در پورتال بازنشانی کند.
- هر تغییری که در حساب توسعهدهنده در پورتال ایجاد شود، بهطور خودکار به Edge ارسال میشود.
اگر تصمیم دارید حسابهای توسعهدهندگان مبتنی بر دروپال را با استفاده از Edge مدیریت کنید، باید توسعهدهندگان برنامه را بین پورتال و Edge همگامسازی کنید .
بررسی صفحه توسعهدهندگان
با استفاده از رابط کاربری Edge و رابط کاربری کلاسیک Edge به صفحه توسعهدهندگان دسترسی پیدا کنید و آن را بررسی کنید.
لبه
برای دسترسی به صفحه توسعهدهندگان با استفاده از رابط کاربری Edge:
- وارد apigee.com/edge شوید.
- در نوار ناوبری سمت چپ، گزینه انتشار > توسعهدهندگان را انتخاب کنید.
صفحه توسعهدهندگان نمایش داده میشود.
همانطور که در شکل مشخص شده است، صفحه توسعهدهندگان شما را قادر میسازد تا:
- اضافه کردن توسعهدهنده
- مشاهده و ویرایش جزئیات توسعهدهنده ، شامل موارد زیر:
- دادههای انتشار را صادر کنید
- حذف یک توسعهدهنده
- جستجو در لیست توسعهدهندگان
لبه کلاسیک (ابر خصوصی)
برای دسترسی به صفحه توسعهدهندگان با استفاده از رابط کاربری کلاسیک اج:
- وارد آدرس
http:// ms-ip :9000شوید، که در آن ms-ip آدرس IP یا نام DNS گره سرور مدیریت است. - در نوار ناوبری بالا، گزینه انتشار > توسعهدهندگان را انتخاب کنید.
صفحه توسعهدهندگان نمایش داده میشود.
- مشاهده لیست توسعهدهندگان
- اضافه کردن توسعهدهنده
- مشاهده و ویرایش جزئیات توسعهدهنده، از جمله ویژگیهای سفارشی، و فعالسازی یک توسعهدهنده
- دادههای انتشار را صادر کنید
- حذف یک توسعهدهنده
- جستجو در لیست توسعهدهندگان
- مشاهده پورتال توسعهدهندگان متصل (فقط دروپال ۷)
اضافه کردن یک توسعهدهنده
برای اضافه کردن یک توسعهدهنده:
- به صفحه توسعهدهندگان دسترسی پیدا کنید.
- روی + توسعهدهنده کلیک کنید.
- اطلاعات توسعهدهنده، شامل نام، نام خانوادگی، ایمیل و نام کاربری را وارد کنید.
- روی ایجاد کلیک کنید.
مشاهده و ویرایش جزئیات توسعهدهنده
مشاهده و ویرایش جزئیات توسعهدهنده. برای سازمانهایی که قابلیت کسب درآمد دارند، میتوانید ویژگیهای سفارشی کسب درآمد را که در پیکربندی ویژگیهای کسب درآمد تعریف شدهاند، ویرایش کنید.
برای مشاهده و ویرایش جزئیات توسعهدهنده:
- به صفحه توسعهدهندگان دسترسی پیدا کنید.
- برای باز کردن جزئیات توسعهدهنده، روی ردیف توسعهدهندهای که میخواهید مشاهده و ویرایش کنید، کلیک کنید.
- در بخش جزئیات، اطلاعات زیر نمایش داده میشود. در صورت نیاز، جزئیات توسعهدهنده را ویرایش کنید.
جزئیات توضیحات جزئیات نام و نام خانوادگی، نام کاربری و ایمیل توسعهدهنده؛ وضعیت و مدت زمان ثبتنام؛ و شناسه توسعهدهنده.
برای ویرایش اطلاعات توسعهدهنده، روی هر یک از فیلدهای زیر کلیک کنید:- نام
- نام خانوادگی
- ایمیل
- نام کاربری
ویژگیهای سفارشی ویژگیهای سفارشی تعریفشده برای توسعهدهنده. ویژگیهای سفارشی را در صورت نیاز پیکربندی کنید. برای اطلاعات بیشتر، به موارد زیر مراجعه کنید: برنامهها برنامههایی که توسط توسعهدهنده ثبت شدهاند. به بخش ثبت برنامهها مراجعه کنید. - توسعهدهنده را در فیلد وضعیت فعال یا غیرفعال کنید.
برای اطلاعات بیشتر، به فعالسازی و غیرفعالسازی توسعهدهنده مراجعه کنید.
با Apigee Edge برای فضای ابری عمومی ، Edge موجودیتهای زیر را حداقل به مدت ۱۸۰ ثانیه پس از دسترسی به آنها در حافظه پنهان (cache) نگه میدارد.
- توکنهای دسترسی OAuth. این بدان معناست که یک توکن لغو شده ممکن است تا سه دقیقه، تا زمانی که محدودیت حافظه پنهان آن منقضی شود، همچنان موفق باشد.
- موجودیتهای سرویس مدیریت کلید (KMS) (برنامهها، توسعهدهندگان، محصولات API).
- ویژگیهای سفارشی روی توکنهای OAuth و موجودیتهای KMS.
مدیریت ویژگیهای سفارشی برای یک توسعهدهنده
برای هر توسعهدهنده، حداکثر ۱۸ ویژگی سفارشی اضافه کنید، از جمله ویژگیهای کسب درآمد که در پیکربندی ویژگیهای کسب درآمد توضیح داده شده است.
برای مدیریت ویژگیهای سفارشی:
- به صفحه توسعهدهندگان دسترسی پیدا کنید.
- برای باز کردن جزئیات توسعهدهنده، روی ردیف توسعهدهندهای که میخواهید ویژگیهای سفارشی آن را مدیریت کنید، کلیک کنید.
- در بخش ویژگیهای سفارشی، روی + کلیک کنید.
- نام و مقدار ویژگی را وارد کنید.
- کلیک
. - برای حذف یک ویژگی سفارشی، مکاننما را روی ویژگی قرار دهید و کلیک کنید
در منوی اقدامات
فعال و غیرفعال کردن توسعهدهنده
وقتی یک توسعهدهندهی اپلیکیشن خودش در پورتال شما ثبتنام میکند، میتوانید فعال بودن یا نبودن پیشفرض آن را پیکربندی کنید.
وقتی یک توسعهدهنده غیرفعال است، توسعهدهنده همچنان میتواند وارد پورتال توسعهدهندگان شود و برنامهها را ایجاد کند، اما هیچ یک از کلیدهای API مربوطه کار نخواهند کرد. برنامههای توسعهدهنده همچنان وضعیت تأیید شده (یا سایر) خود را حفظ میکنند، همانطور که کلیدهای API نیز همینطور هستند، حتی اگر در زمان غیرفعال بودن توسعهدهنده معتبر نباشند.
برای فعال یا غیرفعال کردن یک توسعهدهنده:
- به صفحه توسعهدهندگان دسترسی پیدا کنید.
- برای باز کردن جزئیات توسعهدهنده، روی ردیف توسعهدهندهای که میخواهید فعال یا غیرفعال کنید، کلیک کنید.
- در بخش جزئیات، فیلد وضعیت را در صورت نیاز روی فعال یا غیرفعال تنظیم کنید.
- اگر توسعهدهنده در چندین سازمان است، مراحل را تکرار کنید.
صادرات دادههای انتشار
دادههای انتشار زیر را به صورت فایل مقادیر جدا شده با کاما (CSV) صادر کنید:
- جزئیات توسعهدهنده
- جزئیات توسعهدهنده، برنامه و محصول API
برای خروجی گرفتن از دادههای انتشار:
- به صفحه توسعهدهندگان دسترسی پیدا کنید.
- روی خروجی CSV کلیک کنید...
- از منوی کشویی، گزینه توسعهدهندگان یا توسعهدهندگان، برنامهها و محصولات را انتخاب کنید.
دادههای انتشار انتخابشده به صورت فایل CSV دانلود میشوند.
حذف یک توسعهدهنده
برای حذف یک توسعهدهنده:
- به صفحه توسعهدهندگان دسترسی پیدا کنید.
- مکاننما را روی ردیف توسعهدهندهای که میخواهید حذف کنید قرار دهید تا منوی اقدامات نمایش داده شود.
- کلیک .
- برای تأیید حذف، روی حذف کلیک کنید.
همگامسازی توسعهدهندگان برنامه بین پورتال و Edge
اگر از یک پورتال توسعهدهندگان مبتنی بر دروپال برای انتشار APIهای خود استفاده میکنید، تغییراتی که در توسعهدهندگان برنامه با استفاده از Edge ایجاد میشود، به پورتال منتقل نمیشود. برای نمایش این تغییرات در پورتال، باید به عنوان مدیر پورتال وارد پورتال شوید و پورتال را با Edge همگامسازی کنید.
برای همگامسازی پورتال توسعهدهندگان خود با توسعهدهندگان برنامه تعریفشده در Edge، به بخشهای زیر مراجعه کنید:
- دروپال ۱۰: همگامسازی توسعهدهندگان با Apigee Edge
- دروپال ۷: همگامسازی توسعهدهندگان برنامه بین پورتال و Edge
گروهبندی توسعهدهندگان در شرکتها
با کسب درآمد، یک شرکت مجموعهای از توسعهدهندگان است که به عنوان یک نهاد واحد مدیریت میشوند. یک شرکت میتواند هر گروهبندی متناسب با سازمان شما مانند واحد تجاری، خط تولید یا بخش باشد. گروهبندی توسعهدهندگان در شرکتها زمانی مفید است که نیاز دارید چندین توسعهدهنده تحت یک نهاد شرکتی واحد مرتبط باشند. به عنوان مثال، ممکن است برای اهداف صدور صورتحساب نیاز به راهاندازی شرکتهای مختلف داشته باشید. با این حال، توسعهدهندگان در سازمان شما نیازی به ارتباط با یک شرکت ندارند. توجه داشته باشید که یک توسعهدهنده همیشه یک نهاد واحد است که به طور منحصر به فرد با عنصر ایمیل مشخص میشود. اگر یک توسعهدهنده بخشی از یک شرکت باشد، نام شرکت را در صفحه توسعهدهندگان مشاهده خواهید کرد.
برای اطلاعات بیشتر در مورد مدیریت شرکتها و توسعهدهندگان برای کسب درآمد، به مدیریت شرکتها و توسعهدهندگان مراجعه کنید.
پیکربندی ویژگیهای کسب درآمد
هنگام ویرایش یک توسعهدهنده با استفاده از رابط کاربری یا ایجاد یا ویرایش یک توسعهدهنده با استفاده از API ، میتوانید ویژگیهای کسب درآمد تعریف شده در جدول زیر را پیکربندی کنید. در ابتدا، هنگام ویرایش نمایه سازمان، ویژگیهای کسب درآمد را برای سازمان پیکربندی میکنید.
| نام فیلد | نام ویژگی سفارشی | توضیحات |
|---|---|---|
| آدرس | MINT_DEVELOPER_ADDRESS | آدرس توسعهدهنده، شامل فیلدهای زیر: آدرس (خطوط ۱ و ۲)، شهر، استان، کد پستی و کشور. |
| مشخصات صورتحساب | MINT_BILLING_PROFILE | چرخه صورتحساب برای سازمان شما. مقادیر معتبر عبارتند از:
|
| نوع صورتحساب | MINT_BILLING_TYPE | مدل پرداخت توسعهدهنده که برای صدور صورتحساب استفاده میشود. مقدار میتواند یکی از موارد زیر باشد:
به پیکربندی انواع صورتحساب پیشپرداخت و پسپرداخت با استفاده از API مراجعه کنید. |
| دسته بندی | MINT_DEVELOPER_CATEGORY | دسته توسعهدهندگانی که میخواهید توسعهدهنده را به آن اضافه کنید. دسته توسعهدهندگان، گروهی از توسعهدهندگان یا شرکتهایی با ویژگیهای مشابه است. برای اطلاعات بیشتر، به مدیریت دستههای توسعهدهندگان مراجعه کنید. |
| شناسه شرکت | MINT_COMPANY_ID | شناسه شرکت، در صورت لزوم. برای اطلاعات بیشتر، به گروهبندی توسعهدهندگان در شرکتها مراجعه کنید. |
| نوع توسعهدهنده | MINT_DEVELOPER_TYPE | این ملک توسط Apigee استفاده نمیشود. نوع توسعهدهنده. مقادیر معتبر عبارتند از: |
| کارگزار است | MINT_IS_BROKER | پرچمی که مشخص میکند آیا درآمد بر اساس خالص است یا خیر. |
| نام قانونی | MINT_DEVELOPER_LEGAL_NAME | نام قانونی توسعهدهنده که در تمام گزارشها استفاده خواهد شد. توجه : این ویژگی در صورتی الزامی است که توسعهدهنده در گروه هیچ شرکتی نباشد و بخواهد در یک طرح نرخ منتشر شده مشترک شود. |
| خودپرداز | MINT_HAS_SELF_BILLING | پرچمی که مشخص میکند آیا فاکتورهای خودپرداخت فعال هستند یا خیر. اگر فعال باشد ( true )، کسب درآمد به جای صورتحساب سهم درآمد، یک فاکتور خودپرداخت ایجاد میکند. فاکتور خودپرداخت یک سند مالی است که مبلغ بدهی به توسعهدهنده را شرح میدهد. این فاکتور به عنوان یک فاکتور برای ارائهدهنده API از طرف توسعهدهنده عمل میکند. |
| شماره مجوز معاف از مالیات | MINT_TAX_EXEMPT_AUTH_NO | شماره معافیت مالیاتی دولت، در صورت وجود. |
| نرخ مالیات | MINT_APPROX_TAX_RATE | نرخ مالیات تقریبی برای توسعهدهنده. یک مقدار اعشاری با حداکثر ۳ کاراکتر قبل از اعشار و ۴ کاراکتر بعد از اعشار مشخص کنید. |
مدیریت توسعهدهندگان با استفاده از API
مدیریت توسعهدهندگان با استفاده از رابطهای برنامهنویسی کاربردی (API) توسعهدهندگان .
هنگام ایجاد و بهروزرسانی یک توسعهدهنده با استفاده از API، میتوانید ویژگیهای کسب درآمد شرح داده شده در پیکربندی ویژگیهای کسب درآمد را در صورت نیاز پیکربندی کنید.