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

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

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

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

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

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

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

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

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

کاوش در صفحه شرکت ها

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

اضافه کردن یک شرکت

برای اضافه کردن یک شرکت:

1. به صفحه شرکت ها دسترسی پیدا کنید .
2. روی + شرکت کلیک کنید.
3. مشخصات شرکت را وارد کنید

   فیلدهای مورد نیاز عبارتند از:

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

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

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

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

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

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

ویرایش یک شرکت

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

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

حذف یک شرکت

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

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

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

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

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

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

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

مدیریت نقش های توسعه دهنده با استفاده از 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 برای سازمان‌ها/{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

گزینه های پیکربندی نقش توسعه دهنده زیر در معرض API قرار می گیرند:

بازیابی نرخ مالیات برای یک توسعه دهنده با استفاده از 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

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

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

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

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

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

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

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

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

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

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

کاوش در صفحه شرکت ها

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

اضافه کردن یک شرکت

برای اضافه کردن یک شرکت:

1. به صفحه شرکت ها دسترسی پیدا کنید .
2. روی + شرکت کلیک کنید.
3. مشخصات شرکت را وارد کنید

   فیلدهای مورد نیاز عبارتند از:

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

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

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

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

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

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

ویرایش یک شرکت

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

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

حذف یک شرکت

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

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

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

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

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

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

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

مدیریت نقش های توسعه دهنده با استفاده از 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 برای سازمان‌ها/{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

گزینه های پیکربندی نقش توسعه دهنده زیر در معرض API قرار می گیرند:

بازیابی نرخ مالیات برای یک توسعه دهنده با استفاده از 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

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

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