Schnellstart

Führen Sie Ihren ersten neuroflash API-Aufruf in unter 2 Minuten durch.

Voraussetzungen

• Ein neuroflash-Konto mit API-Zugang
• Ihre client_id und client_secret aus Service Accounts in der neuroflash App

Schritt 1: Access Token abrufen

Tauschen Sie Ihre Anmeldedaten gegen einen Access Token ein:

cURL

curl -X POST https://id.neuroflash.com/oauth/v2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "scope=openid"

Python

import requests

response = requests.post(
    "https://id.neuroflash.com/oauth/v2/token",
    data={
        "grant_type": "client_credentials",
        "client_id": "YOUR_CLIENT_ID",
        "client_secret": "YOUR_CLIENT_SECRET",
        "scope": "openid",
    },
)

token = response.json()["access_token"]

Node.js

const response = await fetch("https://id.neuroflash.com/oauth/v2/token", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    grant_type: "client_credentials",
    client_id: "YOUR_CLIENT_ID",
    client_secret: "YOUR_CLIENT_SECRET",
    scope: "openid",
  }),
});

const { access_token } = await response.json();

Go

package main

import (
	"encoding/json"
	"net/http"
	"net/url"
	"strings"
)

func main() {
	data := url.Values{
		"grant_type":    {"client_credentials"},
		"client_id":     {"YOUR_CLIENT_ID"},
		"client_secret": {"YOUR_CLIENT_SECRET"},
		"scope":         {"openid"},
	}

	resp, _ := http.Post(
		"https://id.neuroflash.com/oauth/v2/token",
		"application/x-www-form-urlencoded",
		strings.NewReader(data.Encode()),
	)
	defer resp.Body.Close()

	var result struct {
		AccessToken string `json:"access_token"`
	}
	json.NewDecoder(resp.Body).Decode(&result)
	token := result.AccessToken

Die Antwort enthält einen access_token, der ungefähr 4 Stunden gültig ist. Weitere Details finden Sie unter Authentifizierung.

Schritt 2: Workspace abrufen

Die meisten API-Endpoints erfordern eine Workspace-ID. Rufen Sie Ihre Workspaces ab, um eine zu erhalten:

cURL

curl https://app.neuroflash.com/api/workspace-service/v1/workspaces \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Python

response = requests.get(
    "https://app.neuroflash.com/api/workspace-service/v1/workspaces",
    headers={"Authorization": f"Bearer {token}"},
)

workspaces = response.json()["data"]
workspace_id = workspaces[0]["id"]
print(f"Workspace ID: {workspace_id}")

Node.js

const wsResponse = await fetch(
  "https://app.neuroflash.com/api/workspace-service/v1/workspaces",
  {
    headers: { Authorization: `Bearer ${access_token}` },
  }
);

const { data: workspaces } = await wsResponse.json();
const workspaceId = workspaces[0].id;
console.log(`Workspace ID: ${workspaceId}`);

Go

	req, _ := http.NewRequest("GET",
		"https://app.neuroflash.com/api/workspace-service/v1/workspaces", nil)
	req.Header.Set("Authorization", "Bearer "+token)

	resp, _ = http.DefaultClient.Do(req)
	defer resp.Body.Close()

	var wsResult struct {
		Data []struct {
			ID string `json:"id"`
		} `json:"data"`
	}
	json.NewDecoder(resp.Body).Decode(&wsResult)
	workspaceID := wsResult.Data[0].ID

Beispielantwort:

{
  "data": [
    {
      "id": "abc123",
      "name": "My Workspace",
      "role": "owner"
    }
  ]
}

Schritt 3: Ihren ersten API-Aufruf durchführen

Verwenden Sie Ihre Workspace-ID, um die verfügbaren demografischen Gruppen für Digital Twins aufzulisten:

cURL

curl https://app.neuroflash.com/api/digital-twin-service/v1/static-groups \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Python

response = requests.get(
    "https://app.neuroflash.com/api/digital-twin-service/v1/static-groups",
    headers={"Authorization": f"Bearer {token}"},
)

groups = response.json()
for group in groups:
    print(f"{group['name']} — {group['description']}")

Node.js

const groupsResponse = await fetch(
  "https://app.neuroflash.com/api/digital-twin-service/v1/static-groups",
  {
    headers: { Authorization: `Bearer ${access_token}` },
  }
);

const groups = await groupsResponse.json();
groups.forEach((g) => console.log(`${g.name} — ${g.description}`));

Go

	req, _ = http.NewRequest("GET",
		"https://app.neuroflash.com/api/digital-twin-service/v1/static-groups", nil)
	req.Header.Set("Authorization", "Bearer "+token)

	resp, _ = http.DefaultClient.Do(req)
	defer resp.Body.Close()

	var groups []struct {
		Name        string `json:"name"`
		Description string `json:"description"`
	}
	json.NewDecoder(resp.Body).Decode(&groups)
	for _, g := range groups {
		fmt.Printf("%s — %s\n", g.Name, g.Description)
	}
}

Beispielantwort:

[
  {
    "id": "gen-z",
    "name": "Gen Z",
    "description": "Born 1997–2012",
    "twinsCount": 5
  },
  {
    "id": "millennials",
    "name": "Millennials",
    "description": "Born 1981–1996",
    "twinsCount": 5
  }
]

Sie haben gerade Ihren ersten neuroflash API-Aufruf durchgeführt.

Nächste Schritte

• Leitfaden: Digital-Twin-Umfrage — Führen Sie Umfragen über demografische Gruppen hinweg durch
• Leitfaden: Textgenerierung — Generieren Sie Inhalte mit KI-Modellen
• Leitfaden: Bildgenerierung — Erstellen Sie Bilder aus Texteingaben
• Authentifizierung — Erfahren Sie mehr über Token-Verwaltung und Scopes