Коротке правило
Поширюйте лише публічну сім'ю URL тієї сутності, яку ви хочете, щоб відкрила інша людина. Не поширюйте керівні URL, URL редагування, внутрішні URL власника чи URL із секретним кодом. Публічні URL призначені для передачі проєктів, електронної пошти, QR-міток, знімків екрана, друкованих матеріалів та індексації пошуком.
Публічну URL-адресу слід копіювати лише тоді, коли сторінка або елемент у своєму поточному стані доступні публічно. Приватну нотатку, нотатку, уже захищену доступом через пов'язаний трекер, приватну сторінку команди, трекер із режимом «Видимий після доступу», групу трекерів із режимом «Видимий після доступу» або внутрішній екран керування ніколи не слід копіювати як публічну адресу.
Сімейства публічних URL-адрес
Використовуйте коротку URL-адресу спільного доступу, коли копіюєте загальнодоступне посилання в електронну пошту, публікації, QR-мітки чи друковані матеріали. Локалізований цільовий стовпець показує оболонку сторінки, яку люди можуть побачити після того, як браузер застосує мову користувача або безпосередньо відкриє сімейство локалізованих маршрутів.
URL-адреси сторінок профілю та видимість
Поділіться загальнодоступним профілем з
/Profile/{userName}.
Ім’я користувача є стабільним ключем маршруту для цієї сім’ї сторінок, який зберігає скопійовані посилання компактними та їх легко розпізнати, коли хтось намагається відкрити загальнодоступну сторінку людини.
Після того, як відвідувач відкриє його, сайт може відобразити ту саму загальнодоступну сторінку профілю всередині локалізованої оболонки маршруту, наприклад
/{lang}/Profile/{userName}.
Профілі мають три стани видимості на рівні маршруту. Приватний профіль означає, що лише власник облікового запису може відкрити сторінку профілю. «Моїм командам дозволено переглядати» означає, що власник і користувачі, які ввійшли в обліковий запис і мають спільну команду з цим користувачем, можуть відкрити її. Загальнодоступний профіль означає, що будь-хто може безпосередньо відкрити URL-адресу сторінки профілю.
Цей параметр керує самим маршрутом профілю. Це не означає, що ім’я користувача зникає з усіх інших місць, де цій особі вже дозволено з’являтися, як-от право власності на нотатки, списки команд або мітки власників, які можна відстежувати.
URL-адреси та видимість сторінок команди
Поділіться короткою URL-адресою команди як
/team/{teamSlug}.
Після того, як відвідувач відкриє її, сайт може відобразити ту саму загальнодоступну сторінку команди всередині локалізованої оболонки маршруту, наприклад
/{lang}/team/{teamSlug}.
Сторінки команд є загальнодоступними або доступними лише для членів команди. Загальнодоступну сторінку команди може відкрити будь-хто, і вона може відображатися на публічних поверхнях для виявлення. Непублічна сторінка команди все ще є дійсною робочою сторінкою команди, але лише зареєстровані поточні учасники команди можуть відкрити цей маршрут.
Політика приєднання пов’язана, але окрема. Команда може бути загальнодоступною та все ще потребувати схвалення адміністратора для запитів, а посилання для запрошень залишаються іншим шляхом доступу, ніж видимість самої сторінки.
URL-адреси сторінки нотатки та видимість
Надати спільний доступ до сторінок загальнодоступних нотаток
/Note/{noteId}.
Потім браузер може перейти до локалізованої оболонки загальнодоступної сторінки за адресою
/{lang}/Note/{noteId}
відкриваючи той самий запис нотатки.
Нотатки можуть бути особистими або командними, а в межах цих сфер — публічними, приватними або захищеними доступом через пов'язаний трекер. Публічну особисту нотатку може відкрити будь-хто. Приватна особиста нотатка залишається доступною лише власнику. Командна нотатка може бути публічною для всіх або залишатися всередині команди. Нотатка, що використовує VisibleOnceAssociatedTrackableAccessed, поводиться як публічна, доки до неї не буде прикріплено один або кілька трекерів. Після цього сторінка нотатки відкривається лише тим, хто вже розблокував один із пов'язаних трекерів.
Публічні сторінки нотаток відокремлені від вихідної сторінки профілю чи команди. Це означає, що нотатка все ще може мати власний публічний маршрут, навіть якщо сторінка профілю чи команди, з якої вона походить, має вужчу видимість. Нотатки, які переходять у режим доступу через пов’язані трекери, також перестають індексуватися публічно, щойно до них прикріплюється один або більше трекерів.
Моделі читання трекованого об’єкта також можуть показувати поточні видимі нотатки на цій координаті, щоб маршрут лишався точним, навіть коли сусідні нотатки пізніше змінюються.
Поточний доступ до нотатки все ще визначається її власною видимістю та обов’язковим обсягом доступу, а читання маршруту можуть показувати будь-які нотатки, які зараз видимі на тій самій координаті, не перетворюючи зупинку на постійного власника нотатки.
URL-адреси сторінок трекера та видимість
Трекери використовують один маршрут входу для публічних кодів, коротких секретних кодів і довгих приватних токенів сканування. Поширюйте
/trackable/{code},
і якщо код публічний, сайт може перевести його на відрендерену публічну сторінку за адресою
/{lang}/trackable/{publicCode}.
Трекери можуть бути або завжди видимими для всіх, або видимими лише після доступу незалежно від того, чи належать вони особисто користувачу, чи команді. Трекерами, які завжди видно всім, можна ділитися через короткий URL /trackable/{code}, і їх може відкрити будь-хто. Трекери, видимі лише після доступу, не виходять на публічний маршрут, але секретний код або QR-потік усе одно можуть прив'язати елемент до облікового запису з входом, щоб пізніше знову відкривати його на інших пристроях із входом.
Секретні короткі коди та корисні дані сканування лише QR не є загальнодоступними URL-адресами. Це свідоцтва про володіння. Після того, як обліковий запис, у який ви ввійшли, успішно використовує один, цей обліковий запис може продовжувати відкривати відстежуваний пристрій на пристроях, на яких пізніше було здійснено вхід, без повторного введення секрету. Відстежуваний, що належить команді, може бути завжди видимим для всіх, а відстежуваний, що належить особисто, може бути видимим після доступу. Обсяг права власності та видимість сторінки є окремими правилами.
URL-адреси сторінок груп трекерів та видимість
Поділитися сторінками групи "Завжди видимі для всіх".
/trackable-group/{publicCode}.
Сторінка загальнодоступної групи може відтворюватися всередині локалізованої оболонки за адресою
/{lang}/trackable-group/{publicCode}.
Сторінки відстежуваної групи також мають правило видимості на рівні сторінки. Сторінку групи «Завжди видима для всіх» може відкрити кожен. Видима після доступу сторінка групи залишається обмеженою для авторизованих глядачів, які вже мають доступ до групи, включно з доступом власника або команди та обліковими записами, які раніше були пов’язані через один із учасників групи, який можна відстежувати.
Видимість групи не забезпечує автоматично однакову видимість для кожного учасника, який можна відстежити. Кожен учасник, який можна відстежити, все ще зберігає власну видимість на рівні елемента та може мати або не мати власної публічної сторінки. Розблокування видимого після доступу для учасників також може дозволити пов’язану групу повторно відкрити для цього облікового запису, у який ви ввійшли, тож, отримавши доступ до відстежуваного, ви також зможете повторно відкрити його групу.
URL-адреси категорій
Категорії не мають окремої загальнодоступної сім’ї URL-адрес. Персональні категорії доступні на сторінці профілю за адресою
/Profile/{userName},
і категорії команд доступні на сторінці команди за адресою
/team/{teamSlug}.
Це робить спільний доступ до категорії простим для пояснення: поділіться сторінкою, яка володіє ієрархією.
Натомість керування категоріями відбувається на сторінках робочої області:
/{lang}/notes
для особистого робочого простору та
/{lang}/team/{teamSlug}/workspace/Categories
для командного робочого простору. Ці URL-адреси робочої області є маршрутами керування, які ви ввійшли в обліковий запис, а не URL-адресами загального доступу.
Чому трекери зберігають назву маршруту в однині
Трекери зберігають іменник /trackable в однині як у URL для поширення, так і на локалізованій публічній сторінці. Короткий URL для поширення залишається /trackable/{code}, тому що цей один маршрут може безпечно приймати три різні види кодів: публічний код, короткий секретний код і довгий приватний токен сканування.
Якщо код є загальнодоступним, веб-переглядач перенаправляється на загальнодоступну сторінку користувача на певній мові за адресою
/{lang}/trackable/{publicCode}.
Якщо код секретний або лише для сканування, браузер натомість переходить у потік володіння. Саме тому коротка URL-адреса для поширення — це те, що людям слід копіювати, друкувати й надсилати електронною поштою, тоді як локалізовану відтворену сторінку можуть побачити відвідувачі після перенаправлення.
Чому для груп трекерів використовується один тип публічних URL-адрес
Групи, які можна відстежувати, не потребують розпізнавача секретного коду, тому спільна URL-адреса та локалізована відтворена сторінка залишаються в одній сім’ї:
/trackable-group/{publicCode}
локалізується в
/{lang}/trackable-group/{publicCode}.
Це означає, що груповий CTA завжди може навчити одному чистому формату спільного доступу, поки браузер все ще перебуває на мовній оболонці переглядача.
Те, чим ніколи не можна ділитися
- Внутрішні URL-адреси робочої області, такі як /en-US/account або /en-US/team/{teamSlug}/workspace, є маршрутами керування, а не загальнодоступними URL-адресами.
- URL-адреси із секретним кодом і лише QR-адреси є обліковими даними володіння, а не загальнодоступними посиланнями.
- Маршрути керування, такі як сторінки редагування, налаштування команди, сторінки активації та внутрішні інформаційні панелі, ніколи не є загальнодоступними URL-адресами.
Чому це важливо
Люди запам’ятовують шаблони URL-адрес. Якщо сайт навчає одну просту сім’ю, а потім тихо направляє людей внутрішніми одноразовими шляхами, вони скопіюють неправильні речі в публікації в соціальних мережах, електронні листи, мітки та розмови підтримки. Чиста загальнодоступна система URL-адрес зменшує цю плутанину та полегшує пояснення продукту.
Це ще важливіше, коли посилання переходить між колегами, клієнтами, викладачами, одногрупниками або друкованими польовими матеріалами. Чіткі сімейства публічних URL спрощують передавання спільних нотаток і трекерів без відкриття не тієї сторінки.
Коли головне — це маршрут, така сама чіткість допомагає підтримці відокремити збережений знімок зупинки від самої сторінки нотатки й від будь-яких поточних видимих нотаток, які сьогодні випадково показуються на тій самій координаті.
Чіткі загальнодоступні сімейства URL-адрес також спрощують прийняття рішення про те, що безпечно для спільного використання, а що має залишатися приватним. Коли публічна адреса очевидна, люди менш імовірно помилково скопіюють сторінку керування, приватну сторінку або URL-адресу доступу на основі облікових даних.