Chilkat HOME .NET Core C# Android™ AutoIt C C# C++ Chilkat2-Python CkPython Classic ASP DataFlex Delphi ActiveX Delphi DLL Go Java Lianja Mono C# Node.js Objective-C PHP ActiveX PHP Extension Perl PowerBuilder PowerShell PureBasic Ruby SQL Server Swift 2 Swift 3,4,5... Tcl Unicode C Unicode C++ VB.NET VBScript Visual Basic 6.0 Visual FoxPro Xojo Plugin
(C++) Xero Get Attachment (Download a Xero Attachment)Demonstrates how to get the content of an attachment in Xero. Note: This example requires Chilkat v9.5.0.64 or greater.
#include <CkRest.h> #include <CkStringBuilder.h> #include <CkXml.h> #include <CkBinData.h> void ChilkatSample(void) { // Note: Requires Chilkat v9.5.0.64 or greater. // This requires the Chilkat API to have been previously unlocked. // See Global Unlock Sample for sample code. CkRest rest; bool success; // Before sending REST API calls, the REST object needs to be // initialized for OAuth1. // See Xero 2-Legged OAuth1 Setup for sample code. // Assuming the REST object's OAuth1 authenticator is setup, and the initial // connection was made, we may now send REST HTTP requests.. // -------------------------------------------------------------- // First get a list of attachments for a given document (in this case a Receipt). const char *endPoint = "Receipts"; const char *receiptID = "c4f40e59-c390-0001-caff-ce731c707d00"; CkStringBuilder sbPath; sbPath.Append("/api.xro/2.0/{Endpoint}/{Guid}/Attachments/"); int numReplaced = sbPath.Replace("{Endpoint}",endPoint); numReplaced = sbPath.Replace("{Guid}",receiptID); const char *responseXml = rest.fullRequestNoBody("GET",sbPath.getAsString()); if (rest.get_LastMethodSuccess() != true) { std::cout << rest.lastErrorText() << "\r\n"; return; } // A 200 response is expected for actual success. if (rest.get_ResponseStatusCode() != 200) { std::cout << responseXml << "\r\n"; return; } // Examine the response. std::cout << responseXml << "\r\n"; // A sample response looks like this: // <Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> // <Id>b235646f-34ac-4b15-90ce-d63267f7cd33</Id> // <Status>OK</Status> // <ProviderName>ChilkatPrivate</ProviderName> // <DateTimeUTC>2016-11-11T14:32:17.0908971Z</DateTimeUTC> // <Attachments> // <Attachment> // <AttachmentID>0edcddc8-325f-40c7-b950-8c71f14afc7c</AttachmentID> // <FileName>penguins.jpg</FileName> // <Url>http://api.xero.com/api.xro/2.0/Receipts/c4f40e59-c390-0001-caff-ce731c707d00/Attachments/penguins.jpg</Url> // <MimeType>image/jpg</MimeType> // <ContentLength>777835</ContentLength> // </Attachment> // <Attachment> // <AttachmentID>0adffdc8-325f-65c7-b950-4391f14af908</AttachmentID> // <FileName>starfish.jpg</FileName> // <Url>http://api.xero.com/api.xro/2.0/Receipts/c4f40e59-c390-0001-caff-ce731c707d00/Attachments/starfish.jpg</Url> // <MimeType>image/jpg</MimeType> // <ContentLength>24537</ContentLength> // </Attachment> // </Attachments> // </Response> CkXml xml; xml.LoadXml(responseXml); // Iterate over the attachments and download each. int numRecords = xml.NumChildrenAt("Attachments"); std::cout << "Number of Attachments = " << numRecords << "\r\n"; CkStringBuilder sbSaveFilePath; CkStringBuilder sbAttachmentPath; CkBinData attachmentData; int i = 0; while (i < numRecords) { xml.put_I(i); const char *attachmentID = xml.getChildContent("Attachments|Attachment[i]|AttachmentID"); const char *filename = xml.getChildContent("Attachments|Attachment[i]|FileName"); std::cout << "AttachmentID: " << attachmentID << "\r\n"; std::cout << "Filename: " << filename << "\r\n"; std::cout << "----" << "\r\n"; // Download this attachment. // First build the path for this particular attachment by appending the FileName to the path used to get the list of attachments. sbAttachmentPath.Clear(); sbAttachmentPath.AppendSb(sbPath); sbAttachmentPath.Append(filename); // Send the GET request in one call, and then get the response in the next two. success = rest.SendReqNoBody("GET",sbAttachmentPath.getAsString()); if (success != true) { std::cout << rest.lastErrorText() << "\r\n"; return; } // Get the response header. If it's not a 200 success status code, then the response body does NOT contain // the attachment data. int statusCode = rest.ReadResponseHeader(); if (statusCode == -1) { // We didn't get any response.. std::cout << rest.lastErrorText() << "\r\n"; return; } if (statusCode != 200) { std::cout << "Response Status: " << statusCode << "\r\n"; const char *responseBody = rest.readRespBodyString(); if (rest.get_LastMethodSuccess() != true) { std::cout << "Failed to read the response body." << "\r\n"; } else { std::cout << responseBody << "\r\n"; } std::cout << "Failed." << "\r\n"; return; } // OK, the response header indicates the attachment content is forthcoming... // There are a few ways to get the response body. If it is a very large attachment, it can be streamed directly // to a file. We'll assume it's not, so we'll get the response into a BinData object, and then save it to a file. attachmentData.Clear(); success = rest.ReadRespBd(attachmentData); if (success != true) { std::cout << rest.lastErrorText() << "\r\n"; return; } // Save the data to the file. sbSaveFilePath.SetString("qa_output/"); sbSaveFilePath.Append(filename); success = attachmentData.WriteFile(sbSaveFilePath.getAsString()); if (success != true) { std::cout << "Failed to save to output file." << "\r\n"; } else { std::cout << "Saved to " << sbSaveFilePath.getAsString() << "\r\n"; } i = i + 1; } } |
© 2000-2024 Chilkat Software, Inc. All Rights Reserved.