WebResource

משאב אינטרנט הוא ייצוג של אתר או דומיין מאומתים.

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

רשימה של ה-methods במשאב הזה מופיעה בסוף הדף.

ייצוגי משאבים

{
  "id": string,
  "site": {
    "type": string,
    "identifier": string
  },
  "owners": [
    string
  ]
}
שם הנכס ערך תיאור הערות
id string המחרוזת שמשמשת לזיהוי האתר הזה. יש להשתמש בערך הזה בחלק id של כתובת ה-URL ב-REST בשביל פעולות get, עדכון ו-delete.
owners[] list כתובות האימייל של כל הבעלים הישירים והמאומתים של הנכס המדויק הזה. בעלים עקיפים — לדוגמה, בעלים מאומתים של הדומיין שמכיל — לא נכללים ברשימה זו.
site object מאגר שמציין את הכתובת וסוג האתר שאומת או יאומת.
site.identifier string מזהה האתר, בצורות שונות בהתאם לערך של הנכס type.
site.type string סוג האתר.

הערכים הקבילים הם:
  • "ANDROID_APP": מגדירים את identifier לכתובת URL של אפליקציה ל-Android. Example: "android-app://com.google.android.youtube/"
  • "INET_DOMAIN": מגדירים את identifier כשם דומיין. דוגמאות: 'www.example.com', 'example.com' או 'subdomain.example.com'
  • "SITE": מגדירים את identifier ככתובת URL מוגדרת במלואה עבור הרמה הבסיסית (root) של האתר, שמסתיימת בסימן /. Examples: "https://www.example.com/" או "https://www.example.com/subsite/ "

שיטות

משתמשים בשיטה insert כדי לאמת את הבעלות של המשתמשים המאומתים על אתר או על דומיין. משתמשים בשיטות get, update,  ו-delete כדי לאחזר או לשנות משאבים שכבר אומתו בשביל המשתמש המאומת.

אפשר לראות את כל המשאבים המאומתים של המשתמש המאומת ברשימה, ואפשר לקבל אסימון להצבה באתר של המשתמש המאומת באמצעות getToken.

מחיקה
מתבצע אימות של הבעלות של המשתמש על אתר או על דומיין.
הורדה
אחזור הנתונים העדכניים ביותר של אתר או דומיין.
getToken
מקבלים אסימון אימות שהמשתמש המאומת יכול להציב באתר או בדומיין.
הוספה
מאמת את הבעלות על אתר או על דומיין.
list
מקבלים את רשימת האתרים והדומיינים המאומתים של המשתמשים המאומתים.
עדכון
שינוי רשימת הבעלים של אתר או דומיין.