v0.2.3-beta

por

Inteligencia Liberada

iniciar sesión registrar

producto social revista new

iniciar sesión registrar

brainful biblioteca API

Navegación rápida

descripción general primeros pasos autenticación crear bloque agregar al bloque obtener bloque inspírese

descripción general

El brainful API permite una integración perfecta entre sus aplicaciones y brainful's poderoso sistema de gestión de contenido. Ya sea que esté construyendo herramientas de automatización o integrándose con sus aplicaciones favoritas, nuestro API RESTFUL proporciona una forma simple y segura de interactuar con su contenido.

Características clave

Autenticación segura

Autenticación basada en tokens con cifrado HTTPS

Diseño RESTful

Métodos HTTP estándar con respuestas JSON

Soporte de ubicación

Capacidades de geolocalización integradas

Con límite de tasa

Optimizado para rendimiento confiable

Casos de uso

Automatización personal

Guardar automáticamente notas de sus aplicaciones favoritas
Crear disparadores de contenido basados en ubicación
Conectar con IFTTT/Zapier flujos de trabajo

Soluciones de integración

Construir integraciones y extensiones personalizadas
Crear flujos de trabajo de contenido automatizados
Desarrollar sistemas de gestión de contenido

Requisitos

Límites de tasa

60 solicitudes por minuto por usuario

Primeros pasos

Obtener su token de API

Visite su brainful página de opciones para generar su token de API.

Elija su método de integración

Seleccione de nuestro código de ejemplo en cURL, JavaScript, o Python para comenzar rápidamente.

Haga su primera solicitud

Pruebe los ejemplos interactivos a continuación para probar su integraciónpruebe los ejemplos interactivos a continuación para probar su integración.

autenticación

Todas las solicitudes de API requieren su token de API en el encabezado de Autorización. Obtenga su token desde la brainful página de opciones. La API admite formatos de token y bearer token.

Su token de API:

Authorization: Token YOUR_API_TOKEN

Authorization: Bearer YOUR_API_TOKEN

crear bloque

POSThttps://brainful.dev/blocks/add

Parámetros de solicitud

Todos los parámetros se envían en el cuerpo de la solicitud como JSON.

Parámetro	Tipo	Requerido	Descripción
cadena	cadena	Sí	Contenido a agregar (1-5000 caracteres)
parent_luid	cadena	No	luid del bloque padre (opcional)
latitude	decimal	No	latitud (-90° a 90°)
longitude	decimal	No	longitud (-180° a 180°)
agent	cadena	No	Agent identifier (max 50 chars)
team_space	cadena	No	Team space slug to add the block to (only for organization members)

Contenido de cadena:Bloque padre luid: latitud (grados, -90° a 90°): longitud (grados, -180° a 180°): agente (hasta 255 caracteres):Slug del espacio de equipo:

Generated Request

Respuesta de ejemplo

{
                    "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 de respuesta

luid

Tipo: cadena

Identificador único para el contenido creado

slug

Tipo: cadena

URL-friendly version of the content

words

Tipo: entero

Number of words in the content

remaining_daily_quota

Tipo: entero

Remaining content creation quota for today

Códigos de respuesta

201Creó (éxito)

400Solicitud incorrecta (cadena inválida)

401No autorizado (token inválido)

403Forbidden (plan not sufficient)

422Invalid location coordinates

agregar al bloque

POSThttps://brainful.dev/blocks/append

Parámetros de solicitud

Todos los parámetros se envían en el cuerpo de la solicitud como JSON.

Parámetro	Tipo	Requerido	Descripción
identifier	cadena	Sí	Identificador del bloque al que agregar (luid o slug)
cadena	cadena	Sí	Contenido a agregar (1-5000 caracteres)

Identificador de bloque (LUID o slug): Contenido de cadena:

Generated Request

Respuesta de ejemplo

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

Campos de respuesta

luid

Tipo: cadena

Identificador único para el contenido creado

slug

Tipo: cadena

URL-friendly version of the content

words

Tipo: entero

Number of words in the content

remaining_daily_quota

Tipo: entero

Remaining content creation quota for today

Códigos de respuesta

201Creó (éxito)

400Solicitud incorrecta (cadena inválida)

401No autorizado (token inválido)

403Forbidden (plan not sufficient)

obtener bloque

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

Parámetros de solicitud

URL Parameters

Parámetro	Tipo	Requerido	Descripción
luid	cadena	Sí	Identificador único del bloque a recuperar

Cuerpo de solicitud

Parámetro	Tipo	Requerido	Descripción
latitude	decimal	No	latitud (-90° a 90°)
longitude	decimal	No	longitud (-180° a 180°)
agent	cadena	No	Identificador del agente (máx. 50 caracteres)

bloque LUID (6 caracteres): latitud (grados, -90° a 90°): longitud (grados, -180° a 180°): agente (hasta 255 caracteres):

Generated Request

Respuesta de ejemplo

{
  "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 de respuesta

creator

Tipo: cadena

Username of the content creator

luid

Tipo: cadena

Identificador único para el bloque

type

Tipo: cadena

Tipo de contenido (ej., "thought")

html

Tipo: cadena

HTML contenido del bloque

created_timestamp

Tipo: cadena

Creation date and time

hits

Tipo: entero

Number of views

Códigos de respuesta

200Éxito (bloque encontrado)

401No autorizado (token inválido)

403Forbidden (plan not sufficient)

404No encontrado (bloque no encontrado)

Siéntase inspirado?

Eche un vistazo a algunas de nuestras integraciones oficiales construidas con brainful User APIEche un vistazo a algunas de nuestras integraciones oficiales construidas con brainful User API aquí!