API Keys - Jelou AI Docs

As API Keys permitem que você se autentique na API do Databases a partir de aplicações externas, scripts ou integrações. Cada chave pode ter permissões granulares e uma data de expiração configurável.

Tabela de API Keys mostrando chaves criadas com colunas Name, Permissions, Key, Created, Expires e botões Regenerate e Delete — Lista de API Keys com nome, permissões, chave mascarada e ações

Criando uma API Key

Acesse as configurações

Vá para Configurações > API Keys na barra lateral esquerda.

Clique em + Create API key

O botão está localizado no canto superior direito.

Configure a chave

Preencha os seguintes campos:

Name — Um nome descritivo para identificar a chave (ex.: “CI Bot”, “Backend Produção”)
Permissions — Selecione as permissões que a chave precisa
Expiration — Por quanto tempo a chave deve permanecer válida

Clique em Create

A chave é gerada e exibida apenas uma vez. Copie-a e guarde-a em um lugar seguro.

A chave completa é exibida apenas uma vez no momento da criação. Se você perdê-la, precisará regenerar a chave ou criar uma nova.

Permissões disponíveis

As permissões são divididas em duas categorias: Records (Registros)

Permissão	Descrição
Read records	Permite ler e pesquisar registros nas coleções
Create & update records	Permite criar novos registros e atualizar os existentes
Delete records	Permite excluir registros

Files (Arquivos)

Permissão	Descrição
Read files	Permite baixar anexos de arquivos
Upload files	Permite fazer upload de arquivos para os registros

Aplique o princípio do menor privilégio: conceda apenas as permissões que a aplicação realmente precisa. Por exemplo, um painel somente leitura requer apenas Read records.

Opções de expiração

Opção	Descrição
7 days	A chave expira em 7 dias
30 days	A chave expira em 30 dias (padrão)
60 days	A chave expira em 60 dias
90 days	A chave expira em 90 dias
180 days	A chave expira em 180 dias
No expiration	A chave nunca expira

Chaves sem expiração não são revogadas automaticamente. Use-as apenas quando estritamente necessário e combine com permissões mínimas.

Gerenciando API Keys

A tabela de API Keys mostra todas as chaves criadas com as seguintes informações:

Name — Nome da chave
Permissions — Permissões atribuídas
Key — Os últimos caracteres da chave (mascarada)
Created — Data de criação
Expires — Data de expiração

Ações disponíveis

Regenerate — Gera uma nova chave mantendo o mesmo nome, as mesmas permissões e a data de expiração original (o período não é reiniciado). A chave anterior para de funcionar imediatamente.
Delete — Exclui permanentemente a chave. Qualquer aplicação que a utilize perderá o acesso imediatamente.

Usando a API Key

Inclua a chave no cabeçalho X-Api-Key das suas requisições HTTP:

curl -s -X GET 'https://sua-instancia.jelou.cloud/api/collections/produtos/records' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'Accept: application/json'

const response = await fetch('https://sua-instancia.jelou.cloud/api/collections/produtos/records', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Accept': 'application/json'
  }
});

const data = await response.json();

import requests

response = requests.get(
    'https://sua-instancia.jelou.cloud/api/collections/produtos/records',
    headers={
        'X-Api-Key': 'YOUR_API_KEY',
        'Accept': 'application/json'
    }
)

data = response.json()

​Criando uma API Key

​Permissões disponíveis

​Opções de expiração

​Gerenciando API Keys

​Ações disponíveis

​Usando a API Key

Criando uma API Key

Permissões disponíveis

Opções de expiração

Gerenciando API Keys

Ações disponíveis

Usando a API Key