API-referentiePOST

Websitebeschrijving analyseren

Laat AI een beschrijving maken op basis van een URL voordat je een website aanmaakt of bijwerkt.

POSThttps://ai.redreplier.com/ai-app/api/v1/websites/analyze-description

Laat AI een beschrijving maken op basis van een URL voordat je een website aanmaakt of bijwerkt.

Bearer-token (RedReplier API-token)

Authenticatie

Stuur bij elk verzoek een RedReplier-API-token mee als Bearer-token. Tokens beginnen met redreplier_; RedReplier leidt het account af uit het token. Stuur X-Workspace-Id mee om in een andere workspace dan de standaardworkspace te werken; zie Workspaces weergeven.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Parameters

Dit endpoint heeft geen pad- of queryparameters.

Request body

  • url (string, URL, verplicht): URL van de website die je wilt analyseren.

Respons

Geeft de gegenereerde beschrijving terug.

  • description (string): Door AI gegenereerde samenvatting van de website of het product.

Voorbeeldverzoek

curl -X POST https://ai.redreplier.com/ai-app/api/v1/websites/analyze-description \
  -H 'Authorization: Bearer redreplier_test_1234567890' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://acmecrm.io"}'

Opmerkingen

Gebruik dit vóór aanmaken of bijwerken als je de door AI gegenereerde beschrijving eerst wilt bekijken.

Fouten

  • 400 Bad Request: Ongeldige invoer, URL, UUID, enum, queryparameter of body.
  • 401 Unauthorized: Bearer-token ontbreekt of is ongeldig, of code: "token_issuer_lost_access" wanneer de persoon die de API-sleutel heeft aangemaakt is gedeactiveerd of de workspace heeft verlaten.
  • 403 Forbidden: code: "subscription_required" wanneer het abonnement van de workspace geen API-toegang bevat, code: "workspace_access_denied" wanneer X-Workspace-Id een workspace noemt waar deze inloggegevens geen toegang toe hebben, of code: "permission_denied" wanneer je rol in de workspace geen redreplier.write heeft (Admin en Editor hebben die wel).
  • 404 Not Found: De resource bestaat niet voor het account van het token.
  • 429 Too Many Requests: Rate limit overschreden. Wacht het aantal seconden uit Retry-After.
  • 500 Internal Server Error: Onverwachte serverfout.
Voorbeeldverzoek (curl)
curl --request POST \
  --url https://ai.redreplier.com/ai-app/api/v1/websites/analyze-description \
  --header 'Authorization: Bearer redreplier_test_1234567890' \
  --header 'Content-Type: application/json' \
  --data '{"url": "https://acmecrm.io"}'
201
{
  "description": "Acme CRM helps small agencies manage sales pipelines, client relationships, and follow-up workflows."
}