API-Referenz

KI-Berater (Streaming)

Erhalten Sie Expertenrat zu Ihrem Projekt über Streaming-Chat — SEO, Design, Barrierefreiheit, Performance.

Zuletzt aktualisiert:

AI Advisor API

Streamen Sie fachkundige Projektberatung zu SEO, Design, Performance, Barrierefreiheit, Texterstellung, Architektur, Marketing und Sicherheit. Jeder POST kostet CREDIT_COSTS.ADVISOR Credits und ist auf 20 Anfragen pro Stunde pro API-Schlüssel begrenzt. Administratoren sind von Kreditgebühren ausgenommen.

Advisor-Verlauf abrufen

GET /api/v1/projects/{projectId}/advisor

Gibt die chronologische Advisor-Konversation für das Projekt zurück.

{
  "data": {
    "history": [
      { "id": "msg_...", "role": "user", "content": "Audit my SEO" },
      { "id": "msg_...", "role": "assistant", "content": "## SEO Audit..." }
    ]
  }
}

Den Advisor befragen (Streaming)

POST /api/v1/projects/{projectId}/advisor
Content-Type: application/json

{ "message": "Audit my homepage for accessibility issues" }

Gibt einen text/plain-Stream zurück. Die Rate-Limit-Header werden vor dem ersten Chunk gesendet, sodass Clients sie sofort parsen können. Nachrichten mit mehr als 5000 Zeichen werden mit einemVALIDATION_ERROR abgelehnt.

curl -N -X POST https://floop.tech/api/v1/projects/PRJ123/advisor \
  -H "Authorization: Bearer flp_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"message":"Review my copy"}'

Bei unzureichenden Credits gibt die API ein strukturiertes 403 zurück, sodass Tool-aufrufende Clients den genauen Fehlbetrag anzeigen können:

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits",
    "limit": {
      "blocked": true,
      "reason": "credit_limit",
      "required": 1,
      "available": 0,
      "cta": { "text": "Buy credits", "action": "buy_credits" }
    }
  }
}
ZurückSecretsWeiterProjekt-Statistiken