Carga de iconos y logotipos

Para añadir iconos y logotipos a un tema, primero deben cargarse en el bucket de AWS de la Meetings API y, a continuación, emparejarse con el tema correspondiente. También debe asegurarse de que sus logotipos y favicons cumplen los requisitos de imagen que se indican a continuación.

Requisitos

El tipo de imágenes debe cargarse en función del color de fondo. Las imágenes de color deben utilizarse para un fondo claro, mientras que para un fondo oscuro debe utilizarse una imagen más clara.

Requisitos del logotipo:

  • Formato: PNG
  • Tamaño máximo: 1MB
  • Dimensiones: 1 px - 300 px
  • El fondo debe ser transparente

Requisitos del favicon:

  • Formato: PNG
  • Tamaño máximo: 1MB
  • Dimensión: 16 x 16 - 32 x 32 y debe ser cuadrado
  • El fondo debe ser transparente

Cargar logotipo

A diferencia de los SDK de servidor, el proceso requiere 3 pasos con cURL.

1. Recuperar credenciales de carga

Ejemplo de solicitud

Utilice una solicitud

GET
para recuperar las credenciales necesarias para cargar sus imágenes en AWS. La respuesta contendrá objetos para cada favicon, logotipo claro y logotipo de color, y los objetos Policy será su JWT. Tome los valores para el tipo de imagen que desea cargar.

curl -X GET https://api-eu.vonage.com/v1/meetings/themes/logos-upload-urls \ -H "Authorization: Bearer "$JWT

Ejemplo de respuesta

{
  "url": "https://s3.amazonaws.com/roomservice-whitelabel-logos-prod",
  "fields": {
    "Content-Type": "image/png",
    "key": "auto-expiring-temp/logos/white/a2ef0569-7d2c-4297-b0dd-1af6d8b61be6",
    "logoType": "white",
    "bucket": "roomservice-whitelabel-logos-prod",
    "X-Amz-Algorithm": "AWS4-HMAC-SHA256",
    "X-Amz-Credential": "ASIA5NAYMMB6AP63DGBW/20220410/us-east-1/s3/aws4_request",
    "X-Amz-Date": "20220410T200246Z",
    "X-Amz-Security-Token": "XXXXX",
    "Policy": "XXXXX",
    "X-Amz-Signature": "fcb46c1adfa98836f0533aadebedc6fb1edbd90aa583f3264c0ae5bb63d83123"
  }
}

2. Cargue su archivo en AWS

Copie todos los valores de la respuesta anterior para el tipo de imagen que desea cargar y péguelos en el cuerpo de esta solicitud. Añade también la ruta del archivo de tu imagen.

curl -X POST 'https://s3.amazonaws.com/roomservice-whitelabel-logos-prod' \ --H 'Content-Type: multipart/form-data' \ -F 'Content-Type="image/png"' \ -F 'key="auto-expiring-temp/logos/white/a2ef0569-7d2c-4297-b0dd-1af6d8b61be6"' \ -F 'logoType="white"' \ -F 'bucket="roomservice-whitelabel-logos-prod"' \ -F 'X-Amz-Algorithm="AWS4-HMAC-SHA256"' \ -F 'X-Amz-Credential="ASIA5NAYMMB6AP63DGBW/20220410/us-east-1/s3/aws4_request"' \ -F 'X-Amz-Date="20220410T194523Z"' \ -F 'X-Amz-Security-Token="XXXXX"' \ -F 'Policy="XXXXX"' \ -F 'X-Amz-Signature="fcb46c1adfa98836f0533aadebedc6fb1edbd90aa583f3264c0ae5bb63d83123"' \ -F 'file=@"{PATH_TO_FILE}"'

Esto devolverá un 204 si tiene éxito. Si obtiene un error como "Compruebe su clave y método de firma"compruebe los espacios y el formato del cuerpo del mensaje.

3. Añadir claves al tema

Utilice el ID del tema que desea actualizar, junto con el campo key utilizado en el paso anterior, para vincular el logotipo con el tema que desea actualizar. Usted puede incluso hacer varias llamadas de carga, y luego pasar varias claves para el tema actualizar.

Una vez asociadas las imágenes a un tema, podrás ver sus detalles reflejados en la respuesta de a tema [GET]. En brand_image_colored_url, brand_image_white_url y branded_favicon_url contendrán la AWS Bucket Key, y sus respectivas URLs apuntarán a la imagen misma.

curl -X PUT 'https://api-eu.vonage.com/v1/meetings/themes/e8b1d80b-8f78-4578-94f2-328596e01387/finalizeLogos' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer '$JWT \ -d '{ "keys": [ "{white-logo-key}", "{colored-logo-key}", "{favicon-key}" ] }'

Referencia