ביצוע בקשות API באמצעות Analyzer ב-Acrobat

עודכן לאחרונה בתאריך 23 באוקטובר 2026

קבעו את נקודת הקצה האזורית של ה-API של הארגון, אמתו את הבקשות שלכם והשתמשו ב-Analyzer ב-Acrobat APIs.

לפני ביצוע קריאות ל-Analyzer APIs, פתרו את נקודת הגישה של ה-API עבור הארגון. Analyzer תומך כרגע באזורי NA1 ו-EU1.

לפני שתתחילו

השלימו את התהליך של Set up API access for Analyzer in Acrobat וקבלו אסימון גישה חוקי של OAuth Server-to-Server.

קבעו את נקודת הקצה האזורית של ה-API

Analyzer משתמש בנקודת הקצה baseUris כדי לזהות את נקודת הגישה האזורית של ה-API עבור ארגון.

נקודת הקצה baseUris זמינה דרך NA1 בלבד. קראו לנקודת הקצה NA1 גם אם הארגון מתארח ב-EU1.

שלחו בקשת GET מאומתת לנקודת הקצה baseUris של Analyzer:

קראו את ערך apiAccessPoint מהתגובה.

התגובה מזהה את נקודת הקצה האזורית של ה-API שהוקצתה לארגון.

{
"apiAccessPoint": "[regional Analyzer API endpoint]"
}

השתמשו ב-apiAccessPoint המוחזר כ-URL הבסיס עבור בקשות Analyzer API עוקבות.

פתרו תמיד את נקודת הגישה של ה-API של הארגון דרך baseUris במקום לקבע נקודת קצה אזורית.

אמתו בקשות API

העבירו את אסימון הגישה OAuth Server-to-Server בכותרת Authorization עבור כל בקשת API:

Authorization: Bearer <access_token>

בנו בקשות API עוקבות באמצעות apiAccessPoint שהוחזר על ידי baseUris.

השתמשו בהפניה של API

Analyzer מספק ממשקי Swagger אזוריים לחקירת נקודות קצה, פרמטרים, סכמות בקשה ותגובה ופעולות נתמכות.

השתמשו בממשק Swagger עבור האזור של הארגון:

  • NA1‏: https://analyzer-na1.adobe.io/swagger-ui/index.html
  • EU1‏: https://analyzer-eu1.adobe.io/swagger-ui/index.html

אשרו את הפעלת Swagger עם אסימון גישה חוקי של OAuth Server-to-Server לפני בדיקת נקודות קצה מאומתות.

פעולות API זמינות

השתמשו ב-Analyzer APIs כדי:

  • העלו מסמכים לעיבוד.
  • חפשו וסננו מסמכים.
  • קבלו סטטוס עיבוד מסמכים.
  • קבלו מאפייינים זמינים.
  • קבלו ערכי מאפיינים שהופקו.

עיינו בממשק Swagger אזורי לנתיבים של נקודות קצה, פרמטרים, לסכימות של בקשה, לסכימות של תשובה ולקודים של סטטוס.

השלב הבא

אם האינטגרציה שלכם צריכה לגשת לנתוני Analyzer עבור משתמשים בודדים, עיינו במקטע הגדרת גישה מטעם משתמש עבור Analyzer ב-Acrobat.