JSON Pointer — компактная последовательность точных токенов RFC 6901. JSONPath — язык запросов RFC 9535 с селекторами, способными вернуть несколько узлов.
Pointer задаёт идентичность
Используйте указатель, когда формат должен детерминированно назвать один адрес: путь JSON Patch, ссылку фрагмента схемы или место ошибки. Каждый токен проходит к одному потомку.
JSONPath нужен для выборки
Используйте JSONPath для полей, потомков, срезов или фильтров, которые могут дать список. Не вставляйте JSONPath в поле JSON Pointer: корень, разделители и экранирование различаются.
Проверьте декодированные токены
Сверьте каждый токен с исходным именем поля. Один раз декодируйте ~1 в слеш и ~0 в тильду, затем отличайте имена полей от канонических индексов массива. Не путайте пустой указатель корня с / и сверяйте важные пути с контрактом источника.