入门
创建您的账户、添加付款方式、获取您的 API 密钥，并首次调用 Listings API。
本指南介绍如何创建账户、获取您的第一个 API 密钥，以及向 Listings API 发送请求。
1. 创建您的账户
在定价页面选择套餐以打开注册表单，然后输入您的名、姓、工作邮箱和公司。您已经有账户了？请直接登录。
2. 添加付款方式
您提交表单后，我们会将您转到支付服务商的页面添加付款卡。您的免费试用会立即开始，并在试用结束时转为您选择的套餐，因此如果您不希望被扣费，请在试用结束前取消。定价常见问题列出了当前的试用时长和套餐限额。
3. 设置您的密码并登录
完成结账后，我们会通过电子邮件向您发送链接，供您设置密码并激活账户。设置密码后，请使用您的邮箱和密码登录，或选择 Email me a sign-in link（通过电子邮件向我发送登录链接），改为接收一次性免密登录链接。
4. 获取您的 API 密钥
您的第一个 API 密钥会在账户创建时自动签发，您可以在控制台的 API Keys 下找到它。要创建另一个密钥，请选择 New key（新建密钥），为其命名，并选择其访问级别（Read（读取）或 Write（写入））。
5. 发送您的第一个请求
为每个请求添加 Authorization 请求头进行身份验证，其值为字面字符串 API （请注意末尾的空格），后接您的密钥：
curl https://listingsapi.com/api/v4/locations \ -H "Authorization: API $LISTINGSAPI_KEY"响应采用嵌套结构，而非直接返回数组：结果位于 data.allLocations 下，每条记录都是一个 edges[].node，而 pageInfo 包含分页游标和总数。
{ "data": { "allLocations": { "edges": [ { "cursor": "TG9jYXRpb246MTgwMDI4OQ==", "node": { "id": "TG9jYXRpb246MTgwMDI4OQ==", "databaseId": 1800289, "name": "Jenny Home", "city": "Austin", "stateIso": "TX", "countryIso": "US" } } ], "pageInfo": { "endCursor": "TG9jYXRpb246MTgwMDI4OQ==", "hasNextPage": false, "total": 1 } } }}要获取下一页，请在 pageInfo.hasNextPage 为 true 时，将 pageInfo.endCursor 作为 ?after=… 传回；如果某页返回的 edges 数组为空，也应停止。每个 edge 还包含自己的 cursor，最后一个 edge 的 cursor 就是该页的 endCursor，因此这两个值中的任意一个都可以用作 ?after=。
并非所有列表端点都使用相同的分页方式
上面的 edges / node / pageInfo 结构采用 Relay 游标风格，它只是以下 3 种列表响应形式之一：
- 游标分页（
first、after→edges[].node，以及包含endCursor/hasNextPage的pageInfo）：地点、地点搜索和评价端点（按地点划分的互动和账户汇总）。 - 偏移量分页（
page、perPage→ 一个records数组，以及包含totalRecords、totalPages、hasNextPage、hasPreviousPage的pageInfo）：已连接账户、连接建议、某个地点的帖子、某个地点的批量帖子，以及整个账户范围内的重复商家信息汇总。 - 普通数组，完全不分页：目录端点（子类别、国家和州、套餐站点）以及某个地点的照片。
编写分页循环之前，请先查看该端点自身文档页面上的响应示例；对偏移量分页端点使用游标循环，会读取一个始终不存在的 edges 键。