Pipeline de API: ver el contacto de un proyecto
Índice: Pipelines de API — índice
Objetivo: obtener un contacto de un proyecto (teléfono, email, Telegram…) que su propietario muestra solo bajo petición o solo a quienes han iniciado sesión.
Pasos
- Lee los contactos del proyecto.
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}]}
Un contacto sin value está oculto: publicity: "Ecosystem" = solo para quien ha iniciado sesión; requires_reveal: true = se muestra bajo petición. verified: true en un contacto Website = el propietario demostró que ese dominio es suyo.
- Muéstralo (sin cuerpo).
POST /v0/graph/projects/470000000000000001/contacts/470000000000000012/reveal
→ {"nonce": "470000000000000012", "kind": "Phone", "value": "+10000000000"}
Después de mostrarlo con la sesión iniciada, la página del proyecto te devuelve ese contacto con su value y revealed: true.
Detrás
- Cuando alguien con sesión iniciada muestra un contacto, queda registrado para el propietario del proyecto: quién mostró qué contacto (una vez por persona y contacto). El propietario siempre ve todos los valores.
Reglas
- 401
unauthorized: el contacto es para quienes han iniciado sesión y no se envió token. - 404: el proyecto no es visible para ti, o el contacto no está en ese proyecto.
- Tipos de contacto: Phone, Email, Website, Telegram, WhatsApp, Instagram, Facebook, TikTok, LinkedIn, Discord, X, YouTube, Other.
Superficie de la API
| Endpoint | Para qué | FE | IA / oráculo |
|---|---|---|---|
GET /v0/graph/projects/{ident} |
Página del proyecto con sus contactos | sí | sí |
POST /v0/graph/projects/{ident}/contacts/{nonce}/reveal |
Valor de un contacto oculto | sí (toca el contacto oculto) | sí, con token para los contactos Ecosystem |