درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
توسعه‌دهندگان برنامه‌تان را مطابق با آنچه در بخش‌های زیر توضیح داده شده است ثبت و مدیریت کنید. (ثبت برنامه فرایندی جداگانه است، همان‌طور که در ثبت برنامه‌ها و مدیریت کلیدهای API توضیح داده شده است).
مقدمه
Edge مزایای زیادی ارائه می‌دهد که کاملاً به دانستن اینکه چه کسی با APIهای شما تماس می‌گیرد بستگی دارد. برای مثال، امنیت API، مدیریت ترافیک، و مقدار قابل‌توجهی از داده‌های تجزیه‌وتحلیل به دانستن اینکه چه کسی تماس می‌گیرد بستگی دارد. و Edge چگونه متوجه می‌شود چه کسی با APIهای شما تماس می‌گیرد؟ با خواندن اطلاعات یکتا در هر فراخوانی API، مانند شناسه کاربر، کلید API، یا کد OAuth. این اطلاعات منحصربه‌فرد عملکردی را که در پراکسی‌های API خود می‌سازید قفل یا باز می‌کند و به شما کنترل کامل بر دسترسی و رفتار API می‌دهد.
به همین دلیل است که توسعه‌دهندگان برنامه باید برای استفاده از میاناهای برنامه‌سازی کاربردی شما ثبت‌نام کنند. پس‌از اضافه شدن، توسعه‌دهندگان برنامه‌هایشان را ثبت می‌کنند، میاناهای برنامه‌سازی کاربردی موردنظرشان را برای استفاده انتخاب می‌کنند، و اطلاعات اعتباری میانای برنامه‌سازی کاربردی منحصربه‌فرد (کلیدها و رمزهای مصرف‌کننده) موردنیاز برای دسترسی به میاناهای برنامه‌سازی کاربردی شما را دریافت می‌کنند.
نحوه ثبت‌نام توسعه‌دهندگان نرم‌افزار
توسعه‌دهندگان نرم‌افزار را بااستفاده از یکی از روش‌های زیر ثبت کنید:
- اگر حساب Edge پولی دارید، توسعه‌دهندگان می‌توانند ازطریق درگاه توسعه‌دهندگان خودثبت‌نام کنند. برای کسب اطلاعات بیشتر،
بسته به نوع درگاه توسعه‌دهندگان، یکی از بخش‌های زیر را ببینید:
- درگاه یکپارچه: ایجاد حساب توسعه‌دهنده در درگاه یکپارچه
- Drupal 10: ثبت حساب توسعه‌دهنده برنامه
- Drupal 7: افزودن و مدیریت حساب‌های کاربری
- سرپرستان می‌توانند توسعه‌دهندگان نرم‌افزار را بااستفاده از میانای برنامه‌سازی کاربردی ثبت کنند.
- به‌عنوان سرپرست درگاه توسعه‌دهندگان، توسعه‌دهندگان را مستقیماً در درگاهتان مدیریت کنید، همان‌طور که در بخش‌های زیر توضیح داده شده است:
- درگاه یکپارچه: برای مدیریت حساب‌های توسعه‌دهنده، حساب‌های توسعه‌دهنده را مدیریت کنید.
- Drupal 10: نحوه تعامل توسعه‌دهندگان برنامه با واحد Apigee Edge
- Drupal 7: افزودن و مدیریت حساب‌های کاربری
- به‌عنوان سرپرست سازمان، توسعه‌دهندگان را بااستفاده از واسط کاربر یا میانای برنامه‌سازی کاربردی Edge، همان‌طور که در بخش‌های زیر توضیح داده شده است، مدیریت کنید.
توصیه‌هایی برای مدیریت حساب‌های توسعه‌دهنده در درگاه‌های توسعه‌دهنده
Apigee توصیه می‌کند که حساب‌های توسعه‌دهنده را مستقیماً در درگاه توسعه‌دهنده خود مدیریت کنید.
اگر از درگاه یکپارچه استفاده می‌کنید، این تنها راهی است که از همگام بودن حساب‌های توسعه‌دهنده در درگاه یکپارچه و Edge مطمئن می‌شوید.
اگر از درگاه توسعه‌دهنده مبتنی بر Drupal استفاده می‌کنید، مدیریت مستقیم حساب‌های توسعه‌دهنده در درگاه توسعه‌دهنده مزایای زیر را دارد:
- وقتی توسعه‌دهنده‌ای را ازطریق
میانای سرپرست در درگاه اضافه می‌کنید، می‌توانید گذرواژه توسعه‌دهنده را برای درگاه تنظیم کنید و
پیام ایمیل خودکاری را که به توسعه‌دهنده ارسال می‌شود راه‌اندازی کنید.
هنگام افزودن یا اصلاح توسعه‌دهنده بااستفاده از Edge، ایمیلی به توسعه‌دهنده ارسال نمی‌شود و نمی‌توانید گذرواژه توسعه‌دهنده را در درگاه تنظیم کنید. بنابراین، توسعه‌دهنده باید گذرواژه خود را در درگاه بازنشانی کند تا بتواند به سیستم درگاه وارد شود.
- هر تغییری که در حساب توسعه‌دهنده در درگاه ایجاد شود به‌طور خودکار به Edge ارسال می‌شود.
اگر تصمیم دارید حساب‌های توسعه‌دهنده مبتنی بر Drupal را بااستفاده از Edge مدیریت کنید، باید توسعه‌دهندگان برنامه را بین درگاه و Edge همگام‌سازی کنید.
کاوش صفحه «توسعه‌دهندگان»
بااستفاده از «میانای کاربر Edge» و «میانای کاربر جدید Edge» به صفحه «توسعه‌دهندگان» دسترسی پیدا کنید و آن را کاوش کنید.
Edge
برای دسترسی به صفحه «توسعه‌دهندگان» بااستفاده از «میانای کاربری Edge»:
- به سیستم apigee.com/edge وارد شوید.
- در نوار پیمایش سمت راست، انتشار > توسعه‌دهندگان را انتخاب کنید.
صفحه «توسعه‌دهندگان» نمایش داده می‌شود.
همان‌طور که در شکل برجسته شده است، صفحه «توسعه‌دهندگان» به شما امکان می‌دهد:
- افزودن توسعه‌دهنده
- مشاهده و ویرایش جزئیات توسعه‌دهنده، ازجمله موارد زیر:
- صادر کردن داده‌های انتشار
- حذف توسعه‌دهنده
- جستجو در فهرست توسعه‌دهندگان
میانای کاربر Edge جدید (ابر خصوصی)
برای دسترسی به صفحه «توسعه‌دهندگان» بااستفاده از «واسط کاربر Edge جدید»:
- در
http://host:3001/edgeبه سیستم «میانای کاربر Edge جدید» وارد شوید. در اینجا، host نشانی IP یا نام ساناد میزبان اجرای «میانای کاربر Edge جدید» است. - در نوار پیمایش سمت راست، انتشار > توسعه‌دهندگان را انتخاب کنید.
صفحه «توسعه‌دهندگان» نمایش داده می‌شود.
همان‌طور که در شکل برجسته شده است، صفحه «توسعه‌دهندگان» به شما امکان می‌دهد:
- افزودن توسعه‌دهنده
- مشاهده و ویرایش جزئیات توسعه‌دهنده، ازجمله موارد زیر:
- صادر کردن داده‌های انتشار
- حذف توسعه‌دهنده
- جستجو در فهرست توسعه‌دهندگان
درحال افزودن توسعه‌دهنده
برای افزودن توسعه‌دهنده:
- به صفحه «توسعه‌دهندگان» دسترسی پیدا کنید.
- روی + توسعه‌دهنده کلیک کنید.
- جزئیات توسعه‌دهنده، ازجمله نام، نام خانوادگی، ایمیل، و نام کاربری را وارد کنید.
- روی ایجاد کردن کلیک کنید.
مشاهده و ویرایش جزئیات توسعه‌دهنده
جزئیات توسعه‌دهنده را مشاهده و ویرایش کنید. برای سازمان‌های دارای درآمدزایی، می‌توانید مشخصه‌های سفارشی درآمدزایی تعریف‌شده در پیکربندی مشخصه‌های درآمدزایی را ویرایش کنید.
برای مشاهده و ویرایش جزئیات توسعه‌دهنده:
- به صفحه «توسعه‌دهندگان» دسترسی پیدا کنید.
- روی ردیف توسعه‌دهنده‌ای که می‌خواهید مشاهده و ویرایش کنید کلیک کنید تا جزئیات توسعه‌دهنده باز شود.
- در بخش «جزئیات»، اطلاعات زیر نمایش داده می‌شود. جزئیات توسعه‌دهنده را درصورت لزوم ویرایش کنید.
جزئیات شرح جزئیات نام و نام خانوادگی توسعه‌دهنده، نام کاربری، و ایمیل؛ وضعیت و مدت ثبت‌نام؛ و شناسه توسعه‌دهنده.
برای ویرایش جزئیات توسعه‌دهنده، در هریک از فیلدهای زیر کلیک کنید:- نام
- نام خانوادگی
- ایمیل
- نام کاربری
مشخصه‌های سفارشی مشخصه‌های سفارشی تعریف‌شده برای توسعه‌دهنده. مشخصه‌های سفارشی را درصورت نیاز پیکربندی کنید. برای کسب اطلاعات بیشتر، این موارد را ببینید: برنامه‌ها برنامه‌هایی که توسعه‌دهنده ثبت کرده است. ثبت برنامه‌ها را ببینید. - توسعه‌دهنده را در فیلد «وضعیت» فعال یا غیرفعال کنید.
برای اطلاعات بیشتر، فعال و غیرفعال کردن توسعه‌دهنده را ببینید.
با Apigee Edge برای «ابر عمومی»، پس‌از دسترسی به نهادها، Edge نهادهای زیر را حداقل ۱۸۰ ثانیه در حافظه نهان نگه می‌دارد.
- کدهای دسترسی OAuth. این یعنی یک کد باطل‌شده ممکن است تا سه دقیقه همچنان موفق عمل کند، تا زمانی که حد مجاز حافظه نهان آن منقضی شود.
- نهادهای «خدمات مدیریت کلید» (KMS) (برنامه‌ها، توسعه‌دهندگان، محصولات میانای برنامه‌سازی کاربردی).
- مشخصه‌های سفارشی در ژتون‌های OAuth و نهادهای KMS.
مدیریت مشخصه‌های سفارشی برای توسعه‌دهنده
حداکثر ۱۸ مشخصه سفارشی برای هر توسعه‌دهنده اضافه کنید، ازجمله مشخصه‌های درآمدزایی که در پیکربندی مشخصه‌های درآمدزایی توضیح داده شده است.
برای مدیریت مشخصه‌های سفارشی:
- به صفحه «توسعه‌دهندگان» دسترسی پیدا کنید.
- روی ردیف توسعه‌دهنده‌ای که می‌خواهید ویژگی‌های سفارشی آن را مدیریت کنید کلیک کنید تا جزئیات توسعه‌دهنده باز شود.
- در بخش «مشخصه‌های سفارشی»، روی + کلیک کنید.
- نام و مقدار مشخصه را وارد کنید.
- روی
کلیک کنید. - برای حذف کردن یک مشخصه سفارشی، مکان‌نمای خود را روی مشخصه قرار دهید
و روی
در منو کنش‌ها کلیک کنید.
فعال و غیرفعال کردن توسعه‌دهنده
وقتی توسعه‌دهنده برنامه در درگاه شما خودثبت‌نام می‌کند، می‌توانید پیکربندی کنید که آیا به‌طور پیش‌فرض فعال باشد یا نه.
وقتی توسعه‌دهنده‌ای غیرفعال باشد، توسعه‌دهنده همچنان می‌تواند به سیستم درگاه توسعه‌دهنده وارد شود و برنامه ایجاد کند، اما هیچ‌یک از کلیدهای API مربوطه کار نخواهد کرد. برنامه‌های توسعه‌دهنده همچنان وضعیت تأییدشده (یا وضعیت دیگر) خود را حفظ می‌کنند، همچنین کلیدهای API نیز وضعیت خود را حفظ می‌کنند، حتی اگر در مدتی که توسعه‌دهنده غیرفعال است معتبر نباشند.
برای فعال یا غیرفعال کردن توسعه‌دهنده:
- به صفحه «توسعه‌دهندگان» دسترسی پیدا کنید.
- روی ردیف توسعه‌دهنده‌ای که می‌خواهید فعال یا غیرفعال کنید کلیک کنید تا جزئیات توسعه‌دهنده باز شود.
- در بخش «جزئیات»، فیلد وضعیت را درصورت نیاز روی فعال یا غیرفعال تنظیم کنید.
- اگر توسعه‌دهنده در چند سازمان است، مراحل را تکرار کنید.
درحال صادر کردن داده‌های انتشار
داده‌های انتشار زیر را به‌عنوان فایل مقادیر جداشده با کاما (CSV) صادر کنید:
- جزئیات توسعه‌دهنده
- جزئیات توسعه‌دهنده، برنامه، و محصول «میانای برنامه‌سازی کاربردی»
برای صادر کردن داده‌های انتشار:
- به صفحه «توسعه‌دهندگان» دسترسی پیدا کنید.
- روی صادر کردن CSV… کلیک کنید
- توسعه‌دهندگان یا توسعه‌دهندگان، برنامه‌ها، و محصولات را از منو کرکره‌ای انتخاب کنید.
داده‌های انتشار انتخاب‌شده به‌عنوان فایل CSV بارگیری می‌شود.
حذف توسعه‌دهنده
برای حذف توسعه‌دهنده:
- به صفحه «توسعه‌دهندگان» دسترسی پیدا کنید.
- مکان‌نما را روی ردیف توسعه‌دهنده‌ای که می‌خواهید حذف کنید قرار دهید تا منو کنش‌ها نمایش داده شود.
- روی کلیک کنید.
- برای تأیید حذف، روی حذف کلیک کنید.
همگام‌سازی توسعه‌دهندگان برنامه بین درگاه و Edge
اگر از پورتال توسعه‌دهندگان مبتنی بر Drupal برای انتشار «میاناهای برنامه‌سازی کاربردی» استفاده می‌کنید، تغییرات ایجادشده در توسعه‌دهندگان برنامه بااستفاده از Edge به پورتال منتقل نمی‌شود. برای اینکه این تغییرات در درگاه نشان داده شود، باید به‌عنوان سرپرست درگاه به سیستم درگاه وارد شوید و درگاه را با Edge همگام‌سازی کنید.
را ببینید.برای همگام‌سازی کردن پورتال توسعه‌دهنده با توسعه‌دهندگان برنامه‌ای که در Edge تعریف شده‌اند، به بخش‌های زیر مراجعه کنید:
- Drupal 10: همگام‌سازی توسعه‌دهندگان با Apigee Edge
- Drupal 7: همگام‌سازی توسعه‌دهندگان برنامه بین درگاه و Edge
گروه‌بندی توسعه‌دهندگان در شرکت‌ها
با درآمدزایی، شرکت مجموعه‌ای از توسعه‌دهندگان است که به‌عنوان یک نهاد واحد مدیریت می‌شوند. شرکت می‌تواند هر گروهی باشد که برای سازمان شما مناسب است، مثل واحد کسب‌وکار، خط تولید، یا بخش. گروه‌بندی توسعه‌دهندگان در شرکت‌ها زمانی مفید است که نیاز داشته باشید چند توسعه‌دهنده تحت یک نهاد شرکتی واحد مرتبط باشند. برای مثال، ممکن است لازم باشد شرکت‌های مختلفی را برای اهداف صدور صورت‌حساب راه‌اندازی کنید. بااین‌حال، توسعه‌دهندگان در سازمان شما نیازی به ارتباط با شرکت ندارند. توجه داشته باشید که توسعه‌دهنده همیشه یک نهاد واحد است که با عنصر ایمیل به‌طور یکتا شناسایی می‌شود. اگر توسعه‌دهنده‌ای بخشی از یک شرکت باشد، نام شرکت را در صفحه «توسعه‌دهندگان» خواهید دید.
برای اطلاعات بیشتر درباره مدیریت شرکت‌ها و توسعه‌دهندگان برای درآمدزایی، به مدیریت شرکت‌ها و توسعه‌دهندگان مراجعه کنید.
درحال پیکربندی مشخصه‌های درآمدزایی
هنگام ویرایش توسعه‌دهنده بااستفاده از واسط کاربر یا ایجاد یا ویرایش توسعه‌دهنده بااستفاده از میانای برنامه‌سازی کاربردی، می‌توانید دارایی‌های درآمدزایی تعریف‌شده در جدول زیر را پیکربندی کنید. در ابتدا، شما ویژگی‌های درآمدزایی را برای سازمان هنگام ویرایش نمایه سازمان پیکربندی می‌کنید.
| نام فیلد | نام مشخصه سفارشی | شرح |
|---|---|---|
| نشانی | 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، می‌توانید مشخصه‌های درآمدزایی را که در پیکربندی مشخصه‌های درآمدزایی توضیح داده شده است، درصورت نیاز پیکربندی کنید.