花生壳开放映射管理API：告别手动配置，轻松实现内网穿透隧道自动化管理

  【天极网IT新闻频道】对于拥有大量内网服务需要对外映射，或希望将内网穿透能力集成至自有运维平台、物联网管理系统的企业与开发者而言，手动登录花生壳客户端或Web控制台逐一创建、修改映射隧道，不仅效率低下，更难以满足自动化运维的需求。

  为了解决这一痛点，花生壳正式开放了映射管理API接口。

  通过这套接口，我们可以完全摆脱对图形界面的依赖，使用代码或脚本自动创建、编辑、删除和查询内网穿透隧道，将花生壳强大的穿透能力无缝集成到您的业务流程中。

  花生壳映射管理API四大核心功能

  ● 创建隧道映射：通过调用API，动态为新部署的设备或服务生成公网访问地址。无论是HTTP/HTTPS网站、TCP端口服务还是UDP应用，均可通过参数一键创建。

  ● 编辑/修改隧道：当内网服务IP地址变更、端口调整或需要切换映射协议时，无需人工干预，系统可直接调用API实时更新隧道配置。

  ● 删除隧道：在服务下线或测试环境销毁时，通过API及时回收公网端口资源，确保资源有效利用与安全合规。

  ● 获取隧道列表与详情：定期巡检或同步状态，通过API拉取账号下所有隧道的当前状态(如连接状态、流量情况、域名地址)，便于集成到您自己的监控大屏中。

  如何调用？

  花生壳API遵循标准的HTTP/HTTPS协议，返回数据格式为通用的JSON，便于各类编程语言(Python, Java, Go, PHP等)快速解析。其经典调用流程如下：

  1、获取身份认证：调用API前，登录花生壳管理平台 ，进入API keys页面，创建一个新的API Key并获取密钥内容，在后续的所有接口请求中，您都需要在请求头(Header)中带上这个通行证。

  基础调用信息如下：

  ● 请求地址 (Base URL)： https://hsk-api.oray.com

  ● 认证方式：在 Header 中添加字段Authorization: apikey 您的秘钥

  2、构建请求参数：根据需求(如创建Web映射或TCP映射)，组装包含内网主机IP、内网端口、映射协议、带宽限制等信息的JSON数据包。

  3、发送请求并解析结果：向指定的API端点发送POST/GET请求，根据返回的HTTP状态码和JSON数据判断操作是否成功，并提取生成的公网访问URL。

  总之，花生壳映射管理API的开放，不仅赋予了开发者极高的灵活性和扩展性，也让内网穿透不再是独立的操作步骤，而是能够变成应用或是工作流的有部分。

  对于追求高效、自动化的现代IT架构而言，这无疑是一项极具价值的效率提升工具。