使用Connect Card链接连接到客户的数据

通过六个快速步骤,安全地装载来自客户的数据, 甚至不用碰他们的登录凭证.
2022年3月18日

数据集成是每个公司数据管理实践的核心组成部分——无论是将数据移动到数据仓库,还是将数据从一个或多个数据库迁移到另一个. 新巴黎人官方很容易提取, 负载, 并转换您自己的数据, 但是,当涉及到客户数据时,突然就不得不管理凭证了. 处理和管理凭据会带来安全问题, 更不用说在必要时更新凭证的麻烦了.

如果可以避免,客户不希望与生产应用程序和数据库共享敏感凭据. 此外,你也不想为可能的错误处理承担责任.

那么,这个的解是什么? 给他们发送连接卡的链接.

如果你是一个 由新巴黎人官方 客户,您可能已经熟悉连接卡的概念. Connect Cards是一个新巴黎人官方设置表单,可以嵌入到应用程序或门户的UI中. 这样你的客户就可以验证他们的信息源和新巴黎人官方之间的连接, 完全依靠他们自己.

但是如果您没有应用程序或门户呢, 不想在你的账户中增加一个客户, 或者在开发之旅的早期嵌入新巴黎人官方 API,需要尽快获得数据? 这时,生成并发送连接卡的链接就派上用场了. 在本指南, 我将分享6个步骤,帮助您成功地开始构建这个痛点的解决方案, 到最后, 您将确切地知道如何使用Python以编程的方式解决这个问题.

步骤1:创建目标

创建连接卡链接的第一步是在你的新巴黎人官方账户上设置一个目的地. 如果你还没有, 把雪花设定为目的地 (或新巴黎人官方的任何其他 支持的目的地). 一旦你完成了设置, 从连接详细信息选项卡获取目标组ID,如下图所示. 

步骤2:收集身份验证凭据

在您有了目标组ID之后, 你需要收集你的账户API_KEY和API_SECRET,这样新巴黎人官方才能对新巴黎人官方的API提出请求. 这两个可以在你的新巴黎人官方账户的设置部分找到,如下图所示.

步骤3:构建Python文件

一旦你有了证件, 新巴黎人官方可以开始构建一个Python脚本,在需要的时候自动生成连接卡片的链接. 这是一个 链接到回购 新巴黎人官方最终会建造. 请查看并跟进.

新巴黎人官方将从导入一些Python库开始,以使新巴黎人官方的工作更轻松, 设置一些环境变量,这样就不会在代码中暴露凭据, 适当地构造新巴黎人官方的auth头文件.

#!/usr/bin/env python3
 
进口json
进口的要求
从请求.身份验证导入HTTPBasicAuth
进口环境
 
#读取API_KEY和API_SECRET .env文件.
#在和这个文件相同的目录下创建一个.
env =环境.Env ()
环境.Env.read_env ()
API_KEY = env(“API_KEY”)
API_SECRET = env(“API_SECRET”)
 
auth = HTTPBasicAuth(API_KEY, API_SECRET)
 
头= {
   'Authorization': 'Basic ' + API_KEY,
   “内容类型”:“application / json”
}

现在新巴黎人官方已经设置好了对新巴黎人官方的API发出请求, 我将带您浏览完成最终结果所需的每个API请求—到特定Connect Card的链接.

在第一个API请求中, 新巴黎人官方将对新巴黎人官方的API发出请求并解析响应体以收集 连接or_id. 连接or_id用于标识整个新巴黎人官方帐户中的唯一连接器,该帐户可以有许多不同的连接器并行运行.

在第二个API请求中, 新巴黎人官方将做与第一步相同的事情, 而是针对不同的端点来收集 令牌. 令牌被附加到一个预定义的URL方案中,当终端用户在他们的web浏览器中输入链接时,该方案会提示Connect Card体验.

为了使这些请求在连接器和新巴黎人官方之间创建连接, 新巴黎人官方需要创建一个叫做 有效载荷新巴黎人官方的API服务器通信. 一旦服务器验证了新巴黎人官方发送的有效负载, 它将通信回响应数据,即新巴黎人官方在上一段中谈到的连接or_id和令牌.

新巴黎人官方开始以编程方式创建有效负载.

步骤3:创建有效负载

为了创建有效负载,新巴黎人官方需要定义 服务, group_id, 配置 以JSON格式. 要找到连接器的服务名称,请访问新巴黎人官方文档中心 然后单击包含兼容连接器类型的单元格表中的连接器名称. 接下来,找到标题为“服务”的第一个字段—这是新巴黎人官方的服务ID. 您将看到在有效负载中通过键/值对定义的服务.

下一个, 新巴黎人官方将放入在本指南开头收集的group_id,它将把连接器放入目标组中.

最后一步是在JSON有效负载的配置部分命名模式. 命名模式很重要,因为当信息到达目标目的地时, 它需要有一个唯一的标识符来标识它.

一旦新巴黎人官方有了所有这些信息,你的有效载荷应该看起来像下面的物体.

有效载荷= {
   “服务”:“adwords”,
   "group_id": "", #输入group_id
   "配置":{
       “模式”:“cerebro_test”
   }
}

现在新巴黎人官方定义了有效负载, 新巴黎人官方将使用它从新巴黎人官方 API请求新巴黎人官方的连接or_id和令牌.

步骤4:生成连接器ID

为了生成连接器的ID,新巴黎人官方将针对以下端点创建一个POST请求:

发布api.bestiket.com/v1/connectors

看一下下面的Python代码示例,它遍历了POST请求和响应解析. 在下面的代码中,您会注意到有一个' json=有效载荷 '参数. 在程序的这一部分,新巴黎人官方将有效负载传递到请求中,请求被发送到服务器.

#创建外壳连接器
请求响应=.Post (base_url + '连接ors', auth=auth, json=有效载荷).json ()
 
#解析连接or_id
连接or_id =反应(“数据”)(“id”)

向服务器发出请求之后, 新巴黎人官方需要分析它对新巴黎人官方的反应, 特别是查找生成的连接or_id. 新巴黎人官方将发送给新巴黎人官方的连接or_id存储为一个变量,并将其传递给下一个POST请求, 将为连接卡创建唯一令牌.

步骤5:设置令牌

为了生成令牌,新巴黎人官方将针对以下端点发起一个POST请求:

发布api.bestiket.com/v1/connectors/<连接or_id>/连接-card-令牌

看一下下面的Python代码示例,它遍历了POST请求和响应解析. 您将注意到,新巴黎人官方将连接or_id附加到URL以生成此请求.

#创建连接卡标记
response_令牌 =请求.Post (base_url + '连接ors/' + 连接or_id +
   '/' + '连接-card-令牌', auth=auth, json=有效载荷).json ()
 
#解析连接器标记
令牌= response_令牌(“令牌”)

类似于步骤4, 新巴黎人官方需要解析新巴黎人官方的API响应,以找到生成的令牌. 新巴黎人官方将发送给新巴黎人官方的令牌存储为一个变量,并使用它生成到Connect Card的链接.

步骤六:生成链路

现在新巴黎人官方已经生成了令牌,新巴黎人官方需要将它附加到新巴黎人官方提供的URL中 文档. 将它添加到URL后,新巴黎人官方需要执行生成链接的最后一步. 为了做到这一点,新巴黎人官方将打印到终端的链接,这样你就可以复制和粘贴到任何你想要的通信媒体.

#生成连接卡链接
打印(http://bestiket.com/连接-card/setup?redirect_uri = bestiket.com&auth = ' +令牌)

你完成的URL看起来像这样:

http://bestiket.com/连接-card/setup?redirect_uri = bestiket.com&auth = eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJkIjp7ImxvZ2luIjp0cnVlLCJ2ZXJpZmljYXRpb24iOmZhbHNlLCJyZXNldCI6ZmFsc2UsImpvaW4iOmZhbHNlLCJiYWNrc3RhZ2UiOmZhbHNlLCJ1c2VyIjoibGl0ZXJfaW50ZWd1bWVudCIsImFjY291bnQiOiIxazU2YzJjNHhsdGk2X2FjYyIsImdyb3VwIjoid2FkX2NyZXdtYXRlIiwiY29ubmVjdG9yIjoicG9saXNoaW5nX2hlYWQiLCJtZXRob2QiOiJQYmZDYXJkIiwiYmFja3N0YWdlUmVkaXJlY3Rpb24iOmZhbHNlLCJiYWNrc3RhZ2VWaXJ0dWFsTWVtYmVyc2hpcCI6ZmFsc2UsImlkZW50aXR5IjpmYWxzZX0sImlhdCI6MTY0Njc4MjAxOX0.GwupIZSXzUfxSqUuXqRF1RDeRp9dbqRo——HO3GgVKZM

祝贺您,您现在可以通过Connect Card载入数据了! 通过电子邮件、Slack或其他任何你喜欢的通信媒介发送给你的客户.

当客户单击链接时, 他们将被赠送一张新巴黎人官方 Connect卡, 哪些将使他们能够对连接器进行身份验证, 完全依靠他们自己, 不跟你分享证书.

欲了解更多信息,请查看 GitHub库 它有新巴黎人官方刚刚讲过的示例代码,你可以简单地复制, 粘贴和编辑您独特的用例.

了解更多原因 由新巴黎人官方 用户将数据连接到应用程序的最简单方式是什么. 

开始免费

加入使用新巴黎人官方来集中和转换数据的数千家公司.

谢谢你!! 您的投稿已收到!
哦! 提交表单时出错了.