商品介绍
产品亮点
产品说明
产品概述：
只需传入IP地址，即可查出该IP地址的地理信息，含如国家、省、市和运营商等，支持IPV4和IPV6，支持全球IP地址查询。
本软件已取得软件著作权登记号：2023SR1489865《基于云市场API交付的IP地址查询软件》。
Aliyun零代码调用平台URL： https://www.zpzzq.com/ali/cmapi00066987.do
使用说明： Aliyun零代码调用平台旨在为非技术背景人员如企业老板、采购经理、产品经理等带来极大便利，使你们能快速、直观地了解API的功能、性能等指标，掌握其核心功能，无需深入技术细节。促进产品团队与技术团队之间的沟通与协作，使双方能更高效地交流想法与需求，共同推动产品快速迭代与优化。降低部门沟通成本，提升企业整体运营效率与创新能力。建议收藏Aliyun零代码调用平台，我们不会保存您AppCode的重要凭证，请注意您浏览器Cookie的安全性，方可放心使用。
请求参数（Query）：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| IP地址 | ip | 是 | String(50) | 27.154.173.127 | IP地址，支持IPV6地址传入 |
成功响应（Json）：
{ "ok": 1, "msg": "查询成功", "ip": "27.154.174.22", "data": [{ "en_simp": "CN", "en_full": "China", "country": "中国", "province": "福建省", "city": "厦门市", "area": "思明区", "areacode": "350203", "isp": "", "owner": "", "lat": "24.44579", "lng": "118.08243" }] } |
成功响应报文解释（Json）：
| 字段名 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| ok | number | 1 | 成功标识：1成功，0失败，-1接口维护 |
| msg | string | 查询成功 | 报文成败描述 |
| ip | string | 27.154.174.22 | 接口查询的IP |
| data | array | [...] | 查询结果数据包 |
| en_simp | string | CN | 国家英文简称 |
| en_full | string | China | 国家英文全称 |
| country | string | 中国 | 国家名称 |
| province | string | 福建省 | 省份 |
| city | string | 厦门市 | 城市 |
| area | string | 思明区 | 区域/县 |
| areacode | string | 350203 | 区域行政代码 |
| isp | string | 运营商 | 运营商 |
| owner | string | IP归属企业 | IP归属企业 |
| lat | string | 24.44579 | 纬度 |
| lng | string | 118.08243 | 经度 |
失败响应（Json）：
{ "ok": 0, "msg": "IP地址格式有误", "ip": "27.154.174.22", "data": [] } |
失败响应报文解释（Json）：
| 字段名 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| ok | number | 0 | 成功标识：1查询成功，0失败（不计费） |
| msg | string | IP地址格式有误 | 报文成败描述 |
常见的失败类型：
| ok | msg | 解决方式 |
|---|---|---|
| 0 | 未传入IP地址 | 请传入IP地址 |
| 0 | 传入IP地址字符串长度超限 | 不得超过50个字符 |
| 0 | IP地址传入有误 | 传入IP地址不符合标准,请检查 |
| 0 | IP地址格式有误 | 传入IP地址不符合标准,请检查 |
| 0 | IP接口维护中，请稍后查询 | 接口维护,稍后再查 |
| 0 | 未传入开发者账号appid | 对接拇指云自研平台才出现：请传入appid开发者账号。 |
| 0 | 传入开发者账号appid字符串长度超限 | 对接拇指云自研平台才出现：appid字符串长度不得超过32个字符。 |
| 0 | 未传入查询时间sendtime | 对接拇指云自研平台才出现：请传入sendtime时间戳。 |
| 0 | 传入查询时间sendtime字符串长度超限 | 对接拇指云自研平台才出现：请检查传入sendtime时间戳的长度。 |
| 0 | 时间戳超时，请重新请求 | 对接拇指云自研平台才出现：传入sendtime时间戳误差不得超过5分钟。 |
| 0 | 未传入签名sign | 对接拇指云自研平台才出现：请传入sign签名结果。 |
| 0 | 传入签名sign字符串长度超限 | 对接拇指云自研平台才出现：请检查传入sign签名的长度。 |
| 0 | 签名校验失败 | 对接拇指云自研平台才出现：请参照平台签名校验流程进行对比调试。 |
| 0 | 存在*字符，视为调试数据。止于当前结果。 | 对接拇指云自研平台才出现：传入的参数值包含*字符，都将视为测试数据，仅用于调试。 |
| 0 | 非法来源 | 禁止将API用于任何形式的攻击行为，请注意。 |
| 0 | appid:XXXXXXX接口已停用 | 对接拇指云自研平台才出现：XXXXXXX开发者已被拇指云停止调用。 |
1、次数扣减规则
阿里云的次数扣减规则基于http响应状态码执行，只有当http响应状态码为200~300范围内时，才会扣减调用次数。对于非200系列的响应状态码，您需要自行处理响应，并获取响应中的JSON数据。http响应状态码对照表请参考https://help.aliyun.com/document_detail/43906.html
若调用成功，返回的JSON数据包中的“OK”字段值为1，且http响应状态码为200。在这种情况下，阿里云会进行计费。
若调用失败，返回的JSON数据包中的“OK”字段值可能为0或其他非1的值，失败的具体原因会在“msg”字段中描述。此时http响应状态码被设置为666，阿里云不会对此次调用进行计费。
当调用次数用尽时，返回http响应状态码403，并附带消息“Quota Exhausted”。此时您只需续费即可恢复正常使用。
2、请求参数合法和准确性
① 开发者在使用API进行数据处理时，保证数据的准确性和完整性，不得进行任何篡改或伪造数据的行为。
② 在使用API的过程中，开发者应采取必要的安全措施，确保数据不被未授权访问或泄露，保障数据安全。
③ 开发者使用该接口时，确保遵守所有相关法律法规，不得将其用于任何非法或侵犯他人隐私的行为。
④ 开发者应定期对API的使用情况进行审计，确保使用行为始终符合规定要求，并进行必要的调整和改进。
⑤ 开发者不得将API用于任何形式的攻击行为，包括但不限于网络攻击、数据洪峰等。
⑥ 本接口适用于市场调研、商业合作、风险评估等多种场景，开发者可以根据实际需求合理使用。
⑦ 如发现API存在安全漏洞或潜在风险，开发者应立即停止使用并通知我们进行处理。
⑧ 开发者在使用API时，应尊重并保护我们的知识产权，不进行任何侵犯版权、商标等合法权益的行为。
1、消息提醒设置
您可以通过【消息中心·基本接收管理】https://notifications.console.aliyun.com/#/subscribeMsg进行相应设置，以避免因次数耗尽而影响业务运行。
2、发票开具与申请
您可以通过【费用与成本·发票管理】https://usercenter2.aliyun.com/invoice/create-by-detail/aliyun进行发票申请。我们将为您提供数电发票，支持普通电子发票和电子专票的开具。
3、开发密钥查看
您可以通过【已购买的服务】https://market.console.aliyun.com/imageconsole/index.htm 中对应我们的产品，查看AppKey/AppSecret或appCode。该界面您还可以查阅调用量、到期时间等概要信息。
4、服务热线
有任何疑问或建议，欢迎拨打服务热线：4009030002 转16250，我们的服务时间为：工作日09:00-18:00。
产品参数
| 交付方式 | API |
| 开票主体 | 拇指云(厦门)软件有限公司 |
| 所属类目 | 应用开发 |
| 上架日期 | 2024-08-02 |
售后支持范围
产品资质
服务商
拇指云(厦门)软件有限公司
- 数据与API
- 专业服务
用户评论
暂无评价