Dokumentacja API

Doradca AI (streaming)

Otrzymuj ekspercką poradę dotyczącą projektu przez czat strumieniowy — SEO, design, dostępność, wydajność.

Ostatnia aktualizacja:

API doradcy AI

Strumieniuj eksperckie porady dotyczące projektu z zakresu SEO, designu, wydajności, dostępności, copywritingu, architektury, marketingu i bezpieczeństwa. Każde wywołanie POST kosztuje CREDIT_COSTS.ADVISOR kredytów i jest limitowane do 20 żądań na godzinę na klucz API. Administratorzy są zwolnieni z opłat w kredytach.

Pobieranie historii doradcy

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

Zwraca chronologiczną konwersację z doradcą dla projektu.

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

Zapytanie do doradcy (strumieniowanie)

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

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

Zwraca strumień text/plain. Nagłówki limitu szybkości są opróżniane przed pierwszym fragmentem, dzięki czemu klienci mogą je natychmiastowo przetworzyć. Wiadomości dłuższe niż 5000 znaków są odrzucane z błędem VALIDATION_ERROR.

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

W przypadku niewystarczającej liczby kredytów API zwraca ustrukturyzowaną odpowiedź 403, dzięki czemu klienty wywołujące narzędzia mogą wyświetlić dokładny niedobór:

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits",
    "limit": {
      "blocked": true,
      "reason": "credit_limit",
      "required": 1,
      "available": 0,
      "cta": { "text": "Buy credits", "action": "buy_credits" }
    }
  }
}
PoprzedniSekretyNastępnyStatystyki Projektu