API para Desenvolvedores
Os mesmos dados que alimentam o Navigator e a Matrix, expostos em URLs JSON estáveis e diretamente acessíveis — sem chave, sem limite de requisições, sem necessidade de scraping.
Usa um assistente de IA? Use o OpenHaven com seu assistente de IA.
Para quem é isso
Para qualquer pessoa que queira consumir os dados do OpenHaven de forma programática — a matriz de entidade/domínio/affordance, os mecanismos de Arquitetura Monetária ou os Modelos de organização e governança — construindo uma ferramenta sobre eles, alimentando um agente ou servidor MCP, ou escrevendo um script pontual. Esta é uma API JSON estática, somente leitura e sem autenticação: sem filtros ou parâmetros de consulta dinâmicos, sem acesso de escrita, sem limite de requisições além do comportamento normal de hospedagem estática.
Se prefere perguntar a um assistente de IA em vez de baixar arquivos, o OpenHaven também tem o seu próprio servidor MCP somente leitura. Use o OpenHaven com seu assistente de IA.
Licença e atribuição
O código e as ferramentas do OpenHaven estão sob a Alignment License v0.5.1, que é de código aberto dentro de um propósito e não código aberto no sentido da OSI. Os dados desta API e o conteúdo escrito estão sob CC BY-SA 4.0: credite o OpenHaven e compartilhe o que criar com eles sob a mesma licença. O documento de descoberta em /api/index.json traz os mesmos dados na sua entrada license.
Para creditar os dados, use esta linha: Data from OpenHaven (openhaven.net), licensed CC BY-SA 4.0.
Versões
A API tem o seu próprio número de versão, separado da versão do site mostrada no rodapé. Ele só muda quando a forma da API muda: um caminho, um campo ou o significado de um campo.
Versão atual da API: 1.0.0
Um novo número maior significa que algo foi removido ou renomeado, o que pode quebrar uma ferramenta construída sobre a API. Um novo número menor significa que algo foi adicionado. Um número de correção é um ajuste que não muda nenhuma forma. Dados novos ou corrigidos nunca mudam o número. Antes de remover um endpoint, ele é marcado como obsoleto na lista abaixo por pelo menos uma versão menor.
Para ficar seguro, confira se o número maior é o que você usou ao construir sua ferramenta e ignore campos e valores que você não conhece.
Endpoints disponíveis
Cada endpoint abaixo retorna exatamente os mesmos dados que alimentam o openhaven.net, em uma URL estável, agrupados pelo tipo de coisa que servem; cada grupo termina com o dicionário de dados que explica seus campos. Detalhes completos e legíveis por máquina — incluindo a lista atual de endpoints — estão no documento de descoberta vinculado abaixo.
Ferramentas Tecnológicas (entradas da matriz)
As ferramentas tecnológicas da matriz de convergência, que incluem protocolos e os demais tipos de entidade (plataformas, aplicações, infraestrutura e mais): a lista completa, uma única entrada, uma visão filtrada por tipo de entidade e as definições de seus atributos. As URLs dizem "protocols" por razões históricas, mas abrangem todos os tipos de entidade.
/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.
Dados de referência
Os vocabulários pelos quais a matriz é organizada: domínios de casos de uso, affordances e tipos de entidade.
/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).
Arquitetura Monetária
Os mecanismos monetários: a lista completa, um único mecanismo e um dicionário de dados com seus campos e 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 organização e governança
Os tipos de modelos de organização e governança: a lista completa, um único tipo e um dicionário de dados com seus campos e 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.
Conteúdo do site (o texto de cada página)
O texto de cada página pública, publicado como arquivos estáticos: um índice de todas as páginas e um arquivo por página e idioma para as páginas de texto. As páginas que são visões de um registro estruturado (uma ferramenta, um domínio) aparecem com um ponteiro para o arquivo de dados. As visões interativas não têm mais texto do que o que mostram; imagens e diagramas não são interpretados; os formulários são descritos, não operados.
/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.
O grafo (relacionamentos)
Como as ferramentas tecnológicas, os domínios de casos de uso, as affordances, as camadas da pilha, as organizações e as suítes se conectam: um instantâneo revisado do grafo do OpenHaven, com a fonte, a confiança e o status de revisão de cada relacionamento. O arquivo principal é o que o Explorador de Grafo carrega primeiro; os demais tipos de relacionamento são arquivos pequenos e separados, buscados sob 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 do grafo
A página do Explorador de grafo e a API do grafo compartilham um mesmo conjunto de parâmetros, então a URL de uma página significa o mesmo que uma consulta à API. Não há linguagem de consulta: apenas estes parâmetros, e os desconhecidos são rejeitados. As descrições dos parâmetros estão em inglês.
| Parâmetro | Significado | Padrão |
|---|---|---|
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 |
Exemplos (abra-os no 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 onde vêm os dados
Todo valor servido por esta API tem origem nos mesmos dados verificados por humanos e transparentemente rastreados, descritos em nossa página de processo — nada aqui é gerado ou servido de forma diferente do que você vê no próprio site.
Saiba mais sobre nosso processo →Especificação legível por máquina
A lista de endpoints acima é para humanos. Para a descrição canônica e legível por máquina desta API — endpoints, governança de dados e notas de acesso em JSON — use o documento de descoberta:
/api/index.json →