Cabi.Chat API — Endpoints del grafo

Los endpoints del grafo son la mitad de la Cabi.Chat API que trabaja con tarjetas. Una misma forma para todos los tipos de tarjeta: /graph lee lo que el lector puede ver, /my gestiona las tuyas. Para qué sirve cada tipo de tarjeta: Cabi.Chat Graph — Tipos de datos

<type> es el tipo de tarjeta en plural: projects, articles, posts, boards, workspaces, rubrics, telegram_groups, campaigns, oracles, agendas, links, secrets, api_endpoints. La URL base, {ident} y la paginación siguen las convenciones de la API.

Leer el grafo (las tarjetas públicas no necesitan token; con un token ves también lo que se ha compartido contigo)

• GET /graph/<type>: tarjetas públicas de un tipo, limit (20 por defecto) y offset. Para projects, articles, posts, boards, workspaces, rubrics, telegram_groups.
• GET /graph/<type>/{ident}: la página de una tarjeta. Texto en cada idioma guardado (i18n), medios, rúbricas, ubicación y las tarjetas que contiene, menciona y etiqueta. Workspaces y rúbricas paginan sus hijos con contained_limit y contained_offset.
• GET /graph/resolve/{ident}: qué es un handle o un nonce, como {card_type, nonce, handle}. Un handle renombrado sigue resolviendo a su tarjeta.
• GET /graph/relations?card=<nonce>&dir=out|in|both: relaciones tipadas de una tarjeta.
• GET /graph/public/landing: el escaparate de la landing, fila por fila. link
• GET /graph/oracles/{nonce}, GET /graph/agendas/{ident}: la página de un oráculo o de una agenda.
• GET /graph/telegram_groups/{nonce}/overview: número de miembros de un grupo, estadísticas y reglas de moderación.
• POST /graph/projects/{ident}/contacts/{nonce}/reveal: revela un contacto que el propietario oculta tras un clic. Los contactos Ecosystem requieren un lector con sesión iniciada.

Buscar

• POST /search/graph con {query, card_type?, scope?, workspace?, filters?, limit?, page?}: una sola lista ordenada por relevancia entre tipos de tarjeta, por palabras clave y por significado. scope: "owned" busca solo en tus tarjetas, workspace (un nonce) busca dentro de un workspace. /search/graph/keyword y /search/graph/vector ejecutan un solo modo. Cabi.Chat Search — Palabras clave, significado e intenciones
• GET /search/geo/countries?q= y GET /search/geo/cities?q=&country=: países y ciudades para los filtros geográficos de la búsqueda. Lugares para la location de una tarjeta: rúbricas que se encuentran con filters: {"kind": "place"}. Cabi.Chat Search — Filtro y preferencia geográficos, Cabi.Chat Search — rúbricas y descubrimiento

Tus tarjetas (requiere token)

• GET /my/<type>: tus tarjetas. scope=granted lista las tarjetas compartidas contigo, scope=all ambas; archived=true muestra el archivo.
• POST /my/<type>: crear. Requiere un Idempotency-Key; responde con la nueva tarjeta y su nonce. Cabi.Chat API — Crear tarjetas: idempotencia y límites
• GET, PATCH, DELETE /my/<type>/{nonce}: leer, editar, eliminar. PATCH envía solo los campos que cambian. Los grupos de Telegram solo se listan y se añaden; el valor de un secreto nunca se devuelve.
• POST /my/archive con {nonce, archived}: saca una tarjeta de tus listas sin eliminarla.
• GET /graph/my/granted: todo lo que se ha compartido contigo.

Organizar

• POST, DELETE, PATCH /my/workspaces/{nonce}/{card}: mete una tarjeta en un workspace, sácala o cambia su orden (seqnum).
• POST, DELETE, PATCH /my/rubrics/{nonce}/{card}: lo mismo para una rúbrica.
• POST /my/relations con {source, target, rel}: una relación tipada entre dos tarjetas, nombrada por una rúbrica. DELETE /my/relations/{nonce} la elimina.
• GET /graph/my/edges: los enlaces entre tus propias tarjetas (contención, menciones, anclas, rúbricas, etiquetas).
• GET, POST /my/projects/{ident}/contacts; PATCH, DELETE /my/contacts/{nonce}: los contactos de un proyecto.
• PUT /my/boards/{nonce}/scene: el lienzo de un tablero.
• POST /my/media/upload: una imagen, devuelta lista para adjuntarla a una tarjeta.

Compartir

• POST /my/links con {read, write, execute, targets: [{card_type, nonce}], link_publicity?, max_openers?, expires_at?, grant_ttl?, claimable_by?}: un enlace de acceso a una o varias tarjetas. Grafo de Cabi.Chat — Políticas de tarjetas
• GET /linked/{token} y GET /linked/{token}/<card_type>/{nonce}: abre un enlace; un lector con sesión iniciada lo reclama. Qué da un enlace, y a quién: Cabi.Chat Graph — Compartir con enlaces de acceso

Ejecutar

• Campañas: POST /my/campaigns/{nonce}/start y /stop; coincidencias capturadas: POST /my/campaigns/{nonce}/matches/{post}/draft y /outreach; resultados: GET /my/campaigns/{nonce}/performance y /sends. link
• Oráculos: POST /my/oracles/{nonce}/start y /stop, POST /my/oracles/{nonce}/regenerate-token, GET /my/oracles/{nonce}/performance. Cabi.Chat Graph — Oráculos™
• Agendas: GET /graph/agendas/{ident}/prompt (requiere write sobre la agenda), las instrucciones exactamente como las recibe el oráculo. Cabi.Chat API — Apps

Todo lo que rodea a las tarjetas, desde tu perfil hasta la bandeja de entrada: Cabi.Chat API — Endpoints de cuenta