C++
操作场景
使用C++语言调用APP认证的API时,您需要先获取SDK,参考API调用示例调用API。
准备环境
- 已获取API的域名、请求url、请求方法、AppKey和AppSecret等信息,具体参见认证前准备。
- 安装openssl库。
apt-get install libssl-dev
- 安装curl库。
apt-get install libcurl4-openssl-dev
获取SDK
- 登录DataArts Studio控制台。
- 单击“数据服务”模块。
- 单击左侧菜单“专享版 > SDK”。
- 单击SDK使用引导区域里对应语言的SDK,下载SDK包到本地。
- 进行SDK包完整性校验。Windows操作系统下,打开本地命令提示符框,输入如下命令,在本地生成已下载SDK包的SHA256值,其中,“D:\java-sdk.zip”为SDK包的本地存放路径和SDK包名,请根据实际情况修改。
certutil -hashfile D:\java-sdk.zip SHA256
命令执行结果示例,如下所示:
SHA256 的 D:\java-sdk.zip 哈希: becff4310645f3734344897ffdcabb1853d4b7d93b59a6ea187c5ae40543b36b CertUtil: -hashfile 命令成功完成。 becff4310645f3734344897ffdcabb1853d4b7d93b59a6ea187c5ae40543b36b
对比所下载SDK包的SHA256值和下表中对应语言SDK包的SHA256值。如果一致,则表示下载过程不存在篡改和丢包。
不同语言SDK包
SHA256值
Java
becff4310645f3734344897ffdcabb1853d4b7d93b59a6ea187c5ae40543b36b
Go
bcf8cf19a21226e247195f2e584c8414da39b8d05840fb02948e1375d9bbb7e6
Python
c3da3b5814f828d6217963e856563d558d938b3da28993a8a13c8a7ebff5b95d
C#
a880b47e63ab35bfe216592e340a8135b866aef8f756ef7738fff3287885f33a
JavaScript
53261387f5fcf46e61d0bef5e890bea97952717f327c356412c3128389e848d6
PHP
29bf711144e77a4adaea1257cd6dedd2220e57b729a8fd000c51e68ccb42ad4b
C++
f604c6386c62cccb7c358007778037d5b15480987dc2860eef1b7bad37cb21d7
C
7086012c2d0569d5938830926b19fbea0d46682a983e04e52924978e8720c2f8
Android
89962b186707828b06b0c9f50c010b2f4cefd6a8e7ca9bdefb616bbbf6e739c8
获取“ApiGateway-cpp-sdk.zip”压缩包,解压后目录结构如下:
名称 |
说明 |
---|---|
hasher.cpp |
SDK代码 |
hasher.h |
|
header.h |
|
RequestParams.cpp |
|
RequestParams.h |
|
signer.cpp |
|
signer.h |
|
Makefile |
Makefile文件 |
main.cpp |
示例代码 |
调用API示例
- 在main.cpp中加入以下引用。
1 2 3 4 5
#include <stdio.h> #include <stdlib.h> #include <string.h> #include <curl/curl.h> #include "signer.h"
- 生成一个新的Signer, 填入AppKey和AppSecret。
1 2 3 4 5
// 认证用的ak和sk编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全; // 本示例以ak和sk保存在环境变量中来实现身份验证为例,运行本示例前请先在本地环境中设置环境变量SDK_AK和SDK_SK。 char* ak = getenv("SDK_AK"); char* sk = getenv("SDK_SK"); Signer signer(ak, sk);
- 生成一个新的RequestParams,指定方法名、域名、请求uri、查询字符串和body。
1 2
RequestParams* request = new RequestParams("POST", "{apig-endpoint}", "/app1", "Action=ListUsers&Version=2010-05-08", "demo");
- 给请求添加header头,内容为具体参数数据。如果有需要,添加需要签名的其他头域。
1 2
request->addHeader("x-stage", "RELEASE"); request->addHeader("name","value");
- 进行签名,执行此函数会将生成的签名头加入request变量中。然后为请求添加x-Authorization头,值与Authorization头相同。
1 2 3 4 5 6
signer.createSignature(request); for (auto header : *request->getHeaders()) { if( strcmp(header.getKey().data(), "Authorization") == 0){ request->addHeader("x-Authorization", header.getValue()); } }
- 使用curl库访问API,查看访问结果。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72
static size_t WriteMemoryCallback(void *contents, size_t size, size_t nmemb, void *userp) { size_t realsize = size * nmemb; struct MemoryStruct *mem = (struct MemoryStruct *)userp; mem->memory = (char*)realloc(mem->memory, mem->size + realsize + 1); if (mem->memory == NULL) { /* out of memory! */ printf("not enough memory (realloc returned NULL)\n"); return 0; } memcpy(&(mem->memory[mem->size]), contents, realsize); mem->size += realsize; mem->memory[mem->size] = 0; return realsize; } //send http request using curl library int perform_request(RequestParams* request) { CURL *curl; CURLcode res; struct MemoryStruct resp_header; resp_header.memory = (char*)malloc(1); resp_header.size = 0; struct MemoryStruct resp_body; resp_body.memory = (char*)malloc(1); resp_body.size = 0; curl_global_init(CURL_GLOBAL_ALL); curl = curl_easy_init(); curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, request->getMethod().c_str()); std::string url = "http://" + request->getHost() + request->getUri() + "?" + request->getQueryParams(); curl_easy_setopt(curl, CURLOPT_URL, url.c_str()); struct curl_slist *chunk = NULL; std::set<Header>::iterator it; for (auto header : *request->getHeaders()) { std::string headerEntry = header.getKey() + ": " + header.getValue(); printf("%s\n", headerEntry.c_str()); chunk = curl_slist_append(chunk, headerEntry.c_str()); } printf("-------------\n"); curl_easy_setopt(curl, CURLOPT_HTTPHEADER, chunk); curl_easy_setopt(curl, CURLOPT_COPYPOSTFIELDS, request->getPayload().c_str()); curl_easy_setopt(curl, CURLOPT_NOBODY, 0L); curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteMemoryCallback); curl_easy_setopt(curl, CURLOPT_HEADERDATA, (void *)&resp_header); curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *)&resp_body); //curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L); res = curl_easy_perform(curl); if (res != CURLE_OK) { fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res)); } else { long status; curl_easy_getinfo(curl, CURLINFO_HTTP_CODE, &status); printf("status %d\n", status); printf(resp_header.memory); printf(resp_body.memory); } free(resp_header.memory); free(resp_body.memory); curl_easy_cleanup(curl); curl_global_cleanup(); return 0; }
- 运行make命令编译,得到可执行文件main,执行main文件,查看结果。