משאב אינטרנט הוא ייצוג של אתר או דומיין מאומתים.
היא מכילה את המזהה הקנוני של אתר או דומיין, את כתובת ה-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 |
סוג האתר.
הערכים הקבילים הם:
|
שיטות
משתמשים בשיטה insert כדי לאמת את הבעלות של המשתמשים המאומתים על אתר או על דומיין. משתמשים בשיטות get, update, ו-delete כדי לאחזר או לשנות משאבים שכבר אומתו בשביל המשתמש המאומת.
אפשר לראות את כל המשאבים המאומתים של המשתמש המאומת ברשימה, ואפשר לקבל אסימון להצבה באתר של המשתמש המאומת באמצעות getToken.
- מחיקה
- מתבצע אימות של הבעלות של המשתמש על אתר או על דומיין.
- הורדה
- אחזור הנתונים העדכניים ביותר של אתר או דומיין.
- getToken
- מקבלים אסימון אימות שהמשתמש המאומת יכול להציב באתר או בדומיין.
- הוספה
- מאמת את הבעלות על אתר או על דומיין.
- list
- מקבלים את רשימת האתרים והדומיינים המאומתים של המשתמשים המאומתים.
- עדכון
- שינוי רשימת הבעלים של אתר או דומיין.