شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات
اگر میخواهید کنترل بیشتری روی شرکتها و توسعهدهندگانی که در برنامه API پولی شما شرکت میکنند داشته باشید - مثلاً اگر میخواهید شرکتها و توسعهدهندگان داخلی را برای اهداف آزمایشی ایجاد کنید - میتوانید شرکتها و توسعهدهندگان را به صورت دستی با رابط کاربری و API مدیریتی ایجاد کنید.
یک ملاحظه اصلی که تعیین میکند آیا شما نیاز به ایجاد دستی شرکتها و توسعهدهندگان دارید یا خیر، این است که آیا توسعهدهندگان برای ورود به رابط کاربری مدیریت، ارسال اعتبارنامه در تماسها به API مدیریت Edge یا ورود به پورتال توسعهدهندگان به اعتبارنامه نیاز دارند یا خیر.
- اگر توسعهدهندگان کسب درآمد شما برای دسترسی به رابط کاربری یا API اج به اطلاعات ورود نیاز دارند، ابتدا باید حساب کاربری ادمین Apigee خود را داشته باشند.
- اگر نیاز دارید که صرفاً توسعهدهندگان آزمایشی ایجاد کنید که نیازی به اعتبارنامه ندارند (برای مثال، اگر میخواهید با توسعهدهندگان آزمایشی فرضی، فراخوانیهای API انجام دهید)، هیچ حساب کاربری Apigee لازم نیست.
مدیریت توسعهدهندگان برنامه با استفاده از رابط کاربری
همانطور که در مدیریت توسعهدهندگان برنامه توضیح داده شده است، توسعهدهندگان برنامه را با استفاده از رابط کاربری Edge ایجاد، مدیریت و فعال کنید. پس از ایجاد توسعهدهندگان برنامه، میتوانید آنها را به شرکتها اضافه کنید، همانطور که در بخشهای بعدی توضیح داده شده است.
مدیریت شرکتها با استفاده از رابط کاربری
همانطور که در بخشهای بعدی توضیح داده شده است، شرکتها را ایجاد، مدیریت و فعال کنید.
بررسی صفحه شرکتها
همانطور که در زیر توضیح داده شده است، به صفحه شرکتها دسترسی پیدا کنید.
لبه
برای دسترسی به صفحه شرکتها با استفاده از رابط کاربری Edge:
- وارد apigee.com/edge شوید.
- در نوار ناوبری سمت چپ، گزینه انتشار > کسب درآمد > شرکتها را انتخاب کنید.
صفحه شرکتها نمایش داده میشود.

همانطور که در شکل مشخص شده است، صفحه شرکتها به شما امکان میدهد:
- مشاهده خلاصه اطلاعات همه شرکتها، شامل نام شرکت، شناسه ثبت، تعداد برنامههای ثبتشده و کلیدهای API، نوع صورتحساب، تعداد توسعهدهندگان اختصاصیافته به شرکت و وضعیت
- اضافه کردن شرکت
- فعال یا غیرفعال کردن شرکت
- ویرایش یک شرکت
- حذف یک شرکت
- جستجو در لیست شرکتها
لبه کلاسیک (ابر خصوصی)
برای دسترسی به صفحه شرکتها با استفاده از رابط کاربری کلاسیک اج:
- وارد آدرس
http:// ms-ip :9000شوید، که در آن ms-ip آدرس IP یا نام DNS گره سرور مدیریت است. - در نوار ناوبری بالا، گزینه انتشار > شرکتها را انتخاب کنید.
صفحه شرکتها نمایش داده میشود.

- مشاهده لیست فعلی شرکتها
- مدیریت یک شرکت. به طور خاص، اضافه کردن، فعال کردن، ویرایش و حذف یک شرکت.
- مشاهده پورتال توسعهدهندگان متصل (فقط دروپال ۷)
اضافه کردن شرکت
برای افزودن شرکت:
- به صفحه شرکتها دسترسی پیدا کنید .
- کلیک + شرکت .
- مشخصات شرکت را وارد کنید.
فیلدهای مورد نیاز شامل موارد زیر است:
- نام شرکت
- مدیر (کاربری که مدیر اصلی شرکت است)
- نوع صورتحساب
بسته به پیکربندی صورتحساب کسب درآمد، نوع صورتحساب ممکن است به صورت پیشفرض روی
PREPAIDیاPOSTPAIDباشد. برای اطلاعات بیشتر، به پیکربندی انواع صورتحساب پیشپرداخت و پسپرداخت با استفاده از API مراجعه کنید. - یک یا چند توسعهدهنده به شرکت اضافه کنید.
- در بخش توسعهدهندگان، یک رشته را در فیلد «افزودن توسعهدهنده» وارد کنید تا فهرست توسعهدهندگانی که با رشته مطابقت دارند نمایش داده شود.
- یک توسعهدهنده را از لیست کشویی انتخاب کنید.
- برای اضافه کردن توسعهدهندگان بیشتر به شرکت، این کار را تکرار کنید.
- یک یا چند ویژگی سفارشی اضافه کنید.
- در بخش ویژگیهای سفارشی، روی + جدید کلیک کنید.
- نام و مقدار ویژگی سفارشی را وارد کنید.
- برای افزودن ویژگیهای سفارشی اضافی به شرکت، این کار را تکرار کنید.
- روی ایجاد شرکت کلیک کنید.
فعال و غیرفعال کردن شرکت
برای فعال و غیرفعال کردن یک شرکت:
- به صفحه شرکت دسترسی پیدا کنید .
- مکان نما را روی شرکتی که می خواهید فعال و فعال کنید قرار دهید
در منوی اقدامات
برای غیرفعال کردن شرکت، ضامن را غیرفعال کنید.
ویرایش یک شرکت
برای ویرایش شرکت:
- به صفحه شرکت دسترسی پیدا کنید .
- مکان نما را روی شرکتی که می خواهید ویرایش کنید قرار دهید و کلیک کنید
در منوی اقدامات - در صورت نیاز، جزئیات شرکت را بهروزرسانی کنید.
- برای ذخیره تغییرات، روی بهروزرسانی شرکت کلیک کنید.
حذف یک شرکت
برای حذف شرکت:
- به صفحه شرکتها دسترسی پیدا کنید .
- مکان نما را روی شرکتی که می خواهید حذف کنید قرار دهید و کلیک کنید
در منوی اقدامات - برای تأیید عملیات حذف، روی حذف کلیک کنید.
مدیریت شرکتها و توسعهدهندگان با استفاده از API
استفاده از API برای مدیریت شرکتها و توسعهدهندگان در بخشهای بعدی توضیح داده شده است.
ایجاد و بهروزرسانی شرکتها و توسعهدهندگان با استفاده از API
برای مدیریت شرکتها و توسعهدهندگان با API مدیریت لبه 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 به 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
گزینههای پیکربندی نقش توسعهدهنده زیر در API نمایش داده میشوند:
| نام | توضیحات | پیشفرض | الزامی است؟ |
|---|---|---|---|
name | نام نقش توسعهدهنده. | ناموجود | بله |
description | شرح نقش توسعهدهنده | ناموجود | بله |
بازیابی نرخ مالیات برای یک توسعهدهنده با استفاده از 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های کسب درآمد انجام دهید، فهرست میکند. این جدول همچنین فهرستی از مکانهایی را که میتوانید دستورالعملهای دقیق برای انجام این وظایف را بیابید، ارائه میدهد.
| وظیفه | دستورالعملهای find کجا هستند؟ |
|---|---|
| مشاهده شرایط و ضوابط پذیرفته شده توسط توسعهدهنده | مشاهده شرایط و ضوابط پذیرفته شده توسط یک توسعهدهنده یا شرکت با استفاده از API |
| مشاهده بستههای API پذیرفته شده توسط یک توسعهدهنده | مشاهده بستههای محصول API که توسط یک توسعهدهنده یا شرکت استفادهکننده از API پذیرفته شدهاند |
| یک طرح نرخ توسعهدهنده ایجاد کنید | |
| مشاهده طرحهای نرخ موجود برای یک توسعهدهنده | |
| مشاهده طرحهای نرخ موجود برای یک توسعهدهنده خاص که شامل یک محصول خاص هستند | مشاهده طرح نرخ پذیرفتهشده برای توسعهدهندهای که شامل یک محصول API با استفاده از API است |
| فقط طرحهای نرخ توسعهدهنده پذیرفتهشده را مشاهده کنید | مشاهده تمام طرحهای نرخ پذیرفتهشده توسط یک توسعهدهنده با استفاده از API |
| اعطای اعتبار به توسعهدهنده | |
| تعیین سقف اعتبار برای توسعهدهنده | |
| مشاهده محدودیت اعتبار توسعهدهنده | |
| «افزایش موجودی» (افزودن مبلغی به) موجودی پیشپرداخت توسعهدهنده | |
| مشاهده مانده پیشپرداخت توسعهدهنده | |
| تنظیم شرایط اعلان برای یک توسعهدهنده | |
| ایجاد و مشاهده تعاریف گزارش برای یک توسعهدهنده |