API para Desarrolladores
Los mismos datos que alimentan el Navigator y la Matrix, expuestos en URLs JSON estables y directamente accesibles — sin clave, sin límite de solicitudes, sin necesidad de scraping.
¿Usa un asistente de IA? Use OpenHaven con su asistente de IA.
Para quién es esto
Para cualquiera que quiera consumir los datos de OpenHaven de forma programática — la matriz de entidad/dominio/afordancia, los mecanismos de Arquitectura Monetaria o los Modelos de organización y gobernanza — construyendo una herramienta sobre ellos, alimentando un agente o servidor MCP, o escribiendo un script puntual. Esta es una API JSON estática, de solo lectura y sin autenticación: sin filtros ni parámetros de consulta dinámicos, sin acceso de escritura, sin límite de solicitudes más allá del comportamiento normal del alojamiento estático.
Si prefiere preguntar a un asistente de IA en lugar de descargar archivos, OpenHaven también tiene su propio servidor MCP de solo lectura. Use OpenHaven con su asistente de IA.
Licencia y atribución
El código y las herramientas de OpenHaven están bajo la Alignment License v0.5.1, que es de código abierto dentro de un propósito y no código abierto en el sentido de la OSI. Los datos de esta API y el contenido escrito están bajo CC BY-SA 4.0: atribuya a OpenHaven y comparta lo que cree con ellos bajo la misma licencia. El documento de descubrimiento en /api/index.json lleva los mismos datos en su entrada license.
Para atribuir los datos, use esta línea: Data from OpenHaven (openhaven.net), licensed CC BY-SA 4.0.
Versiones
La API tiene su propio número de versión, distinto de la versión del sitio que se muestra en el pie de página. Solo cambia cuando cambia la forma de la API: una ruta, un campo o el significado de un campo.
Versión actual de la API: 1.0.0
Un nuevo número mayor significa que algo se eliminó o cambió de nombre, lo que puede romper una herramienta construida sobre la API. Un nuevo número menor significa que se añadió algo. Un número de parche es una corrección que no cambia ninguna forma. Los datos nuevos o corregidos nunca cambian el número. Antes de eliminar un endpoint, se marca como obsoleto en la lista de abajo durante al menos una versión menor.
Para estar seguro, compruebe que el número mayor es el que usó al construir su herramienta e ignore los campos y valores que no conozca.
Endpoints disponibles
Cada endpoint a continuación devuelve exactamente los mismos datos que alimentan openhaven.net, en una URL estable, agrupados según el tipo de cosa que sirven; cada grupo termina con el diccionario de datos que explica sus campos. Los detalles completos y legibles por máquina — incluida la lista actual de endpoints — están en el documento de descubrimiento enlazado abajo.
Herramientas Tecnológicas (entradas de la matriz)
Las herramientas tecnológicas de la matriz de convergencia, que incluyen protocolos y los demás tipos de entidad (plataformas, aplicaciones, infraestructura y más): la lista completa, una sola entrada, una vista filtrada por tipo de entidad y las definiciones de sus atributos. Las URL dicen "protocols" por razones históricas, pero abarcan todos los tipos de entidad.
/api/protocols.jsonAll entity entries in the matrix.
/api/protocols/{id}.jsonA single entity entry by id.
/api/protocols/type/{id}.jsonEntity entries filtered to a single entity type.
/api/tool-relationships.jsonThe reviewed relationships of each tech tool that has any (built on, requires, stewarded by, ...): one entry per tool, each relation with its type, direction, the other end and an optional brief note. Derived from the graph snapshot; reviewed relationships only.
/api/attribute-defs.jsonDefinitions and metadata for the attribute fields used on entity entries.
Datos de referencia
Los vocabularios con los que se organiza la matriz: dominios de casos de uso, afordancias y tipos de entidad.
/api/domains.jsonUse-case domains that entities are mapped to.
/api/affordances.jsonAffordances (capabilities) that entities provide.
/api/entity-types.jsonEntity-type definitions (the categories entities are classified under).
Arquitectura Monetaria
Los mecanismos monetarios: la lista completa, un solo mecanismo y un diccionario de datos con sus campos y valores.
/api/monetary-architecture.jsonAll Monetary Architecture mechanism entries.
/api/monetary-architecture/{id}.jsonA single Monetary Architecture mechanism entry by id.
/api/monetary-architecture-defs.jsonDefinitions of the Monetary Architecture mechanism fields and their values, in the order the schema declares them.
Modelos de organización y gobernanza
Los tipos de modelos de organización y gobernanza: la lista completa, un solo tipo y un diccionario de datos con sus campos y valores.
/api/organization-types.jsonAll Organization & Governance Model types, with every field.
/api/organization-types/{id}.jsonA single Organization & Governance Model type by id.
/api/organization-types-defs.jsonDefinitions of the Organization & Governance Model fields and their values, in the order the schema declares them, with the data file's title, summary, last-updated date and prose-dimension labels.
Contenido del sitio (el texto de cada página)
El texto de cada página pública, publicado como archivos estáticos: un índice de todas las páginas y un archivo por página e idioma para las páginas de texto. Las páginas que son vistas de un registro estructurado (una herramienta, un dominio) aparecen con un puntero a su archivo de datos. Las vistas interactivas no tienen más texto que el que muestran; las imágenes y los diagramas no se interpretan; los formularios se describen, no se operan.
/api/site/index.jsonThe index of every public page and language: a stable page id (not the URL), title, description, kind (prose, data-derived, interactive, form), the heading outline, word count, whether the page is in the public sitemap (listed), the data file that holds its substance (dataTool), a content hash and the build time.
/api/site/pages/{locale}/{id}.jsonThe text of one page as ordered sections (heading, level, text) with the page ids it links to. locale is en, es or pt-BR; in the file name the slashes of the page id are written as two underscores (research/peerfunding is research__peerfunding.json). The index lists the exact file for each page.
El grafo (relaciones)
Cómo se conectan las herramientas tecnológicas, los dominios de casos de uso, las afordancias, las capas de la pila, las organizaciones y las suites: una instantánea revisada del grafo de OpenHaven, con la fuente, la confianza y el estado de revisión de cada relación. El archivo principal es lo primero que carga el Explorador de Grafo; los demás tipos de relación son archivos pequeños e independientes, que se piden bajo demanda.
/api/graph.jsonThe complete graph snapshot: every node and every relationship, with provenance (source, asserter, date, review status, confidence). Exported from the graph database and reviewed like any other data change.
/api/graph-core.jsonThe first-view subset: every node plus the core relationship types (suite membership, layer positions, affordance and use case domain links, entity types). Each node has relCounts: how many relationships of each type it has in the full graph.
/api/graph/manifest.jsonThe index of the graph files: each relationship type with its count, size and path, the core types, and the date of the snapshot.
/api/graph/index.jsonThe machine-readable description of the graph API: files, node kinds, relationship types, the query parameters (kinds, rel, q, node and hops, direction, review, limit and the connected-to filters), limits and rules. The Graph Explorer page uses the same parameters in its URL.
/api/graph/rel-{type}.jsonAll relationships of one non-core type, for example /api/graph/rel-standardized_at.json (type in lower case; the manifest lists them). Core types are in /api/graph-core.json.
/api/graph-defs.jsonDefinitions of the graph: what each node kind, field, vocabulary value and relationship type means. There is no rank, weight or score anywhere in the graph.
Parámetros de consulta del grafo
La página del Explorador de grafo y la API del grafo comparten un mismo conjunto de parámetros, así que la URL de una página significa lo mismo que una consulta a la API. No hay lenguaje de consulta: solo estos parámetros, y los desconocidos se rechazan. Las descripciones de los parámetros están en inglés.
| Parámetro | Significado | Valor por defecto |
|---|---|---|
kinds | Node kinds to include, comma separated. Concepts (vocabulary) are off by default. (tool, layer, domain, affordance, organization, suite, entityType, mechanism, governanceModel, concept) | tool,layer,domain,affordance,organization,suite,entityType,mechanism,governanceModel |
rel | Relationship types to include, comma separated, from the types listed here (for example BASED_ON). Omitted means every type that is loaded. | every loaded relationship type |
q | Text search over name, label and abbreviation. Matched literally, case-insensitively, never as an expression; at most 100 characters. | |
node | Start of a neighbourhood query: a node iri (for example ohe:nostr) or its site id (nostr). An unknown node returns an empty result with a message. | |
hops | How many relationship steps from node, 1 to 3 (larger values are capped). Needs node. | 1 |
direction | Which way a neighbourhood follows relationships: both ways, outgoing only, or incoming only. (any, out, in) | any |
entityType | Only tools connected to this entity type (id such as p2p-protocol, or the iri). | |
domain | Only tools connected to this use case domain (slug, or the iri). | |
affordance | Only tools connected to this affordance (id, or the iri). | |
layer | Only tools connected to this stack layer (id such as l4, or the iri). | |
org | Only tools connected to this organization (id, or the iri). | |
suite | Only tools connected to this suite (id, or the iri). | |
review | reviewed: a person approved the relationship, or it comes straight from the catalog. unreviewed: suggested by an agent and not yet reviewed. (any, reviewed, unreviewed) | any |
limit | Cap on nodes returned (maximum 1000). The result says when it was cut. | 200 |
Ejemplos (ábralos en el Explorador de grafo)
/graph/?node=ohe:nostr&hops=2Everything within two hops of a tool, in the Graph Explorer/graph/?kinds=tool,organizationOnly tools and organizations/graph/?entityType=p2p-protocolTools connected to an entity type
De dónde vienen los datos
Cada valor servido por esta API tiene su origen en los mismos datos verificados por humanos y transparentemente rastreados, descritos en nuestra página de proceso — nada aquí se genera ni se sirve de forma diferente a lo que ves en el propio sitio.
Más información sobre nuestro proceso →Especificación legible por máquina
La lista de endpoints anterior es para humanos. Para la descripción canónica y legible por máquina de esta API — endpoints, gobernanza de datos y notas de acceso en JSON — usa el documento de descubrimiento:
/api/index.json →