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

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

اکنون که نقطه پایانی هدف خود را تغییر داده‌اید، آماده‌اید که خط‌مشی‌ای به پراکسی خود اضافه کنید.

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

در این آموزش گام‌به‌گام، خط‌مشی XMLtoJSON را به پراکسی خود اضافه خواهید کرد. این خط‌مشی پایه‌بار پیام XML را به JSON تبدیل می‌کند. این کار همچنین سرایند Content-Type پاسخ را تغییر می‌دهد.

برای افزودن خط‌مشی XML به JSON به پراکسی خود:

1. واسط کاربر Edge را در مرورگر باز کنید و به سیستم وارد شوید.
2. در پنجره اصلی روی پراکسی‌های API کلیک کنید و پراکسی را انتخاب کنید. برای این مثال، پراکسی‌ای را که در مرحله ۱: ایجاد پراکسی API ایجاد کرده‌اید انتخاب کنید.

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

   

   ‫Edge «ویرایشگر پراکسی میانای برنامه‌سازی کاربردی» را نمایش می‌دهد.

4. در قاب Navigator، روی Proxy Endpoints (نقطه‌های پایانی پراکسی) > default (پیش‌فرض) > PreFlow (جریان پیش‌از اجرا) کلیک کنید:

   

   ‫Edge ویرایشگر «جریان» را نمایش می‌دهد:

   

   علاوه‌براین، Edge پیکربندی پیش‌فرض «نقطه پایانی پراکسی» را در قاب کد نمایش می‌دهد:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ProxyEndpoint name="default">
     <Description/>
     <FaultRules/>
     <PreFlow name="PreFlow">
       <Request/>
       <Response/>
     </PreFlow>
     <PostFlow name="PostFlow">
       <Request/>
       <Response/>
     </PostFlow>
     <Flows/>
     <HTTPProxyConnection>
       <BasePath>/getstarted</BasePath>
       <Properties/>
       <VirtualHost>default</VirtualHost>
       <VirtualHost>secure</VirtualHost>
     </HTTPProxyConnection>
     <RouteRule name="default">
       <TargetEndpoint>default</TargetEndpoint>
     </RouteRule>
   </ProxyEndpoint>

5. برای افزودن خط‌مشی به پراکسی، روی دکمه + مرحله در پاسخ «جریان پیش‌از اجرا» (نیمه پایین ویرایشگر «جریان») کلیک کنید:

   

   ‫Edge فهرست دسته‌بندی‌شده‌ای از خط‌مشی‌ها را در چارگوش گفتگوی افزودن نمایش می‌دهد که می‌توانید به جاری‌سازی خود اضافه کنید:

   

6. به‌پایین پیمایش کنید و خط‌مشی XML به JSON را در دسته «واسطه‌گری» انتخاب کنید.

7. نام‌های پیش‌فرض را بگذارید و روی افزودن کلیک کنید.

   ‫Edge خط‌مشی جدید را به «جریان پیش‌از اجرا» پاسخ پیوست می‌کند:

   

   توجه داشته باشید که وقتی روی افزودن کلیک می‌کنید، Edge کارهای زیر را انجام می‌دهد:

   • خط‌مشی جدید را در بخش خط‌مشی‌ها در قاب پیمایشگر اضافه می‌کند.
   • خط‌مشی XML به JSON را در قاب جریان اضافه می‌کند.
   • پیکربندی XML خط‌مشی را در قاب کد نمایش می‌دهد.
8. روی ذخیره کلیک کنید تا ویرایش کنونی را با تغییراتتان ذخیره کنید.

اکنون آن را امتحان کنید! در پنجره پایانه، فرمان curl زیر را اجرا کنید:

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

مکان:

• ‫org_name نام سازمانی است که Apigee هنگام ایجاد حساب Apigee به شما اختصاص داد.
• ‫-test محیط است. پراکسی جدیدتان را در محیط «آزمایشی» در مرحله ۱: ایجاد پراکسی API مستقر کردید.
• ‫/getstarted «مسیر پایه پراکسی» است.

یا می‌توانید همان نشانی وب را در مرورگر باز کنید.

باید پاسخ زیر را دریافت کنید:

{
  "root": {
    "city": "San Jose",
    "firstName": "John",
    "lastName": "Doe",
    "state": "CA"
  }
}

اگر بدنه پاسخ به این شکل نیست، موارد زیر را بررسی کنید:

1. نقطه پایان هدف شما «https://mocktarget.apigee.net/xml» است، همان‌طور که در مرحله ۳: تغییر نقطه پایان هدف:
   • اگر «سلام، مهمان!» را به‌عنوان پاسخ دریافت کردید، باید «/xml» را به انتهای نقطه پایانی هدف اضافه کنید.
   • اگر خطای ۴۰۴ دریافت کردید، بررسی کنید که به «apigee.net» دسترسی دارید نه به «apigee.com».
2. جدیدترین نسخه بازبینی شده پراکسی شما مستقر شده است. کارگزار پراکسی API خود را همان‌گونه که در استقرار و لغو استقرار کارگزار پراکسی API توضیح داده شده است دوباره مستقر کنید.

برای دیدن سرایندهای درخواست و پاسخ HTTP، با گزینه -vs، سطح جزئیات را در curl فعال کنید (v پاسخ را پرجزئیات می‌کند، اما s برخی‌از جزئیات کمتر جالب را سرکوب می‌کند). برای مثال:

curl -vs https://ahamilton-eval-test.apigee.net/getstarted | python -m json.tool

باید پاسخی شبیه به پاسخ زیر دریافت کنید. توجه داشته باشید که سرایند Content-Type در پاسخ «application/json» است. خط‌مشی XML به JSON سرصفحه را قبل‌از ارسال پاسخ تغییر می‌دهد.

*   Trying 10.20.30.40...
* TCP_NODELAY set
* Connected to ahamilton-eval-test.apigee.net (10.20.30.40) port 443 (#0)
...
> GET /getstarted HTTP/1.1
> Host: ahamilton-eval-test.apigee.net
> User-Agent: curl/7.58.0
> Accept: */*
>
< HTTP/1.1 200 OK
< Date: Fri, 25 May 2018 16:20:00 GMT
< Content-Type: application/json;charset=UTF-8
< Content-Length: 77
< Connection: keep-alive
< X-Powered-By: Apigee
< Access-Control-Allow-Origin: *
...
{ [77 bytes data]
{
  "root": {
    "city": "San Jose",
    "firstName": "John",
    "lastName": "Doe",
    "state": "CA"
  }
}

مرحله بعدی

کاوش محتوای مرتبط‌تر