Ein von API Gateway generiertes Ruby-SDK für eine REST-API verwenden

So installieren und instanziieren Sie ein von API Gateway generiertes Ruby-SDK für eine REST-API und rufen es auf:

1. Entpacken Sie die heruntergeladene Ruby-SDK-Datei. Die generierte SDK-Quelle wird wie folgt angezeigt.

   

2. Erstellen Sie mit den folgenden Shell-Befehlen einen Ruby-Gem aus der generierten SDK-Quelle in einem Terminalfenster:

   # change to /simplecalc-sdk directory
   cd simplecalc-sdk
   
   # build the generated gem
   gem build simplecalc-sdk.gemspec

   Anschließend ist simplecalc-sdk-1.0.0.gem verfügbar.

3. Installieren Sie das Gem:

   gem install simplecalc-sdk-1.0.0.gem

4. Erstellen Sie eine Client-Anwendung. Instanziiert und initialisiert den Ruby-SDK-Client in der App:

   require 'simplecalc-sdk'
   client = SimpleCalc::Client.new(
       http_wire_trace: true,
       retry_limit: 5,
       http_read_timeout: 50
   )

   Wenn für die API die Autorisierung des AWS_IAM-Typs konfiguriert ist, können Sie die AWS-Anmeldeinformationen des Aufrufers durch Bereitstellen von accessKey und secretKey bei der Initialisierung einschließen:

   require 'pet-sdk'
   client = Pet::Client.new(
       http_wire_trace: true,
       retry_limit: 5,
       http_read_timeout: 50,
       access_key_id: 'ACCESS_KEY',
       secret_access_key: 'SECRET_KEY'
   )

5. Führen Sie API-Aufrufe über das SDK in der App durch.

   Tipp

   Wenn Sie nicht mit den Konventionen des SDK-Methodenaufrufs vertraut sind, können Sie die client.rb-Datei im generierten lib-SDK-Ordner überprüfen. Der Ordner enthält die Dokumentation der einzelnen unterstützten API-Methodenaufrufe.

   So erkennen Sie unterstützte Operationen:

   # to show supported operations:
   puts client.operation_names

   Dies führt entsprechend der API-Methoden GET /?a={.}&b={.}&op={.}, GET /{a}/{b}/{op}und POST / jeweils folgender Anzeige sowie zu einer Nutzlast vom {a:"…", b:"…", op:"…"}-Format:

   [:get_api_root, :get_ab_op, :post_api_root]

   Für den Aufruf der GET /?a=1&b=2&op=+-API-Methode rufen Sie die folgende Ruby-SDK-Methode auf:

   resp = client.get_api_root({a:"1", b:"2", op:"+"})

   Für den Aufruf der POST /-API-Methode mit einer Nutzlast von {a: "1", b: "2", "op": "+"} rufen Sie die folgende Ruby-SDK-Methode auf:

   resp = client.post_api_root(input: {a:"1", b:"2", op:"+"})

   Für den Aufruf der GET /1/2/+-API-Methode rufen Sie die folgende Ruby-SDK-Methode auf:

   resp = client.get_ab_op({a:"1", b:"2", op:"+"})

   Die erfolgreichen SDK-Methodenaufrufe geben die folgende Antwort zurück:

   resp : {
       result: {
           input: {
               a: 1,
               b: 2,
               op: "+"
           },
           output: {
               c: 3
           }
       }
   }