对于拥有大量内网服务需要对外映射，或希望将内网穿透能力集成至自有运维平台、物联网管理系统的企业与开发者而言，手动登录花生壳客户端或 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）中带上这个通行证。

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

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

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

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