Форма деталей проблеми
{
"title": "Forbidden",
"code": "trackable_access_code_required",
"detail": "Sign in, keep this trackable active on this browser, or provide this trackable's secret code or QR access code before posting comments or location reports.",
"status": 403
}Не кожен збій, пов'язаний з можливістю відстеження, є корисним навантаженням для деталей проблеми. Промахи пошуку коду все ще повертають звичайне успішне корисне навантаження з { "found": false }, щоб абонент міг зробити інтерфейс пошуку простим.
Коди помилок
| Код | Статус | Типовий маршрут | Значення | Інструкції для клієнта |
|---|---|---|---|---|
trackable_not_found |
404 | Активація, групове керування, видалення маршрутів | Ціль, яку можна відстежити, не існує або не може бути вирішена в цій операції. | Оновіть список, повторно запустіть пошук або підтвердьте GUID. |
trackable_comment_not_found |
404 | Оновити або видалити коментар | Цільовий відстежуваний коментар більше не існує на цьому відстежуваному. | Оновити коментарі та видалити застарілий запис інтерфейсу користувача. |
trackable_journey_stop_not_found |
404 | Видалення зупинки маршруту | Запитана зупинка подорожі більше не існує на цьому відстежуваному. | Оновіть подорож і скиньте застарілу дію. |
trackable_already_activated |
400 | POST /api/trackables/{trackableId}/activate |
Абонент намагався активувати відстежуваний, який уже має область власника. | Завантажити поточну сторінку деталей замість повторної активації. |
trackable_activation_required |
400 | Анонімні або авторизовані записи коментарів і зупинок маршруту | Елемент все ще неактивовано, тому він ще не може приймати нові коментарі чи маршрутизацію. | Спершу попросіть відповідного власника, який увійшов у систему, активувати функцію відстеження. |
trackable_access_code_required |
403 | Анонімні коментарі та записи про зупинку в дорозі | Абонент не ввійшов у систему, а також не має активного сеансу веб-переглядача чи інших дійсних секретних облікових даних для цього відстежуваного доступу. | Попросіть точний короткий секретний код або QR-токен, залиште відстежуваний активним у цьому браузері або запропонуйте ввійти. |
trackable_access_code_invalid |
403 | Анонімні коментарі та записи про зупинку в дорозі | Надані облікові дані доступу не вирішують для цього конкретного відстежуваного. | Скажіть абоненту, що код належить до іншого елемента або введено неправильно. |
trackable_group_detach_forbidden |
403 | DELETE /api/trackables/{trackableId}/group |
Абонент не є оригінальним активатором або придатним адміністратором групи для контексту поточної групи. | Використовуйте користувача, який наразі керує цим згрупованим елементом. |
trackable_group_attach_forbidden |
403 | POST /api/trackables/{trackableId}/group |
Абоненту, що телефонує, не дозволено пов'язувати цей відокремлений відстежуваний з іншою групою. | Повернутися до початкового активатора або дозволеного контексту керування. |
trackable_comment_edit_forbidden |
403 | PUT /api/trackables/{trackableId}/comments/{commentId} |
Лише автор авторизованого коментаря може його редагувати. | Приховати елементи керування редагуванням для всіх інших. |
trackable_comment_delete_forbidden |
403 | Видалити коментар | Абонент не є ані автором коментаря, який увійшов у систему, ані адміністратором /team власника з повноваженнями модерування. | Зберігати видалення як дію лише для керування. |
trackable_journey_stop_delete_forbidden |
403 | Видалення зупинки маршруту | Абонент не є ані автентифікованим автором цієї зупинки, ані власником /team адміністратором. | Показувати зупинку видалення лише тоді, коли поточний користувач дійсно може це модерувати. |
trackable_journey_stop_convert_forbidden |
403 | Потік конверсії на веб-сайті | Лише особа, яка ввійшла в обліковий запис і створила автентифікований прямий звіт, може перетворити його на нотатку. | Не показувати дії перетворення для анонімних зупинок або зупинок, створених третьою стороною. |
trackable_journey_stop_convert_rejected |
400 | Потік конверсії на веб-сайті | Зупинка існує, але запитане перетворення ноти недійсне для цієї комбінації зупинки чи ноти. | Попросіть користувача замість цього створити нову нотатку з вибраного місця. |
trackable_request_rejected |
400 або 403 | Резервне | Правило, яке можна відстежувати, відхилило запит, але більш конкретного машинного коду не було призначено. | Використовуйте зрозумілий для людини детальний текст і контекст маршруту разом. |
Місце, історія та доступ залишаються розділеними: зупинка маршруту зберігає зафіксовану координату, нотатка має власний редагований запис, а видимість нотатки разом з обов’язковим обсягом доступу визначають, хто може відкрити її вміст.
Читання маршруту показують збережену зупинку разом із currentNotesAtCoordinate. Ця колекція є поточною моделлю читання видимих нотаток для тієї самої координати, а не доказом того, що зупинка назавжди володіє однією нотаткою.
Промахи пошуку не є деталями проблеми
{
"found": false,
"error": "Code not found."
}API пошуку навмисно використовує корисне навантаження успіху, оскільки очікуються помилки введення, і інтерфейс користувача зазвичай хоче залишатися в режимі пошуку замість того, щоб перемикатися в обробку помилок.
Коли код явно належить іншій активній системі або має використовувати сценарій власного коду, відповідь пошуку також може містити довідкове посилання на початковий сайт або сторінку створення одного трекера.