Що таке трекер?

Ідентифікатори: посилання на формат і приклади

Трекери використовують кілька ідентифікаторів, які спочатку здаються схожими, але виконують різні завдання. Короткий публічний код залишається глобально унікальним, короткий секретний код також залишається глобально унікальним, і система не допускає перетину цих двох просторів, щоб короткий публічний код ніколи не був одночасно чиїмось коротким секретним кодом.

Коли хтось вручну вводить згенерований короткий секретний код або токен згенерованого публічного коду, пошук поблажливо ставиться до найтиповіших помилок. Для згенерованих кодів пошук сприймає O як 0, I або L як 1, S як 5, а U як V. Для системних коротких секретних кодів ця логіка заміни застосовується до згенерованої частини, а не до буквального префікса на кшталт LN, GT або GC. Публічні коди використовують той самий налаштований префікс і дефіс, тому їх візуально легко відрізнити від коротких секретних кодів з першого погляду.

Найважливіше практичне правило полягає в тому, що загальнодоступний маршрут є безпечним для спільного використання, тоді як короткий секретний код і приватний маршрут сканування – ні. Секретні коди та URL-адреси приватного сканування відображаються лише один раз під час створення. Після цього одного відкриття звичайні сторінки та звичайне читання API більше не показують їх. Єдиним особливим винятком є ​​особистий експорт, орієнтований на від’їзд, куди можуть бути включені суто особисті секрети користувача, щоб власник, який від’їжджає, міг їх відновити.

Оскільки короткий загальнодоступний код є глобально унікальним, пошук на домашній сторінці може безпечно прийняти загальнодоступний токен, як-от LN-7K4V9T, і спрямувати на правильну загальнодоступну сторінку без здогадок між кількома відстежуваними засобами.

Зовнішня URL-адреса входу для публічного коду, короткого секретного коду або довгого приватного токена сканування завжди починається з <code>/trackable/{code}</code>. Відвідувачі з публічним кодом потім переходять на локалізовану публічну сторінку за адресою <code>/{lang}/trackable/{publicCode}</code>. Веб-адреси трекера, доступні лише власнику, не повинні існувати.

Активація та право власності

Щойно створений трекер може одразу бути активованим або лишатися неактивованим. Активація завжди відбувається на рівні окремого елемента. Користувач, який активує, обирає остаточні назву й опис для елементів, яким під час активації потрібно явно підтвердити ці дані.

Моделі читання трекерів також містять позначку останньої активності, щоб панелі, сторінки деталей і списки спостереження могли з першого погляду показувати нещодавній рух або взаємодію.

• Неактивований відстежуваний не може реєструвати нові дії в подорожі та не може отримувати коментарі.
• Якщо активовано для користувача, цей користувач стає сферою власності.
• Якщо активовано для команди, команда стає сферою власності.
• Творець і власник не завжди одна і та ж особа.

Групи та резервні метадані

Відстежувані елементи можна створювати по одному або групами до 100. Група може надавати резервні метадані елемента, показувати хід активації в пакеті та надавати вам одне місце для переходу між керованими та загальнодоступними сторінками елементів.

• Деякі елементи, створені групою, можуть безпечно успадковувати параметри групи за замовчуванням, якщо їхні власні метадані порожні.
• Інші предмети, створені групою, вимагають від можливого активатора вибору власної назви та опису замість того, щоб назавжди успадковувати формулювання творця.
• Повні правила резервного копіювання, редагування та від’єднання доступні на спеціальному Що таке група трекерів? посібник.

Об’єкти відстеження та примітки

Історія руху трекованого об’єкта формується через зупинки маршруту. Нотатка може прикріпити один або кілька трекованих об’єктів у цьому місці, а прямий звіт про місце може додати зупинку без створення нотатки. Маршрут зберігає знімок місця, тоді як нотатки залишаються окремими редагованими записами.

Місце, історія та доступ залишаються розділеними: зупинка маршруту зберігає зафіксовану координату, нотатка має власний редагований запис, а видимість нотатки разом з обов’язковим обсягом доступу визначають, хто може відкрити її вміст.

Саме тут видимість нотатки через пов'язаний трекер набуває сенсу. Нотатка може починатися в цьому режимі видимості й спочатку все одно поводитися як публічна нотатка. Потім перший пов'язаний трекер переводить нотатку в режим виявлення, захищений трекером, для всіх, окрім власника, уповноважених учасників команди та відвідувачів, які вже розблокували один із пов'язаних трекерів.

Прикріплення до нотатки навмисно зроблено обережним. Сайт запитує по одному коду трекера за раз, це поле очікує наявний короткий секретний код, а публічний код призначено для публічної сторінки трекера. Якщо предмет сторонньої системи ще не зареєстровано, спочатку створіть його на сторінці трекерів. Зарезервовані префікси сайту, як-от LN, GT і GC, залишаються недоступними для власних кодів.

• Пов'язаних трекерів ще немає: нотатка поводиться як публічна нотатка.
• Після першого зв'язку: нотатка зникає з анонімного публічного виявлення та звичайного доступу до публічної сторінки нотатки.
• Розблокований відвідувач: той, хто вже розблокував один пов'язаний трекер, може відкрити сторінку нотатки та використовувати пов'язані публічні API-маршрути сторінки нотатки.
• Власник або уповноважений учасник команди: зберігає звичайний доступ до нотатки та права керування.

• Збереження нотатки з прикріпленими трекованими об’єктами може створити знімки зупинок для кожного прикріпленого елемента.
• Користувачі, які ввійшли в обліковий запис, також можуть зареєструвати просту пряму зупинку на карті, не створюючи попередньо примітки, а потім перетворити цю зупинку на примітку пізніше, якщо вони хочуть отримати більш детальну інформацію.
• Зупинка, підкріплена нотаткою, фіксує координату в момент прикріплення трекованого об’єкта, тому подальше переміщення нотатки не переписує старий маршрут.
• Моделі читання трекованого об’єкта також можуть показувати поточні видимі нотатки на цій координаті, щоб маршрут лишався точним, навіть коли сусідні нотатки пізніше змінюються.
• Сторінка трекера може попередньо завантажити весь маршрут, бо очікується, що ці подорожі залишатимуться людського масштабу.
• Шпильки на карті та пов’язаний стоп-список повертають на сторінку нотаток, якщо глядач має дозвіл.
• Особисті нотатки все ще можуть вносити точки подорожі лише з координатами для глядачів, яким заборонено читати саму нотатку.

Видимий після доступу проти завжди видимий для всіх

Найпростіше пояснювати трекери через режими «Видимий після доступу» та «Завжди видимий для всіх». Трекер у режимі «Завжди видимий для всіх» має публічний маршрут для поширення. Трекер у режимі «Видимий після доступу» теж має звичайну сторінку, але й далі відкривати її можуть лише власники з входом, командні області доступу або люди, уже пов'язані через потік секретного доступу.

Короткий секретний код і QR-потік — це спосіб уперше довести володіння. Після того як обліковий запис після входу успішно використовує режим «Видимий після доступу», LocationNotes може й надалі пов’язувати цей трекер з обліковим записом, щоб майбутнім пристроям після входу не доводилося знову вводити секрет лише для повторного відкриття, стеження чи коментування елемента. Цей збережений доступ стає одним зі способів, завдяки яким трекер пізніше може з'явитися на сторінці «Мої подорожі» після входу поруч із власними та командними маршрутами.

Відстеження та сеанси браузера

Введення секретного коду або сканування дійсного приватного QR може створити активний відстежуваний сеанс у поточному браузері. Цей стан, що запам’ятовується, дозволяє людині продовжувати вивчати потік, увійти пізніше та прикріпити відстежуваний файл зі сторінок нотаток, не вводячи секрет кожен раз.

Цей активний сеанс браузера — це не те саме, що постійне володіння, і не те саме, що автентифікація. Це лише запам’ятований контекст володіння на поточному пристрої, доки людина не вимкне його або доки сеанс не завершиться. Коли глядач входить в обліковий запис, той самий доступ у режимі «Видимий після доступу» також можна зберегти в обліковому записі для пристроїв, на яких пізніше буде виконано вхід.

Коментарі та загальнодоступні сторінки

Коментарі на сторінці трекера належать самому трекеру й відокремлені від коментарів на сторінці нотатки. Публічні сторінки трекерів є канонічними переглядами подорожей. Приватні сторінки профілю, приватні сторінки команди й сторінки трекерів з режимом «Видимий після доступу» — це обмеження на рівні маршруту, а не глобальна таємність для кожної мітки, пов’язаної з елементом.

Публічний список трекерів і публічний список груп трекерів на сайті залишаються багатомовними, щоб дані про маршрут, інвентар і логістику не зникали, коли мови авторів відрізняються.

Змініть мову сайту, якщо хочете бачити локалізований інтерфейс навколо тих самих публічних даних трекера.

• Відстежувані імена, імена користувачів і назви команд все ще можуть з’являтися в дозволених списках і контекстах подорожей.
• Мітки власника можуть відображатися як посилання, якщо маршрут доступний, або як звичайний текст із текстом приватної сторінки, коли він недоступний.
• Автентифіковані користувачі можуть нормально коментувати. Анонімні коментарі, які можна відстежувати, і прямі звіти на карті також дозволені, якщо цей браузер уже має активний доступ до цього відстежуваного елемента або абонент повторно надсилає свій секретний код або доступ до приватного сканування у запиті на запис.
• Анонімні коментарі, які можна відстежувати, і прямі підпорядковані не можуть бути пізніше відредаговані особою, яка їх опублікувала, і лише власник, який можна відстежувати, або поточні адміністратори команди можуть видалити їх.

Експорт, відновлення та видалення

Об’єкти відстеження переживають видалення інакше, ніж звичайні особисті записи, оскільки вони можуть зберігати спільну історію багатьох людей з часом. Система намагається видалити видалену особисту активність видаленого користувача, не пошкоджуючи решту історії для інших користувачів або команд.

• Експорти користувачів і команд тепер містять зупинки маршруту трекованих об’єктів, історію зупинок на основі нотаток і коментарі до трекованих об’єктів.
• Експорт користувачів може включати суто особисті секретні облікові дані.
• Командний експорт виключає ці секрети, якщо власник користувача недоступний і команді потрібна копія для відновлення.
• Видалення користувача не видаляє автоматично відстежуваний, який все ще має значення для інших людей.
• Видалення команди може призвести до повернення права власності на команду та ручного керування відповідно до задокументованих резервних правил.

Зовнішні посилання, надані користувачем

Правила зовнішніх посилань, перевірка, перевірка вмісту для дорослих, поведінка вихідної сторінки, параметри відстежуваної групи за замовчуванням, експорт і видалення задокументовані в Що таке зовнішнє посилання? .

Приклади запитів і відповідей, зокрема externalLinkUrl, externalLinkDescription, externalLinkAppendPublicTrackableCode, defaultExternalLinkUrl, defaultExternalLinkDescription, defaultExternalLinkAppendPublicTrackableCode, useGroupDefaultExternalLink та кінцеву точку перевірки, дивіться в Документація API.

Пов'язані посібники

• Що таке користувач?
• Що таке команда?
• Що таке нотатка?
• Що таке зовнішнє посилання?
• Що таке відстеження SWAG?
• Що таке група трекерів?
• Що таке URL?
• Документація API
• Автентифікований потік API трекерів
• Анонімний потік API, що відстежується
• Довідник помилок API трекерів
• Конфіденційність і Видалення даних