# Qdrant: получить точку по ID

Источник: https://modelium.tech/zhurnal/qdrant-get-point-by-id/

Если ID точки уже известен, Qdrant позволяет запросить её напрямую, не обходя всю коллекцию через Scroll. Ниже — учебный пример для собственного локального сервера: записать две искусственные точки и получить одну по ID. Действия сверены с API v1.19.x, но редакция не запускала Qdrant; на сервере с ключом понадобится авторизация.

**Технический уровень.** Нужен уже установленный Qdrant v1.19.x на собственном компьютере и терминал Linux/macOS с `curl`. Это не рецепт установки AI-модели. Инструкция сверена по документации 19 октября 2026 года; редакция не запускала Qdrant. Команды направлены только на `127.0.0.1`; при включённом API-ключе нужен отдельный безопасный способ его передачи. Не открывайте незащищённый сервер в сеть. [s1](#src-s1) [s4](#src-s4)

## Зачем читать точку по ID?

Представьте, что у записи известен номер `2` и вы хотите проверить её поле `note` после загрузки. **Точка** в Qdrant — запись с ID, вектором и дополнительными полями (*payload*). Запрос `GET /collections/{имя}/points/{id}` читает одну точку с известным ID. Если её номер неизвестен, воспользуйтесь [обходом Scroll](/zhurnal/qdrant-scroll-vse-tochki/). Чтение по ID не является поиском похожих по смыслу документов и не проверяет права доступа. [s1](#src-s1)

## Как создать учебные точки и прочитать одну?

Сначала [подготовьте локальный Qdrant](/zhurnal/qdrant-lokalno/). Убедитесь, что имя `demo_get_20261019` **не занято** на вашем сервере: команды ниже создают коллекцию и записывают точки; не направляйте их в рабочую коллекцию. При другом имени замените его одинаково во всех трёх командах. Размерность вектора `2` здесь нужна только для искусственного примера, а не для реальной AI-модели. [s2](#src-s2) [s3](#src-s3)

Создайте коллекцию: `curl -fsS -X PUT 'http://127.0.0.1:6333/collections/demo_get_20261019' -H 'Content-Type: application/json' -d '{"vectors":{"size":2,"distance":"Cosine"}}'`. Ожидайте в ответе `status: ok` и `result: true`. Если ответ иной, остановитесь и проверьте имя, адрес и работу локального сервера, не переходя к записи. [s2](#src-s2)

Запишите две тестовые точки: `curl -fsS -X PUT 'http://127.0.0.1:6333/collections/demo_get_20261019/points?wait=true' -H 'Content-Type: application/json' -d '{"points":[{"id":1,"vector":[1,0],"payload":{"note":"alpha"}},{"id":2,"vector":[0,1],"payload":{"note":"beta"}}]}'`. Ожидайте `status: ok` и `result.status: completed`. Повторная отправка с теми же ID **перезапишет** прежние точки в этой коллекции. [s3](#src-s3)

Прочитайте только точку `2`: `curl -fsS 'http://127.0.0.1:6333/collections/demo_get_20261019/points/2'`. Проверьте в поле `result` значения `id: 2` и `payload.note: beta`. Это ожидаемый результат для заданных нами входных данных, **не** скриншот или вывод работающего у редакции Qdrant. [s1](#src-s1)

## Что делать, если запись не нашлась?

Сверьте имя коллекции и ID с теми, что использовали при записи; ID `1` и `2` относятся только к нашему примеру. Если сервер требует API-ключ, этот неавторизованный запрос не подойдёт: не размещайте ключ в статье, общих журналах команд или URL. Если вам нужен список ID, а не одна запись, откройте [гайд по Scroll](/zhurnal/qdrant-scroll-vse-tochki/). Успешный ответ localhost сам по себе не доказывает, что сервер закрыт от других устройств; доступ проверяется отдельно. [s1](#src-s1) [s4](#src-s4)

## Источники

1. [Qdrant API v1.19.x — Retrieve a point](https://api.qdrant.tech/v-1-19-x/api-reference/points/get-point.md) — получено 2026-10-19
2. [Qdrant API v1.19.x — Create a collection](https://api.qdrant.tech/v-1-19-x/api-reference/collections/create-collection.md) — получено 2026-10-19
3. [Qdrant API v1.19.x — Upsert points](https://api.qdrant.tech/v-1-19-x/api-reference/points/upsert-points.md) — получено 2026-10-19
4. [Qdrant — Quickstart и предупреждение о безопасности локального сервера](https://qdrant.tech/documentation/quickstart/) — получено 2026-10-19