NAMES LEGAL para programadores#

Construa sobre o NAMES LEGAL a partir da sua própria aplicação: leia e escreva o conteúdo de um site, venda o NAMES LEGAL aos seus utilizadores sem que estes saiam do seu produto, e mantenha o site deles preenchido com os dados que já possui.

Três formas de integração#

O que pretende…	Utilize	Quem configura
Ler ou escrever o conteúdo de um site (equipa, serviços, notícias…) a partir de código	API do site	O proprietário do site cria uma chave de API na sua consola
Permitir que os seus utilizadores comprem um site NAMES LEGAL dentro da sua aplicação	Compra integrada	O NAMES LEGAL cria um canal de venda para si; basta colar uma linha
Preencher e atualizar um site a partir dos seus próprios dados (folha de cálculo ou API)	Conector de dados	O proprietário do site liga a sua API na consola; você expõe um feed

As três formas podem ser combinadas. Uma integração de plataforma típica tem este aspeto:

O seu utilizador clica em Criar o meu site na sua aplicação: a moldura de compra integrada abre-se, ele escolhe um plano e paga.
Quando o site está pronto, o seu servidor recebe um webhook site.ready assinado com o endereço do site e a sua própria referência para esse utilizador.
O proprietário do site liga a sua aplicação como fonte de dados na consola. Se a sua API seguir o formato de feed NAMES LEGAL, cada coleção é associada automaticamente: os professores tornam-se a equipa, os cursos tornam-se serviços, as notícias tornam-se publicações do blog.
A partir daí, o site atualiza-se sozinho — de hora a hora, diariamente, ou instantaneamente ao chamar o endereço de webhook.

Factos essenciais#

Cada site é independente. Cada site NAMES LEGAL tem o seu próprio endereço (https://<site>.names.legal ou o seu próprio domínio), os seus próprios dados e as suas próprias chaves de API. Não existe uma API global que alcance todos os sites.
A faturação fica a cargo do NAMES LEGAL. Um utilizador que compra através de uma aplicação torna-se cliente do NAMES LEGAL, faturado pelo NAMES LEGAL. Os pagamentos ou dados de cartão nunca são tratados por essa aplicação.
Concebido para ser white-label. Os visitantes de um site nunca veem a marca NAMES LEGAL proveniente destas integrações.
Seis idiomas. A plataforma, a moldura de compra e o modelo de conteúdo suportam inglês, francês, alemão, italiano, espanhol e português.

Convenções utilizadas nesta documentação#

<site> é o endereço de um site NAMES LEGAL, por exemplo https://ecolehorizon.names.legal.
As datas seguem a norma ISO 8601: 2026-09-24 ou 2026-09-24T14:02:11+02:00.
Todos os pedidos e respostas utilizam JSON em UTF-8, salvo indicação em contrário.