مدیریت شرکت‌ها و توسعه‌دهندگان بااستفاده از Edge

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

اگر می‌خواهید کنترل بیشتری بر شرکت‌ها و توسعه‌دهندگانی که در برنامه API درآمدزایی‌شده شما شرکت می‌کنند داشته باشید—برای مثال، اگر می‌خواهید شرکت‌ها و توسعه‌دهندگان داخلی برای اهداف آزمایش ایجاد کنید—می‌توانید شرکت‌ها و توسعه‌دهندگان را به‌صورت دستی بااستفاده از API و واسط کاربر مدیریت ایجاد کنید.

ملاحظه اصلی که تعیین می‌کند آیا باید شرکت‌ها و توسعه‌دهندگان را به‌صورت دستی ایجاد کنید یا نه این است که آیا توسعه‌دهندگان برای ورود به سیستم واسط کاربر مدیریت، ارسال اطلاعات اعتباری در تماس‌ها به «میانای برنامه‌سازی کاربردی مدیریت Edge»، یا ورود به سیستم درگاه توسعه‌دهندگان به اطلاعات اعتباری نیاز دارند یا نه.

• اگر توسعه‌دهندگان درآمدزایی شما برای دسترسی به «میانای کاربری» یا «میانای برنامه‌سازی کاربردی» Edge به اطلاعات اعتباری ورود به سیستم نیاز دارند، ابتدا باید حساب سرپرست Apigee خودشان را داشته باشند.
• اگر فقط باید توسعه‌دهندگان آزمایشی ایجاد کنید که به اطلاعات اعتباری نیاز ندارند (برای مثال، اگر می‌خواهید با توسعه‌دهندگان آزمایشی ساختگی تماس‌های API برقرار کنید)، به حساب Apigee نیاز ندارید.

مدیریت توسعه‌دهندگان نرم‌افزار بااستفاده از میانای کاربر

توسعه‌دهندگان برنامه را بااستفاده از «واسط کاربر Edge» ایجاد، مدیریت، و فعال کنید، همان‌طور که در مدیریت توسعه‌دهندگان برنامه توضیح داده شده است. پس‌از ایجاد توسعه‌دهندگان نرم‌افزار، می‌توانید آن‌ها را به شرکت‌ها اضافه کنید، همان‌طور که در بخش‌های زیر توضیح داده شده است.

مدیریت شرکت‌ها بااستفاده از میانای کاربر

شرکت‌ها را طبق آنچه در بخش‌های زیر توضیح داده شده است ایجاد، مدیریت، و فعال کنید.

کاوش صفحه «شرکت‌ها»

به صفحه «شرکت‌ها» دسترسی پیدا کنید، همان‌طور که در زیر توضیح داده شده است.

درحال افزودن شرکت

برای افزودن شرکت:

1. به صفحه «شرکت‌ها» دسترسی پیدا کنید.
2. روی + شرکت کلیک کنید.
3. جزئیات شرکت را وارد کنید.

   فیلدهای الزامی شامل موارد زیر است:

   • نام شرکت
   • سرپرست (کاربری که سرپرست اصلی شرکت است)
   • نوع صورت‌حساب

   بسته به پیکربندی صورت‌حساب درآمدزایی، «نوع صورت‌حساب» ممکن است به‌طور پیش‌فرض روی PREPAID یا POSTPAID تنظیم شود. برای کسب اطلاعات بیشتر، پیکربندی انواع صورت‌حساب پیش‌پرداخت و پس‌پرداخت بااستفاده از API را ببینید.

4. یک یا چند توسعه‌دهنده به شرکت اضافه کنید.
   1. در بخش «توسعه‌دهندگان»، رشته‌ای را در فیلد افزودن توسعه‌دهنده وارد کنید تا فهرست توسعه‌دهندگانی که با رشته مطابقت دارند نمایش داده شود.
   2. توسعه‌دهنده‌ای را از فهرست کرکره‌ای انتخاب کنید.
   3. برای افزودن توسعه‌دهندگان بیشتر به شرکت، این کار را تکرار کنید.
5. یک یا چند مشخصه سفارشی اضافه کنید.
   1. در بخش «ویژگی‌های سفارشی»، روی + جدید کلیک کنید.
   2. نام و مقدار مشخصه سفارشی را وارد کنید.
   3. برای افزودن مشخصه‌های سفارشی بیشتر به شرکت، این کار را تکرار کنید.
6. روی ایجاد شرکت کلیک کنید.

فعال و غیرفعال کردن شرکت

برای فعال و غیرفعال کردن شرکت:

1. به صفحه «شرکت» دسترسی پیدا کنید.
2. مکان‌نما را روی شرکتی که می‌خواهید فعال کنید قرار دهید و را در منو کنش‌ها فعال کنید.
   برای غیرفعال کردن شرکت، وضعیت را به خاموش تغییر دهید.

درحال ویرایش شرکت

برای ویرایش شرکت:

1. به صفحه «شرکت» دسترسی پیدا کنید.
2. مکان‌نما را روی شرکتی که می‌خواهید ویرایش کنید قرار دهید و روی در منو کنش‌ها کلیک کنید.
3. جزئیات شرکت را درصورت نیاز به‌روز کنید.
4. برای ذخیره کردن تغییرات، روی به‌روزرسانی شرکت کلیک کنید.

درحال حذف شرکت

برای حذف شرکت:

1. به صفحه «شرکت‌ها» دسترسی پیدا کنید.
2. مکان‌نمای خود را روی شرکتی که می‌خواهید حذف کنید قرار دهید و روی در منو کنش‌ها کلیک کنید.
3. برای تأیید عملیات حذف، روی حذف کلیک کنید.

مدیریت شرکت‌ها و توسعه‌دهندگان بااستفاده از میانای برنامه‌سازی کاربردی

استفاده از API برای مدیریت شرکت‌ها و توسعه‌دهندگان در بخش‌های زیر توضیح داده شده است.

ایجاد و به‌روزرسانی شرکت‌ها و توسعه‌دهندگان بااستفاده از «میانای برنامه‌سازی کاربردی»

برای مدیریت شرکت‌ها و توسعه‌دهندگان با «میانای برنامه‌سازی کاربردی مدیریت Edge API»، به بخش‌های میانای برنامه‌سازی کاربردی زیر مراجعه کنید:

• ایجاد شرکت
• ایجاد توسعه‌دهنده
  توجه: هنگام ایجاد توسعه‌دهنده با ارسال مشخصه‌های سفارشی، اطلاعات درآمدزایی را پیکربندی کنید.
• افزودن یا به‌روزرسانی توسعه‌دهندگان شرکت
  توجه: به‌صورت اختیاری می‌توانید نقشی را به توسعه‌دهنده اختصاص دهید، اگرچه این کار الزامی نیست. برای دریافت فهرست نقش‌های توسعه‌دهنده، به واکشی نقش‌های توسعه‌دهنده مراجعه کنید.
• پیکربندی درآمدزایی فهرست را برای همه توسعه‌دهندگان یا برای یک توسعه‌دهنده
  توجه: اطلاعات درآمدزایی را با ارسال مشخصه‌های سفارشی هنگام ایجاد یا به‌روزرسانی توسعه‌دهنده تعریف کنید. می‌توانید ویژگی‌های سفارشی درآمدزایی را که بااستفاده از میانای برنامه‌سازی کاربردی استاندارد (غیردرآمدزایی) برای فهرست کردن همه توسعه‌دهندگان یا توسعه‌دهنده واحد تنظیم شده است مشاهده کنید.

مدیریت نقش‌های توسعه‌دهنده بااستفاده از API

می‌توانید بااستفاده از «میاناهای برنامه‌سازی کاربردی درآمدزایی» نقش ایجاد کنید. این به شما امکان می‌دهد نقش‌هایی را برای شرکای خود تعیین کنید. برای مثال، می‌توانید نقش‌های سرپرست و توسعه‌دهنده برنامه را برای شریک تعیین کنید. سپس می‌توان این نقش‌ها را به کارمندان شریک خاصی اختصاص داد.

ایجاد نقش توسعه‌دهنده

برای ایجاد نقش توسعه‌دهنده، درخواست POST را به organizations/{org_name}/developer-roles ارسال کنید. وقتی درخواست می‌کنید، باید در متن درخواست نام و شرح نقش و شناسه سازمان را مشخص کنید. برای مثال:

$ curl -H "Content-Type:application/json" -X POST -d \
'{
   "name": "appDeveloper",
   "description": "App Developer",
   "organization": {
       "id": "{org_name}"
   }
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

درحال بازیابی نقش‌های توسعه‌دهنده

برای بازیابی نقش‌های توسعه‌دهنده، درخواست GET را به organizations/{org_id}/developer-roles صادر کنید. برای مثال:

$ curl -H "Accept:application/json" -X GET \
"https:// api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

پاسخ باید چیزی شبیه به این باشد (فقط بخشی از پاسخ نشان داده می‌شود):

{
  "description" : "App Developer",
  "id" : "appdeveloper",
  "name" : "appDeveloper",
  "organization" : {
   ...
  }
}

تنظیمات پیکربندی نقش توسعه‌دهنده برای میانای برنامه‌سازی کاربردی

گزینه‌های پیکربندی نقش توسعه‌دهنده زیر در «میانای برنامه‌سازی کاربردی» نمایان است:

بازیابی نرخ مالیات برای توسعه‌دهنده بااستفاده از API

با صدور درخواست GET به organizations/{org_name}/tax-engine می‌توانید نرخ مالیات فعلی توسعه‌دهنده را دریافت کنید. هنگام ارسال درخواست، باید شناسه توسعه‌دهنده را به‌عنوان پارامتر پُرسمان مشخص کنید. برای مثال:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tax-engine?developerId=dev7@myorg.com" \
-u email:password

پاسخ باید چیزی شبیه به این باشد:

0.09

انجام سایر وظایف مختص توسعه‌دهنده بااستفاده از API

بسیاری از وظایف مربوط به درآمدزایی که می‌توانید برای یک سازمان انجام دهید، مانند ایجاد طرح‌های نرخ یا ایجاد شرایط اعلان، می‌توانید برای یک توسعه‌دهنده فردی نیز انجام دهید. برای مثال، می‌توانید برای یک توسعه‌دهنده خاص حساب بانکی ایجاد کنید یا برای یک توسعه‌دهنده خاص گزارش درآمد خالص تولید کنید.

جدول زیر فهرست وظایف مختص توسعه‌دهندگان را که می‌توانید بااستفاده از میاناهای برنامه‌سازی کاربردی درآمدزایی انجام دهید ارائه می‌دهد. این جدول همچنین فهرست می‌کند که کجا می‌توانید دستورالعمل‌های دقیق درباره انجام این تکالیف را پیدا کنید.