Référence de l'APIPOST

Analyser la description du site web

Génère une description IA depuis une URL avant de créer ou mettre à jour un site web.

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

Génère une description IA depuis une URL avant de créer ou mettre à jour un site web.

Jeton Bearer (jeton API RedReplier)

Authentification

Envoyez un token API RedReplier comme Bearer token à chaque requête. Les tokens commencent par redreplier_; RedReplier résout le compte depuis le token. Envoyez X-Workspace-Id pour agir dans un autre espace de travail que celui par défaut; voir Lister les espaces de travail.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Paramètres

Cet endpoint ne prend aucun paramètre de chemin ou de requête.

Corps de la requête

  • url (string, URL, requis): URL du site web à analyser.

Réponse

Renvoie la description générée.

  • description (string): Résumé généré par IA du site web ou du produit.

Exemple de requête

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

Notes

Utilisez-le avant la création ou la mise à jour pour vérifier la description générée par IA.

Erreurs

  • 400 Bad Request: Entrée, URL, UUID, enum, paramètre de requête ou corps non valide.
  • 401 Unauthorized: Bearer token manquant ou non valide, ou code: "token_issuer_lost_access" quand la personne qui a créé la clé API a été désactivée ou a quitté l'espace de travail.
  • 403 Forbidden: code: "subscription_required" quand l'abonnement de l'espace de travail n'inclut pas l'accès à l'API, code: "workspace_access_denied" quand X-Workspace-Id désigne un espace de travail que ces identifiants ne peuvent pas atteindre, ou code: "permission_denied" quand votre rôle dans l'espace de travail n'a pas la permission redreplier.write (Admin et Editor l'ont).
  • 404 Not Found: La ressource n’existe pas pour le compte du token.
  • 429 Too Many Requests: Limite de débit dépassée. Attendez le nombre de secondes indiqué dans Retry-After.
  • 500 Internal Server Error: Erreur serveur inattendue.
Exemple de requête (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."
}