Hochladen von Icons und Logos

Um einem Thema Symbole und Logos hinzuzufügen, müssen diese zunächst in den Meetings API AWS-Bucket hochgeladen und dann mit dem dem jeweiligen Thema. Sie sollten auch sicherstellen, dass Ihre Logos und Favicons den unten aufgeführten Bildanforderungen entsprechen.

Anforderungen

Die Art der Bilder sollte auf der Grundlage der Hintergrundfarbe hochgeladen werden. Für einen hellen Hintergrund sollten farbige Bilder verwendet werden, während für einen dunklen Hintergrund ein helleres Bild verwendet werden sollte.

Anforderungen an das Logo:

  • Format: PNG
  • Maximale Größe: 1MB
  • Abmessungen: 1 px - 300 px
  • Der Hintergrund muss transparent sein

Favicon-Anforderungen:

  • Format: PNG
  • Maximale Größe: 1MB
  • Abmessungen: 16 x 16 - 32 x 32 und müssen quadratisch sein
  • Der Hintergrund muss transparent sein

Logo hochladen

Im Gegensatz zu den Server-SDKs erfordert der Prozess mit cURL 3 Schritte.

1. Upload-Zugangsdaten abrufen

Beispiel-Anfrage

Verwenden Sie eine

GET
-Anforderung, um die Anmeldeinformationen abzurufen, die zum Hochladen Ihrer Bilder auf AWS erforderlich sind. Die Antwort enthält Objekte für jedes Favicon, Light-Logo und farbige Logo sowie die Policy wird Ihr JWT sein. Übernehmen Sie die Werte für den Bildtyp den Sie hochladen möchten.

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

Beispiel Antwort

{
  "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. Hochladen Ihrer Datei zu AWS

Kopieren Sie alle Werte aus der obigen Antwort für den Bildtyp, den Sie hochladen möchten, und fügen Sie sie in den Textkörper dieser Anfrage ein. Fügen Sie auch den Dateipfad zu Ihrem Bild hinzu.

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

Im Erfolgsfall wird ein 204 zurückgegeben. Wenn Sie einen Fehler erhalten wie "Überprüfen Sie Ihren Schlüssel und Ihre Signiermethode"überprüfen Sie die Leerzeichen und die Formatierung des Nachrichtentextes.

3. Schlüssel zum Thema hinzufügen

Verwenden Sie die Themen-ID des Themas, das Sie aktualisieren möchten, zusammen mit der key die Sie im vorherigen Schritt verwendet haben, um das Logo mit dem Thema, das Sie aktualisieren möchten. Sie können sogar mehrere Upload-Aufrufe machen und dann mehrere Schlüssel an das Thema übergeben aktualisieren.

Sobald die Bilder mit einem Thema verknüpft sind, können Sie ihre Details in der Antwort von a Thema [GET]. Die brand_image_colored_url, brand_image_white_url und branded_favicon_url Werte enthalten den AWS Bucket Key, und ihre jeweiligen URLs verweisen auf das Bild selbst.

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

Referenz