Ajouter des mots-clés

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.

Authorization: Bearer redreplier_test_1234567890
Content-Type: application/json

Paramètres

• websiteId (chemin, UUID, requis): Site web qui reçoit les mots-clés.

Corps de la requête

• keywords (string[], requis, non vide): Valeurs de mots-clés à ajouter; chaque valeur peut contenir jusqu’à 255 caractères.

Réponse

Renvoie un objet Website public.

Objet Website

• id (string): UUID du site web.
• accountGroupId (string): Groupe de compte résolu depuis le token.
• domain (string): Domaine normalisé du site web.
• url (string): URL du site web.
• name (string | null): Nom affiché.
• description (string | null): Contexte utilisé pour le score de pertinence.
• createdAt, updatedAt (ISO string | null): Horodatages de création et de mise à jour au format ISO 8601, ou null.
• keywords (Keyword[]): Objets Keyword de ce site web.

Objet Keyword

• id (string): UUID du mot-clé.
• websiteId (string): UUID du site web parent.
• value (string): Texte du mot-clé, jusqu’à 255 caractères.
• status (string): PENDING, ACTIVE, DISABLED ou SUSPENDED.
• createdAt, updatedAt (ISO string | null): Horodatages de création et de mise à jour au format ISO 8601, ou null.

Exemple de requête

curl -X POST https://ai.redreplier.com/ai-app/api/v1/websites/11111111-1111-4111-8111-111111111111/keywords \
  -H 'Authorization: Bearer redreplier_test_1234567890' \
  -H 'Content-Type: application/json' \
  -d '{"keywords":["agency CRM","client onboarding software"]}'

Notes

L’ajout de mots-clés est distinct de la modification. Les nouveaux mots-clés commencent avec PENDING et peuvent s’activer automatiquement si la capacité de l’abonnement le permet.

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.
• 404 Not Found: La ressource n’existe pas pour le compte du token.
• 500 Internal Server Error: Erreur serveur inattendue.