Chilkat • HOME • Android™ • AutoIt • C • C# • C++ • Chilkat2-Python • CkPython • Classic ASP • DataFlex • Delphi DLL • Go • Java • Node.js • Objective-C • PHP Extension • Perl • PowerBuilder • PowerShell • PureBasic • Ruby • SQL Server • Swift • Tcl • Unicode C • Unicode C++ • VB.NET • VBScript • Visual Basic 6.0 • Visual FoxPro • Xojo Plugin
(C) REST Download Binary to Memory (CkByteData) (Amazon S3)Demonstrates how to make a REST call that returns a binary response body. This example is valid for reasonably small files that fit in memory. The example shows how to download a small JPG from the Amazon S3 service. For larger files, Chilkat provides streaming functionality to stream directly to a file, or to make an asynchronous call where the foreground thread can read the response body stream.
#include <C_CkRest.h> #include <C_CkAuthAws.h> #include <C_CkByteData.h> void ChilkatSample(void) { HCkRest rest; BOOL bTls; int port; BOOL bAutoReconnect; BOOL success; HCkAuthAws authAws; int responseStatusCode; HCkByteData jpgData; const char *errResponse; // This example requires the Chilkat API to have been previously unlocked. // See Global Unlock Sample for sample code. rest = CkRest_Create(); // Connect to the Amazon AWS REST server. bTls = TRUE; port = 443; bAutoReconnect = TRUE; success = CkRest_Connect(rest,"s3.amazonaws.com",port,bTls,bAutoReconnect); // ---------------------------------------------------------------------------- // Important: For buckets created in regions outside us-east-1, // there are three important changes that need to be made. // See Working with S3 Buckets in Non-us-east-1 Regions for the details. // ---------------------------------------------------------------------------- // Provide AWS credentials for the REST call. authAws = CkAuthAws_Create(); CkAuthAws_putAccessKey(authAws,"AWS_ACCESS_KEY"); CkAuthAws_putSecretKey(authAws,"AWS_SECRET_KEY"); CkAuthAws_putServiceName(authAws,"s3"); success = CkRest_SetAuthAws(rest,authAws); // Set the bucket name via the HOST header. // In this case, the bucket name is "chilkat100". CkRest_putHost(rest,"chilkat100.s3.amazonaws.com"); // Send the request to download the JPG. success = CkRest_SendReqNoBody(rest,"GET","/starfish.jpg"); if (success != TRUE) { printf("%s\n",CkRest_lastErrorText(rest)); CkRest_Dispose(rest); CkAuthAws_Dispose(authAws); return; } // Read the response header. responseStatusCode = CkRest_ReadResponseHeader(rest); if (responseStatusCode < 0) { printf("%s\n",CkRest_lastErrorText(rest)); CkRest_Dispose(rest); CkAuthAws_Dispose(authAws); return; } printf("Response status code = %d\n",responseStatusCode); // We expect a 200 response status if the JPG data is coming. // Otherwise, we'll get a string response body with an error message(or no response body). if (responseStatusCode == 200) { jpgData = CkByteData_Create(); success = CkRest_ReadRespBodyBinary(rest,jpgData); if (CkRest_getLastMethodSuccess(rest) != TRUE) { printf("%s\n",CkRest_lastErrorText(rest)); } else { printf("Successfully received the JPG bytes..\n"); // See the CkByteData online reference documentation for // information about accessing and manipulating the byte data. } } else { errResponse = CkRest_readRespBodyString(rest); if (CkRest_getLastMethodSuccess(rest) != TRUE) { printf("%s\n",CkRest_lastErrorText(rest)); } else { printf("%s\n",errResponse); } } CkRest_Dispose(rest); CkAuthAws_Dispose(authAws); CkByteData_Dispose(jpgData); } |
© 2000-2025 Chilkat Software, Inc. All Rights Reserved.