API-пайплайн: открыть контакт проекта
Индекс: API-пайплайны — индекс
Цель: получить контакт проекта (телефон, email, Telegram…), который владелец показывает только по запросу или только вошедшим пользователям.
Шаги
- Прочитайте контакты проекта.
GET /v0/graph/projects/{nonce | @handle}
→ {"nonce": "470000000000000001", …,
"contacts": [
{"nonce": "470000000000000011", "kind": "Telegram", "value": "@example", "is_primary": true,
"publicity": "Everyone", "requires_reveal": false, "revealed": false},
{"nonce": "470000000000000012", "kind": "Phone", "is_primary": false,
"publicity": "Ecosystem", "requires_reveal": true, "revealed": false}]}
Контакт без value скрыт: publicity: "Ecosystem" = только для вошедших; requires_reveal: true = показывается по запросу. verified: true у контакта Website = владелец подтвердил, что домен принадлежит ему.
- Откройте его (без тела запроса).
POST /v0/graph/projects/470000000000000001/contacts/470000000000000012/reveal
→ {"nonce": "470000000000000012", "kind": "Phone", "value": "+10000000000"}
После открытия контакта вошедшим пользователем страница проекта возвращает вам этот контакт с value и revealed: true.
Что происходит за кадром
- Открытие контакта вошедшим пользователем записывается для владельца проекта: кто открыл какой контакт (один раз на человека и контакт). Владелец всегда видит все значения.
Правила
- 401
unauthorized: контакт только для вошедших, а токен не отправлен. - 404: проект вам не виден, или контакт не относится к этому проекту.
- Типы контактов: Phone, Email, Website, Telegram, WhatsApp, Instagram, Facebook, TikTok, LinkedIn, Discord, X, YouTube, Other.
Поверхность API
| Эндпоинт | Назначение | FE | ИИ / оракул |
|---|---|---|---|
GET /v0/graph/projects/{ident} |
Страница проекта с контактами | да | да |
POST /v0/graph/projects/{ident}/contacts/{nonce}/reveal |
Значение скрытого контакта | да (нажмите на скрытый контакт) | да, с токеном для контактов Ecosystem |