שלב 3: משנים את נקודת הקצה לטירגוט

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X.
מידע

אחרי שבדקתם את השרת החדש, אתם כמעט מוכנים להוסיף לו מדיניות. אבל לפני כן, כדאי לשנות את נקודת הקצה של ה-proxy לנקודה שמחזירה נתונים.

זוכרים שבשלב 1: יצירת שרת proxy ל-API הגדרתם את נקודת הקצה של היעד (בשדה Existing API) ל-https://mocktarget.apigee.net? נקודת הקצה הזו לא מחזירה נתונים, אז עכשיו תשנה את נקודת הקצה לנקודה שמחזירה קובץ XML.

כדי לשנות את נקודת הקצה של היעד של ה-proxy:

  1. נכנסים אל ממשק המשתמש של Edge.
  2. בוחרים באפשרות פיתוח > שרתי proxy ל-API.
  3. בוחרים את ה-proxy מסוג getstarted מהרשימה כדי להציג את הפרטים של ה-proxy ל-API. אם ה-proxy לא מופיע ברשימה, צריך לוודא שבחרתם את הארגון הנכון, כמו שמתואר במאמר מעבר בין ארגונים.
  4. לוחצים על הכרטיסייה פיתוח:

    תועברו אל הכלי לעריכת שרתי proxy של API. בעורך ה-Proxy אפשר לראות את המבנה של ה-proxy ל-API ולהגדיר את הזרימה שלו. (אל דאגה. במדריכים אחרים נסביר על המושג flows).

  5. בחלונית Navigator (ניווט), בוחרים באפשרות Target Endpoints > default (נקודות קצה של יעד > ברירת מחדל):

    ההגדרות של נקודת הקצה מוצגות בחלונית Code ב-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. משנים את כתובת ה-URL ל-"https://mocktarget.apigee.net/xml". (מוסיפים את המחרוזת '/xml' לכתובת ה-URL הקיימת).

    כתובת ה-URL החדשה מחזירה בלוק קטן של XML בגוף התגובה.

    הגדרת נקודת הקצה אמורה להיראות כך:

    ...
    <HTTPTargetConnection>
      <Properties/>
      <URL>https://mocktarget.apigee.net/xml</URL>
    </HTTPTargetConnection>
    ...
  7. כדי לשמור את השינויים בהגדרת השרת הפרוקסי, לוחצים על הלחצן שמירה.

    השינויים נשמרים ב-Edge ונפרסים באופן אוטומטי.

    אם יש שגיאה, Edge ישמור את השינויים אבל לא יפרוס את ה-proxy. במקרה הזה:

    1. צריך לתקן את ההגדרה של שרת ה-proxy. יכול להיות ש-Edge יציג חלון קופץ עם הנחיות לגבי התחביר.
    2. אם Edge לא מבצע פריסה אוטומטית, לוחצים על Deployment > test כדי לפרוס את השינויים בסביבת test באופן ידני.

    כדי לבדוק אם הפרוקסי נפרס בהצלחה, בוחרים באפשרות Deployment (פריסה) בתפריט הנפתח שמעל כלי העריכה של Flow. כפתור ירוק מציין ששרת ה-proxy נפרס בסביבה הזו בהצלחה:

  8. כדי לבדוק את השינויים, שולחים בקשה לשרת ה-proxy, כמו שמתואר בשלב 2: בדיקת שרת ה-proxy החדש. לדוגמה:

    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>

השלב הבא

שלב 1 שלב 2 שלב 3 שלב 4: הוספת מדיניות