v0.3.7-beta
accedere registrare

brainful libreria API

Navigazione

panoramica Iniziare autenticazione crea blocco aggiungi al blocco ottieni blocco inizia

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.

Authorization: Token YOUR_API_TOKEN
Authorization: Bearer YOUR_API_TOKEN

crea blocco

POSThttps://brainful.one/blocks/add

Richiedi accesso

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

ParametroTipoTesto richiesto.Descrizione
inizia a condividereinizia a condividereSìContenuto da aggiungere (1-5000 caratteri)
parent_luidinizia a condividereNoluid del blocco genitore (opzionale)
latitudedecimaleNolatitudine (-90° a 90°)
longitudedecimaleNolongitudine (-180° a 180°)
agentinizia a condividereNoAgent identifier (max 50 chars)
team_spaceinizia a condividereNoTeam space slug to add the block to (only for organization members)

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.one/blocks/append

Richiedi accesso

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

ParametroTipoTesto richiesto.Descrizione
identifierinizia a condividereSì Identificatore del blocco a cui aggiungere (luid org slug)
inizia a condividereinizia a condividereSìContenuto da aggiungere (1-5000 caratteri)

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.one/blocks/get/{luid}

Richiedi accesso

URL Parameters

ParametroTipoTesto richiesto.Descrizione
luidinizia a condividereSìIdentificatore unico del blocco da recuperare

Corpo della richiesta

ParametroTipoTesto richiesto.Descrizione
latitudedecimaleNolatitudine (-90° a 90°)
longitudedecimaleNolongitudine (-180° a 180°)
agentinizia a condividereNo Identificatore agente (massimo 50 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)

Si ispiri?

Dia un'occhiata ad alcune delle nostre integrazioni ufficiali realizzate con brainful User API qui!