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 哈希: 3a86f1ba249a00727db506e4075ec9630e6cf74f312bddf6c3901c9d0786f53e CertUtil: -hashfile 命令成功完成。 3a86f1ba249a00727db506e4075ec9630e6cf74f312bddf6c3901c9d0786f53e
对比所下载SDK包的SHA256值和下表中对应语言SDK包的SHA256值。如果一致,则表示下载过程不存在篡改和丢包。
表1 SDK包及对应的SHA256值 不同语言SDK包
SHA256值
Java
3a86f1ba249a00727db506e4075ec9630e6cf74f312bddf6c3901c9d0786f53e
Go
23734867eae2e7ef61427c64aa33aa89512571946f2f43a1a5fef5e801e3129f
Python
57636d8bacc459cab9dc08c70d01ccc42391ace60e6960c4e947566da1dc5d26
C#
e5a3b677f75c28ba3f1e16645d8171f7b6f34a42143f8a32a68bb18719b5e65d
JavaScript
442ac2fcb41d84525dc0139ec3f05d190e4e337cdbcdfdfc82a09d79d2ecd25e
PHP
2cc76bd2ecd48f00899d18b0f76d05ce2623065180f111c3f70ac14ddf0506f3
C++
2a54c3f2486d562ea6af1384eca40b301918bdc02f98bbf2c114f282dc059c00
C
4957556c108e0174d55b4b8d720f296967a9367ca54010792b1b3de039b87363
Android
0fdcc6fd93a68dce5c3e1b8e6370cc9340429cabfb0f268c3f9e5ea05238ae96
获取“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文件,查看结果。