מפתחים

GET/v3/get_encrypted_files

הצגת העלאות זמינות של מסמכי רישום

איתור הפניות להעלאות דרך ממשק התכנות שתוקפן טרם פג ונתוני המטא שלהן לפני צירוף מסמכי רישום.

בעמוד זה
  1. הצגת הפניות זמינות להעלאות
  2. קריאת נתוני מטא, ולא בתים של מסמכים
  3. צירוף לפני שתוקף ההפניה פג
  4. פרטיות

הצגת הפניות זמינות להעלאות

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

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/get_encrypted_files

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

קריאת נתוני מטא, ולא בתים של מסמכים

בדקו את תוצאת HTTP ואת השדה status.code בנתוני JSON. בתגובה מוצלחת, השדה response מכיל מערך; תוצאה ריקה היא מערך ריק, ולא שגיאה המציינת שהחשבון אינו קיים. בדוגמה נעשה שימוש בנתוני מטא ובמזהים בדויים.

{
  "status": {"code": 200, "msg": ""},
  "response": [{
    "id": "0123456789abcdef0123456789abcdef",
    "proof_type": "abcdef0123456789abcdef0123456789",
    "entity_type": "addresses",
    "description": "Example address proof",
    "file_name": "example-document.pdf",
    "date": "2026-10-01 12:00:00"
  }]
}
שדות נתוני המטא של ההעלאה
שדהמשמעות
idההפניה החיצונית להעלאה. העתיקו אותה במדויק לבקשת הצירוף המתאימה. אל תחשבו מזהה בעצמכם ואל תשתמשו במקומה במזהה של זהות, כתובת או תבנית.
proof_typeההפניה הממוסכת לסוג שנרשם, אם קיימת; אחרת, מחרוזת ריקה. בהעלאות של אסמכתאות זהו סוג האסמכתה; בהעלאות של מסמכים תומכים, ההפניה לתבנית שלהם נרשמת תחת אותו מפתח. בדקו את entity_type כדי להבחין ביניהם. זה אינו מזהה ההעלאה.
entity_typeקטגוריית הצירוף שנרשמה, כגון identities, addresses או supporting_documents. בחרו בתהליך הצירוף המתאים.
descriptionתיאור ההעלאה שנשמר.
file_nameשם הקובץ המקורי. זו אינה כתובת להורדה.
dateמועד היצירה שנרשם, בתבנית שהשרת מספק ללא היסט של אזור זמן.

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

צירוף לפני שתוקף ההפניה פג

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

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

פרטיות

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