Crear una marca

Crea una marca: el objeto de nivel superior de la Social API. A una marca le pertenecen las cuentas sociales que conectas a ella y todas las publicaciones realizadas desde esas cuentas. No se puede realizar ninguna otra llamada a la Social API hasta que exista al menos una marca, por lo que esta es la primera solicitud de cualquier integración con la Social API.

Caso de uso: incorporar a un cliente a la publicación en redes sociales. Cuando un cliente se registre en tu producto, crea una marca por cada negocio para el que quiera publicar. Guarda el socialProfile.id devuelto en tu propio registro de ese negocio: es el parámetro de ruta brandId en POST /social/brands/{brandId}/connections/link y GET /social/brands/{brandId}/posts, y el campo socialProfileId del cuerpo de cada publicación que crees. A continuación, dirige al usuario al enlace de conexión alojado para cada plataforma en la que quiera publicar.

Notas.

• El cuerpo de la solicitud debe estar contenido en un objeto input. Todas las operaciones de escritura de la Social API usan esta estructura, con una excepción: el enlace de conexión acepta un cuerpo sin anidar.
• Comprueba success, no el estado HTTP. Un fallo de validación —la ausencia de profileName o un timezone.tzCode desconocido— se devuelve como HTTP 200 con success: false y el motivo en error. Considera que la llamada se ha realizado correctamente solo cuando success sea true.
• Solo profileName y timezone son obligatorios. Los valores predeterminados de businessIntent y categories son general y una lista vacía, respectivamente, por lo que una integración que no tenga campos equivalentes puede omitirlos por completo.
• timezone.tzCode no es un adorno. Una publicación programada con scheduleDate + scheduleTime se interpreta según la zona horaria de la marca, no la de quien realiza la llamada ni UTC. Cambiarla más adelante no modifica la hora de las publicaciones ya programadas.
• La marca siempre pertenece a la cuenta asociada a la clave de API. No hay forma de crear una marca en otra cuenta: se ignora cualquier identificador de cuenta incluido en el cuerpo.
• Los ID de marca son UUID sin codificación adicional. No son los ID de Relay en Base64 que usan Locations y los Posts de ubicaciones, así que no los codifiques ni decodifiques. El mismo ID aparece como parámetro de ruta brandId y como campo socialProfileId del cuerpo: brandId solo se usa como parámetro de URL, nunca como campo del cuerpo.
• No hay límite de marcas en un plan de API. Las marcas son ilimitadas y no se contabilizan como consumo, por lo que esta llamada nunca se rechaza por haber alcanzado un límite y no necesitas comprobar la capacidad disponible antes de crear una. Lo que se contabiliza son las conexiones: una cuenta social vinculada a una marca en una red. Consulta Planes y complementos para conocer los niveles de conexiones y el precio de un paquete de conexiones, y GET /social/limits para consultar tu capacidad de conexiones disponible antes de dirigir a un usuario a un enlace de conexión.

Operación de escritura: no se ha ejecutado en la cuenta real. La solicitud y la respuesta mostradas se han generado a partir del esquema de la API.