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