使用您的API密钥及合作伙伴代码-AccuWeatherAPI.PDF

感谢您选择AccuWeather API ！遵循以下简单步骤即可开始使用。 使用您的API 密钥及合作伙伴代码 您的API 密钥 您的销售代表会向您提供一个API 密钥。您一定要确定拥有的是DEMO API 密钥还是生产就绪API 密钥。  主机名 仅用于DEMO 周期和开发用途  主机名 仅用于生产，包括实时显示 您的合作伙伴代码 如果您与 AccuWeather 签定利润分配协议，公司还将为您提供一个合作伙伴代码。您的合作伙伴 代码即您的客户端 ID 。您务必要正确使用该合作伙伴代码。合作伙伴代码需要追加至将返回到 AccuWeather 网站的深层链接，以跟踪我们站点的流量，实现准确的利润分配。 理解深层链接 大多数 API 响应包含参数“Link”和“MobileLink”。这些是连接至AccuWeather 网站和移动站点 的深层链接。API 查询字符串中请求的语言、内容、位置和单位将反映在此类深层链接中。 追加您的合作伙伴代码至深层链接 如果您的产品已与我们的网站建立链接，您必须将您的合作伙伴代码追加至通过 API 返回的深层 链接。 示例1：获取深层链接并追加合作伙伴代码至URL 查询字符串 API 调用： /currentconditions/v1/335315.json?apikey=apiKey © 2017 AccuWeather, Inc 。保留所有权利。|第1 页，共5 页 API 响应： 如下所示，将您的合作伙伴代码追加至MobileLink 和Link URL 中的查询字符串： MobileLink：/en/us/state-college-pa/16801/current- weather/335315?lang=en-uspartner=yourPartnerCode Link：/en/us/state-college-pa/16801/current-weather/335315?lang=en- uspartner=yourPartnerCode 示例2：获取深层链接并追加合作伙伴代码作为查询字符串中的首个参数 注意：如果 Link 或 MobileLink URL 中没有其他任何查询参数，必须追加合作伙伴代码作为首个参 数。如下方示例中所示，首个查询参数必须冠上“?”。 API 调用： /currentconditions/v1/335315.json?apikey=apiKeylanguage=hi © 2017 AccuWeather, Inc 。保留所有权利。|第2 页，共5 页 API 响应： 如下所示，将您的合作伙伴代码追加作为Link 和MobileLink URL 中的首个查询参数： MobileLink：/hi/us/state-college-pa/16801/current- weather/335315?partner=yourPartnerCode Link：/hi/us/state-college-pa/16801/current- weather/335315?partner=yourPartnerCode 更多示例： 有关如何追加合作伙伴代码至深层链接的更多示例请查阅我们的在线文档： /developers/partner-code 。 （API 文档和链接目前仅提供英文版本） 合作伙伴代码建议： 在深层链接URL 结尾处追加合作伙伴代码。不要在URL 中间位置插入合作伙伴代码。 不要更改深层链接URL 中的位置密钥或其他任何内容。 不要对URL 进行硬编码。在获得您的合作伙伴代码后，将其追加至Link 和MobileLink URL。硬编码 链接可能导致意外问题的发生，因为链接可能由于位置不同发生变化，也可能随时间推移而改变。 © 2017 AccuWeather, Inc 。保留所有权利。|第3 页，共5 页 使用API 步骤一：找到您的位置 通过配合使用您的API 密钥和位置API 搜索具体位置。 示例1：获取“纬度= 40.79 °北和经度= 77.86 °西”的位置密钥 /locations/v1/cities/geoposition/search.json?q=40.79,-77.86apikey=apiKey