v0.3.7-beta

por

Intelligence Unleashed

iniciar sessão registar

produto community magazine atualizações

iniciar sessão registar

brainful biblioteca da API

Navegação rápida

visão geral como começar autenticação criar bloco anexar ao bloco obter bloco inspirar-se

visão geral

O brainful API permite integração perfeita entre as suas aplicações e brainful's poderoso sistema de gestão de conteúdo. Quer esteja a construir ferramentas de automação ou a integrar com as suas aplicações favoritas, a nossa API RESTFUL fornece uma forma simples e segura de interagir com o seu conteúdo.

Características principais

Autenticação segura

Autenticação baseada em token com encriptação HTTPS

Design RESTful

Métodos HTTP padrão com respostas JSON

Suporte de localização

Capacidades de geolocalização integradas

Com limite de taxa

Optimizada para desempenho fiável

Casos de uso

Automação pessoal

Guardar automaticamente notas das suas aplicações favoritas
Criar gatilhos de conteúdo baseados na localização
Conectar com IFTTT/Zapier fluxos de trabalho

Soluções de integração

Construir integrações e extensões personalizadas
Criar fluxos de trabalho de conteúdo automatizados
Desenvolver sistemas de gestão de conteúdo

Requisitos

Limites de taxa

60 pedidos por minuto por utilizador

Como começar

Obter o seu token da API

Visite a sua brainful página de opções para gerar o seu token da API.

Escolha o seu método de integração

Selecione do nosso código de exemplo em cURL, JavaScript, ou Python para começar rapidamente.

Faça o seu primeiro pedido

Experimente os exemplos interativos abaixo para testar a sua integração.

autenticação

All API requests require your API token in the Authorization header. Get your token from the brainful página de opções. The api supports both token and bearer token formats.

O seu token da API:

Authorization: Token YOUR_API_TOKEN

Authorization: Bearer YOUR_API_TOKEN

criar bloco

POSThttps://brainful.one/blocks/add

Parâmetros do pedido

Todos os parâmetros são enviados no corpo do pedido como JSON.

Parâmetro	Tipo	Obrigatório	Descrição
string	string	Sim	Conteúdo a ser adicionado (1-5000 carateres)
parent_luid	string	Não	luid do bloco pai (opcional)
latitude	float	Não	latitude (-90° para 90°)
longitude	float	Não	longitude (-180° para 180°)
agent	string	Não	Agent identifier (max 50 chars)
team_space	string	Não	Team space slug to add the block to (only for organization members)

Conteúdo da string:Bloco pai luid: latitude (graus, -90° para 90°): longitude (graus, -180° para 180°): agente (até 255 carateres):Slug do espaço de equipa:

Generated Request

Resposta de exemplo

{
                    "luid": "abc123",
                    "slug": "My New Block",
                    "type": "thought",
                    "pinned": false,
                    "entities": [],
                    "created_timestamp": "2024-01-01T00:00:00Z",
                    "last_edited": "2024-01-01T00:00:00Z",
                    "experience": 5,
                    "remaining_daily_quota": 97
                  }

Campos da resposta

luid

Tipo: string

Identificador único para o conteúdo criado

slug

Tipo: string

URL-friendly version of the content

words

Tipo: inteiro

Number of words in the content

remaining_daily_quota

Tipo: inteiro

Remaining content creation quota for today

Códigos de resposta

201Criado (sucesso)

400Pedido inválido (string inválida)

401Não autorizado (token inválido)

403Forbidden (plan not sufficient)

422Invalid location coordinates

anexar ao bloco

POSThttps://brainful.one/blocks/append

Parâmetros do pedido

Todos os parâmetros são enviados no corpo do pedido como JSON.

Parâmetro	Tipo	Obrigatório	Descrição
identifier	string	Sim	Identificador do bloco ao qual anexar (luid ou slug)
string	string	Sim	Conteúdo a ser anexado (1-5000 carateres)

Identificador do bloco (LUID ou slug): Conteúdo da string:

Generated Request

Resposta de exemplo

{
  "details": "Text appended to block successfully.",
  "luid": "abc123",
  "slug": "my-example-block"
}

Campos da resposta

luid

Tipo: string

Identificador único para o conteúdo criado

slug

Tipo: string

URL-friendly version of the content

words

Tipo: inteiro

Number of words in the content

remaining_daily_quota

Tipo: inteiro

Remaining content creation quota for today

Códigos de resposta

201Criado (sucesso)

400Pedido inválido (string inválida)

401Não autorizado (token inválido)

403Forbidden (plan not sufficient)

obter bloco

GEThttps://brainful.one/blocks/get/{luid}

Parâmetros do pedido

URL Parameters

Parâmetro	Tipo	Obrigatório	Descrição
luid	string	Sim	Identificador único do bloco a recuperar

Corpo do pedido

Parâmetro	Tipo	Obrigatório	Descrição
latitude	float	Não	latitude (-90° para 90°)
longitude	float	Não	longitude (-180° para 180°)
agent	string	Não	Identificador do agente (máximo 50 carateres)

bloco LUID (6 carateres): latitude (graus, -90° para 90°): longitude (graus, -180° para 180°): agente (até 255 carateres):

Generated Request

Resposta de exemplo

{
  "creator": "johnnyappleseed",
  "luid": "abc123",
  "slug": "My New Block",
  "type": "thought",
  "html": "My New Block",
  "blocks": [],
  "entities": [],
  "flagged": false,
  "pinned": false,
  "archived": false,
  "trashed": false,
  "public": false,
  "created_timestamp": "2025-01-28 18:01",
  "last_edited": "2025-01-28 18:01",
  "words": 3,
  "bytes": 45,
  "hits": 0
}

Campos da resposta

creator

Tipo: string

Username of the content creator

luid

Tipo: string

Identificador único para o bloco

type

Tipo: string

Tipo de conteúdo (ex., "thought")

html

Tipo: string

HTML conteúdo do bloco

created_timestamp

Tipo: string

Creation date and time

hits

Tipo: inteiro

Number of views

Códigos de resposta

200Sucesso (bloco encontrado)

401Não autorizado (token inválido)

403Forbidden (plan not sufficient)

404Não encontrado (bloco não encontrado)

Sinta-se inspirado?

dê uma olhada em algumas das nossas integrações oficiais construídas com brainful User API aqui!