Abilitazione del supporto binario tramite la console Gateway API

La sezione spiega come abilitare il supporto binario utilizzando la console API Gateway. Ad esempio, utilizziamo un API sistema integrato con Amazon S3. Ci focalizziamo sulle attività per impostare i tipi di supporti ammessi e per specificare come dovrebbe essere gestito il payload. Per informazioni dettagliate su come creare un API sistema integrato con Amazon S3, consulta. Tutorial: creare un REST API proxy come Amazon S3

Per abilitare il supporto binario utilizzando la console API Gateway

1. Imposta i tipi di supporti binari perAPI:

   1. Creane uno nuovo API o scegline uno esistenteAPI. Per questo esempio, chiamiamo APIFileMan.

   2. Nella sezione selezionata API nel pannello di navigazione principale, scegli APIimpostazioni.

   3. Nel riquadro delle APIimpostazioni, scegli Gestisci i tipi di file multimediali nella sezione Tipi di file multimediali binari.

   4. Scegli Aggiungi tipo di supporto binario.

   5. Immetti il tipo di supporto richiesto, ad esempio image/png, nel campo di input. Se necessario, ripeti questa fase per aggiungere altri tipi di supporto. Per supportare tutti i tipi di file multimediali binari, specifica */*.

   6. Seleziona Salvataggio delle modifiche.

2. Imposta come vengono gestiti i payload dei messaggi per il API metodo:

   1. Crea una nuova risorsa o scegli una risorsa esistente in. API Ad esempio, noi utilizziamo la risorsa /{folder}/{item}.

   2. Crea un nuovo metodo o scegli un metodo esistente della risorsa. Come esempio, utilizziamo il metodo GET /{folder}/{item} integrato nell'azione Object GET in Amazon S3.

   3. Per Gestione contenuti scegli un'opzione.

      

      Scegliere Passthrough se non si vuole convertire il corpo quando il client e il back-end accettano lo stesso formato binario. Scegliete Converti in testo per convertire il corpo binario in una stringa con codifica Base64 quando, ad esempio, il backend richiede che il payload di una richiesta binaria venga passato come proprietà. JSON Scegli quindi Converti in binario quando il client invia una stringa con codifica base64 e il back-end richiede il formato binario originale o quando l'endpoint restituisce una stringa con codifica base64 e il client accetta solo l'output binario.

   4. Per Richiesta corpo passthrough scegli Quando non ci sono modelli definiti (consigliato).

      Puoi anche scegliere Mai. Ciò significa che API rifiuterà i dati con tipi di contenuto che non dispongono di un modello di mappatura.

   5. Mantieni l'intestazione Accept della richiesta in entrata nella richiesta di integrazione. Procedi in questo modo se hai impostato contentHandling su passthrough e vuoi sovrascrivere questa impostazione al runtime.

      

   6. Per la conversione in testo, definisci un modello di mappatura per mettere i dati binari con codifica base64 nel formato richiesto.

      Un esempio di modello di mappatura per la conversione in testo è il seguente:

      {
        "operation": "thumbnail",
        "base64Image": "$input.body"
      }

      Il formato di questo modello di mappatura dipende dai requisiti dell'endpoint dell'input.

   7. Selezionare Salva.