مرحله ۳: تغییر نقطه پایان هدف

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

اکنون که کارگزار جدیدتان را آزمایش کرده‌اید، تقریباً آماده‌اید که به آن خط‌مشی اضافه کنید. البته قبل‌از انجام این کار، باید نقطه پایانی هدف کارگزار نیابتی‌تان را به نقطه‌ای تغییر دهید که داده‌هایی را برمی‌گرداند.

به‌یاد داشته باشید که در مرحله ۱: ایجاد پراکسی میانای برنامه‌سازی کاربردی، نقطه پایانی هدف (در فیلد میانای برنامه‌سازی کاربردی موجود) را روی «https://mocktarget.apigee.net» تنظیم کردید. خب، آن نقطه پایانی هیچ داده‌ای برنمی‌گرداند، بنابراین اکنون نقطه پایانی را به نقطه‌ای که مقداری XML برمی‌گرداند تغییر می‌دهید.

برای تغییر دادن نقطه پایانی هدف پراکسی:

1. به سیستم واسط کاربر Edge وارد شوید.
2. توسعه > پراکسی‌های API را انتخاب کنید.
3. کارگزار getstarted را از فهرست انتخاب کنید تا جزئیات کارگزار API نمایش داده شود. اگر کارگزار خود را در فهرست نمی‌بینید، مطمئن شوید که سازمان درست را انتخاب کرده‌اید، همان‌طور که در جابه‌جایی بین سازمان‌ها توضیح داده شده است.

4. روی برگه توسعه کلیک کنید:

   

   با این کار به «ویرایشگر پراکسی API» هدایت می‌شوید. «ویرایشگر پراکسی» به شما امکان می‌دهد ساختار پراکسی API خود را ببینید و جریان آن را پیکربندی کنید. (نگران نباشید. آموزش‌های دیگر مفهوم جریان‌ها را پوشش خواهند داد.)

5. در قاب Navigator، نقطه‌های پایانی هدف > پیش‌فرض را انتخاب کنید:

   

   ‫Edge تنظیمات نقطه پایانی را در قاب کد نمایش می‌دهد:

   <TargetEndpoint name="default">
     <Description/>
     <FaultRules/>
     <PreFlow name="PreFlow">
       <Request/>
       <Response/>
     </PreFlow>
     <PostFlow name="PostFlow">
       <Request/>
       <Response/>
     </PostFlow>
     <Flows/>
     <HTTPTargetConnection>
       <Properties/>
       <URL>https://mocktarget.apigee.net</URL>
     </HTTPTargetConnection>
   </TargetEndpoint>

   نقطه پایانی هدف توسط عنصر <HTTPTargetConnection> تعریف می‌شود.

6. نشانی وب را به «https://mocktarget.apigee.net/xml» تغییر دهید. (افزودن «/xml» به نشانی وب موجود.)

   نشانی وب جدید یک بلوک کوچک XML را در بدنه پاسخ برمی‌گرداند.

   پیکربندی نقطه پایانی شما اکنون باید به این شکل باشد:

   ...
   <HTTPTargetConnection>
     <Properties/>
     <URL>https://mocktarget.apigee.net/xml</URL>
   </HTTPTargetConnection>
   ...

7. برای ذخیره کردن تغییرات در پیکربندی پراکسی، روی دکمه ذخیره کلیک کنید.

   ‫Edge تغییرات شما را ذخیره می‌کند و به‌طور خودکار آن‌ها را مستقر می‌کند.

   اگر خطایی وجود داشته باشد، Edge تغییرات شما را ذخیره می‌کند اما پراکسی را مستقر نمی‌کند. در این مورد:

   1. پیکربندی پراکسی را اصلاح کنید. ‫Edge ممکن است راهنمایی دستور زبان را به‌صورت بالاپر ارائه دهد.
   2. اگر Edge تغییرات را به‌طور خودکار مستقر نکرد، با کلیک کردن روی استقرار > آزمایش، تغییرات را به‌طور دستی در محیط test مستقر کنید.

   با انتخاب منو کرکره‌ای استقرار در بالای ویرایشگر Flow می‌توانید بررسی کنید که پراکسی شما با موفقیت مستقر شده است یا نه. دکمه سبز نشان می‌دهد که کارگزار وکالتی باموفقیت در آن محیط مستقر شده است:

   

8. تغییراتتان را با ارسال درخواست به پراکسی‌تان آزمایش کنید، درست مثل کاری که در مرحله ۲: پراکسی جدیدتان را آزمایش کنید انجام دادید. برای مثال:

   curl https://org_name-test.apigee.net/getstarted

   این بار، نقطه پایانی mocktarget در بدنه پاسخ XML برمی‌گرداند:

   <?xml version="1.0" encoding="UTF-8"?>
   <root>
     <city>San Jose</city>
     <firstName>John</firstName>
     <lastName>Doe</lastName>
     <state>CA</state>
   </root>

مرحله بعدی

مرحله ۱ مرحله ۲ مرحله ۳ مرحله ۴: افزودن خط‌مشی