libreria API | brainful

panoramica

Il brainful API abilita l'integrazione senza soluzione di continuità tra le Sue applicazioni e brainful's potenza sistema di gestione dei contenuti. Sia che stia costruendo strumenti di automazione o integrando con le Sue appsia che stia costruendo strumenti di automazione o integrando con le Sue app preferite, nostro API RESTFUL fornisce un modo semplice e sicuro per interagire con i Suoi contenuti.

Funzionalità

Autenticazione

Autenticazione basata su token con crittografia HTTPS

Design RESTful

Metodi HTTP standard con risposte JSON

Posizioni

Capacità di geolocalizzazione integrate

Crea lista

Impossibile recuperare le metriche delle prestazioni

Casi d'uso

Automazione personale

Salva automaticamente note dalle Sue app preferite
Crea trigger di contenuto basati sulla posizione
Connetti IFTTT/Zapier flussi di lavoro

Integrazioni

Costruisca integrazioni personalizzate ed estensioni
Crei flussi di lavoro automatizzati per i contenuti
Sviluppa sistemi di gestione dei contenuti

Perfezionamenti

Crea lista

60 richieste per minuto per utente

Iniziare

1

Ottieni il Suo token API

Visiti la Sua brainful funzionalità per generare il Suo token API.

2

Scelga il Suo metodo di integrazione

Selezioni dal nostro codice di esempio in cURL, JavaScript, org Python inizia.

3

Effettui la Sua prima richiesta

Provi gli esempi interattivi qui sotto per testare la Sua integrazione.

autenticazione

Tutte le richieste API richiedono il Suo token API nell'header Authorization. Ottenga il Suo token dalTutte le richieste API richiedono il Suo token API nell'header Authorization. Ottenga il Suo token da brainful funzionalità. L'API supporta sia il formato token che bearer token.

Il Suo codice brainful:

Authorization: Token YOUR_API_TOKEN

Authorization: Bearer YOUR_API_TOKEN

crea blocco

POSThttps://brainful.dev/blocks/add

Richiedi accesso

Tutti i parametri sono inviati nel corpo della richiesta come JSON.

Parametro	Tipo	Testo richiesto.	Descrizione
inizia a condividere	inizia a condividere	Sì	Contenuto da aggiungere (1-5000 caratteri)
parent_luid	inizia a condividere	No	luid del blocco genitore (opzionale)
latitude	decimale	No	latitudine (-90° a 90°)
longitude	decimale	No	longitudine (-180° a 180°)
agent	inizia a condividere	No	Agent identifier (max 50 chars)
team_space	inizia a condividere	No	Team space slug to add the block to (only for organization members)

Contenuto stringa:Blocco genitore luid: latitudine (gradi, -90° a 90°): longitudine (gradi, -180° a 180°): agente (fino a 255 caratteri):Slug spazio team:

Generated Request

Risposta di esempio

{
                    "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
                  }

Campi di risposta

luid

Tipo: inizia a condividere

Identificatore unico per il contenuto creato

slug

Tipo: inizia a condividere

URL-friendly version of the content

words

Tipo: intero

Number of words in the content

remaining_daily_quota

Tipo: intero

Remaining content creation quota for today

Codici di risposta

201Creato (successo)

400Richiesta errata (stringa non valida)

401Non autorizzato (token non valido)

403Forbidden (plan not sufficient)

422Invalid location coordinates

aggiungi al blocco

POSThttps://brainful.dev/blocks/append

Richiedi accesso

Tutti i parametri sono inviati nel corpo della richiesta come JSON.

Parametro	Tipo	Testo richiesto.	Descrizione
identifier	inizia a condividere	Sì	Identificatore del blocco a cui aggiungere (luid org slug)
inizia a condividere	inizia a condividere	Sì	Contenuto da aggiungere (1-5000 caratteri)

Identificatore blocco (LUID org slug): Contenuto stringa:

Generated Request

Risposta di esempio

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

Campi di risposta

luid

Tipo: inizia a condividere

Identificatore unico per il contenuto creato

slug

Tipo: inizia a condividere

URL-friendly version of the content

words

Tipo: intero

Number of words in the content

remaining_daily_quota

Tipo: intero

Remaining content creation quota for today

Codici di risposta

201Creato (successo)

400Richiesta errata (stringa non valida)

401Non autorizzato (token non valido)

403Forbidden (plan not sufficient)

ottieni blocco

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

Richiedi accesso

URL Parameters

Parametro	Tipo	Testo richiesto.	Descrizione
luid	inizia a condividere	Sì	Identificatore unico del blocco da recuperare

Corpo della richiesta

Parametro	Tipo	Testo richiesto.	Descrizione
latitude	decimale	No	latitudine (-90° a 90°)
longitude	decimale	No	longitudine (-180° a 180°)
agent	inizia a condividere	No	Identificatore agente (massimo 50 caratteri)

blocco LUID (6 caratteri): latitudine (gradi, -90° a 90°): longitudine (gradi, -180° a 180°): agente (fino a 255 caratteri):

Generated Request

Risposta di esempio

{
  "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
}

Campi di risposta

creator

Tipo: inizia a condividere

Username of the content creator

luid

Tipo: inizia a condividere

Identificatore unico per il blocco

type

Tipo: inizia a condividere

Tipo di contenuto (ad es., "thought")

html

Tipo: inizia a condividere

HTML contenuto del blocco

created_timestamp

Tipo: inizia a condividere

Creation date and time

hits

Tipo: intero

Number of views

Codici di risposta

200Successo (blocco trovato)

401Non autorizzato (token non valido)

403Forbidden (plan not sufficient)

404Non trovato (blocco non trovato)

brainful libreria API

Navigazione

panoramica

Funzionalità

Casi d'uso

Automazione personale

Integrazioni

Perfezionamenti

Iniziare

Ottieni il Suo token API

Scelga il Suo metodo di integrazione

Effettui la Sua prima richiesta

autenticazione

crea blocco

Richiedi accesso

Generated Request

Risposta di esempio

Campi di risposta

Codici di risposta

aggiungi al blocco

Richiedi accesso

Generated Request

Risposta di esempio

Campi di risposta

Codici di risposta

ottieni blocco

Richiedi accesso

URL Parameters

Corpo della richiesta

Generated Request

Risposta di esempio

Campi di risposta

Codici di risposta

Si ispiri?