Projeto, plataforma e chave de API

Tudo o que o seu app guarda (usuários, tabelas, arquivos, functions) fica num projeto. O SDK precisa do ID dele; o navegador precisa que o domínio do app esteja cadastrado; o servidor precisa de uma chave de API.

Criar o projeto

1. No console, abra a organização e vá em Projetos → Criar projeto.
2. Dê um nome. O ID do projeto aparece na Visão geral: é o valor de setProject() nos SDKs.

Cadastrar a plataforma web

O navegador só fala com a API a partir de um domínio cadastrado no projeto. Pedido vindo de outro domínio é recusado (erro general_unknown_origin).

1. Em Plataformas → Adicionar plataforma Web, informe o hostname do app: só o nome, sem http:// nem caminho. Exemplos: app.exemplo.com ou *.exemplo.com.
2. Para desenvolver na sua máquina, cadastre também localhost.

Criar a chave de API

A chave de API é só para o servidor: deixa o seu backend agir sem sessão de usuário. Ela não segue as permissões de linhas e arquivos: vale o que os escopos dela permitem. Trate-a como senha.

1. Em Chaves de API → Criar chave de API, dê um nome e escolha a validade (sem validade, 30 dias, 90 dias ou 1 ano).
2. Marque só os escopos que o backend usa. Para a primeira chamada do @owbase/node, basta users.read.
3. Copie o segredo e guarde-o como variável de ambiente do servidor (nos exemplos, OWBASE_API_KEY).

Perigo

A chave nunca vai para o app web, para um app móvel nem para o repositório. No navegador, use o @owbase/web, que trabalha com a sessão do usuário.

Próximo passo: instalar o SDK e fazer a primeira chamada.