Crear sitio web

Parámetros

Este endpoint no acepta parámetros de ruta ni de consulta.

Cuerpo de la solicitud

• url (string, URL, obligatorio): URL del sitio web.
• name (string, opcional): Nombre visible.
• keywords (string[], opcional): Valores iniciales de palabras clave; cada valor puede tener hasta 255 caracteres.
• description (string, opcional, máximo 5000): Descripción manual del sitio web. Si se omite, RedReplier rastrea la URL y redacta una, consumiendo una generación de IA de la cuota del plan. Si el rastreo falla o la cuota se agota, el sitio se crea igualmente con description: null; define una con PATCH /websites/{id} o POST /websites/analyze-description. Envía description: "" para saltarte el rastreo y el análisis con IA: no se consume ninguna generación y el sitio empieza sin descripción.

Respuesta

Devuelve un objeto Website público.

Objeto Website

• id (string): UUID del sitio web.
• accountGroupId (string): Grupo de cuenta resuelto desde el token.
• domain (string): Dominio normalizado del sitio web.
• url (string): URL del sitio web.
• name (string | null): Nombre visible.
• description (string | null): Contexto usado para calcular la relevancia.
• createdAt, updatedAt (ISO string | null): Marcas de creación y actualización en formato ISO 8601, o null.
• keywords (Keyword[]): Objetos Keyword de este sitio web.

Objeto Keyword

• id (string): UUID de la palabra clave.
• websiteId (string): UUID del sitio web principal.
• value (string): Texto de la palabra clave, hasta 255 caracteres.
• status (string): PENDING, ACTIVE, DISABLED o SUSPENDED.
• createdAt, updatedAt (ISO string | null): Marcas de creación y actualización en formato ISO 8601, o null.

Notas

Las palabras clave iniciales se guardan como PENDING. Las que caben en el plan pasan a ACTIVE en la siguiente llamada a GET /websites o POST /websites/{websiteId}/keywords; el resto sigue PENDING hasta que se mejore el plan en la app de RedReplier. Un dominio ya monitorizado en este workspace devuelve 400, igual que un plan sin plazas de sitio web libres. Volver a agregar un dominio eliminado restaura ese sitio web.

Errores

• 400 Bad Request: Entrada, URL, UUID, enum, parámetro de consulta o cuerpo no válido.
• 401 Unauthorized: Bearer token ausente o no válido, o code: "token_issuer_lost_access" cuando la persona que creó la clave API fue desactivada o salió del workspace.
• 403 Forbidden: code: "subscription_required" cuando el plan del workspace no incluye acceso a la API, code: "workspace_access_denied" cuando X-Workspace-Id indica un workspace al que esta credencial no puede acceder, o code: "permission_denied" cuando tu rol en el workspace no tiene el permiso redreplier.write (lo tienen Admin y Editor).
• 404 Not Found: El recurso no existe para la cuenta del token.
• 429 Too Many Requests: Límite de solicitudes superado. Espera los segundos indicados en Retry-After.
• 500 Internal Server Error: Error inesperado del servidor.