针对 IntelliJ IDEA 环境推出 PostIn 插件，版本号1.0.1， PostIn 插件是一个针对 IntelliJ IDEA 环境的工具，集成到 IDEA 侧面板中，便于快速访问，帮助开发人员高效地管理API定义。插件可自动生成 API 文档并一键同步到 PostIn 的项目中。

本节将详细介绍 PostIn 插件下载、安装。

方式1：在 IntelliJ IDEA 中安装 PostIn 插件。打开 IDEA 设置，进入 Plugins（插件）页面，搜索 “PostIn” 并安装 “PostIn” 插件。

方式2：在 Jetbrains Marketplace 中下载后通过本地安装

，打开 IDEA 设置，进入 Plugins（插件）页面，点击Installed右侧的设置按钮，选择"install plugin from disk... "，从磁盘安装插件。

插件仅支持 IntelliJ IDEA 2024.1.7 版本。

安装结束后，在idea右侧侧边栏显示PostIn。

本节将详细介绍 PostIn 插件配置。

进入插件后，显示扫描接口， 上报接口，设置三个按钮。

配置PostIn插件，点击“设置”按钮，进入PostIn插件的配置。

需要配置PostIn服务的URL（注意配置的URL尾部不需要带"/"），以及上报接口的所属空间ID，上报接口的所属空间ID可以在PostIn空间详情。

至此，PostIn上报接口的IDEA插件已全部下载、安装、配置结束。

本节将详细介绍怎么使用PostIn插件上报接口，生成详细的接口文档。

首先需要在接口文件controller 中添加注释，包含接口协议、导入接口文件夹名称、接口地址。

● @pi.protocol：定义了接口的协议。

● @pi.groupName：定义了接口的文件夹名称。

● @pi.path：定义了该接口的基本 URL 路径。

其次，需要在接口前添加接口详细信息的注释，包含接口名称、接口详细URL、请求方式、请求类型、请求参数。通过请求类型的不同，可以分为两种。

● @pi.name：定义了接口的名称。

● @pi.url：和@pi.path共同组成了接口的完整路径，举例接口的完整路径：/workspaceFollow/createWorkspaceFollow

● @pi.methodType：定义了接口请求方式。

● @pi.request-type：定义了接口请求类型。

● @pi.url：和@pi.path共同组成了接口的完整路径，举例接口的完整路径：/workspaceFollow/deleteWorkspaceFollow

注释添加完成后，在PostIn插件点击“扫描接口”按钮，扫描当前项目所有接口。

扫描出接口后，用户可单选、多选或全选接口后提交上报。例如，接口总共有7个，按Ctrl选择其中3个，点击“上传接口”按钮，系统弹出”确认上传接口“二次确认弹窗。

点击“是”，选择的接口上传到PostIn系统。

当接口进行更新之后，还可以利用PostIn插件对接口进行更新。

接口成功上传PostIn后，对接口信息进行修改，只要接口路径（即@pi.path和@pi.url组成的路径）未进行修改，再次上传接口，会对当前接口进行更新。

接口路径（即@pi.path和@pi.url组成的路径）修改之后，再次上传接口，接口会按照新接口进行添加。

上报成功之后，可以在PostIn和 IntelliJ IDEA 环境信息对比。

下图为请求为字段，上报PostIn前后信息对比。

请检查配置的PostIn服务器URL是否正确，注意地址尾部不需要带"/"

PostIn V1.0.8版本发布，IDEA 插件支持一键扫描上报，让接口定义不再繁琐

PostIn是一款开源免费的接口管理工具， 下面介绍私有部署版本的Centos7下安装与配置。私有部署版本更适合有严格数据安全要求的企业，实现对数据和系统的完全控制。

允许自定义端口、数据存放目录、数据库连接、数据库备份策略和统一登录设置，以满足特定个性化需求。

允许用户自定义应用的启动端口，以便在特定网络环境下避免端口冲突或满足其他配置需求。

支持用户自定义数据存放目录的位置，帮助用户根据需要选择存储路径。

支持自定义数据库连接方式，用户可以选择使用内嵌数据库或指定外部数据库地址。根据需求配置数据库连接。

统一登录，即统一使用Soular的用户，部门等，这样配置可以让一个用户同时使用多个应用。需要安装Soular，具体安装详见Soular文档

支持用户使用脚本一键升级，只需要执行应用升级脚本即可。

在安装过程中遇到问题？我们为你准备了详细的文档和教程，帮助你快速解决任何问题。访问 Postin 文档中心，获取详细的配置指南和常见问题解答。如果需要更多帮助，欢迎随时向我们的活跃社区提问！

Centos7下PostIn安装教程

PostIn是一款开源免费的接口管理工具， 下面介绍私有部署版本的Docker下安装与配置。私有部署版本更适合有严格数据安全要求的企业，实现对数据和系统的完全控制。 ﻿

允许自定义端口、数据存放目录、数据库连接和统一登录设置，以满足特定个性化需求。

Docker下PostIn安装教程

PostIn是一款开源免费的接口管理工具， 下面介绍私有部署版本的Windows下安装与配置。私有部署版本更适合有严格数据安全要求的企业，实现对数据和系统的完全控制。 ﻿

在安装过程中遇到问题？我们为你准备了详细的文档和教程，帮助你快速解决任何问题。访问 PostIn 文档中心，获取详细的配置指南和常见问题解答。如果需要更多帮助，欢迎随时向我们的活跃社区提问！

Windows下PostIn安装教程

PostIn是一款开源免费的接口管理工具， 下面介绍私有部署版本的MacOS下安装与配置。私有部署版本更适合有严格数据安全要求的企业，实现对数据和系统的完全控制。 ﻿

MacOS下PostIn安装教程

PostIn是一款开源免费的API接口管理工具，能够帮助开发团队更好地组织和管理API接口资源。本文将指导你如何创建和管理你的第一个空间。

创建空间可以帮助开发团队有效地集中管理项目相关的接口资源，使得团队成员能够快速查找和使用所需的 API 信息。

展示了所有已创建的空间，包括每个空间的关键信息。用户可以在此界面进行添加、筛选和管理操作，以便快速找到所需的空间并进行相应的管理。

     最近访问，方便用户快速定位和打开常用项目，提升使用效率。

     在每个空间项中显示关键信息，例如空间名称、负责人、可见范围等。

允许用户轻松访问和管理已创建的空间的详细信息，便于组织和分类 API 接口及相关文档，从而提升团队的协作效率和资源管理能力。

空间概况提供当前空间内接口的状态统计、趋势分析和最新动态，帮助团队实时监控接口运行情况，并优化项目管理。

PostIn 提供全面的接口管理功能，包括设计、调试、文档生成和Mock等功能，支持 HTTP 和 WebSocket 协议，帮助开发者高效管理和测试 API 接口。

接口设计通过设置基础信息、请求和输出结果的参数，来构造当前接口的具体使用方式。支持多种协议，包括 HTTP 和 WebSocket，灵活适应不同应用需求。

HTTP 协议设计涵盖了基础信息、请求参数和响应结果的设计

WebSocket 协议设计涵盖了基础信息、请求参数的设计

接口文档基于接口设计自动生成，确保接口信息实时更新，便于团队随时查阅和对接，支持 HTTP 和 WebSocket 协议，方便共享给其他开发者或团队成员

接口调试功能，基于接口设计自动生成数据，支持 HTTP 和 WebSocket 协议，帮助开发者快速验证和调试 API 接口

Postin 提供内置的 HTTP 协议 MOCK 数据生成功能，支持前端在后端未完成时进行独立开发和测试，减少依赖，提升开发效率。

PostIn 提供快速便捷的接口调试功能，与接口管理中的接口区别在于需要手动输入参数，用于临时测试不需要管理的接口。支持 HTTP 和 WebSocket 协议，帮助开发者验证 API 接口的功能和行为，确保接口按预期工作。

模型提供可复用的数据定义和管理功能，确保数据一致性，并提升开发效率和团队协作。通过共享常用数据模型，减少重复工作，加快接口设计和调试进程。

支持多环境配置（如开发、测试、生产），方便开发者在不同环境中灵活调试和验证 API。通过一键切换环境，减少手动配置，确保接口行为一致，提升开发和测试效率。

支持将不同成员添加到指定的项目空间，以便统一管理项目中的相关人员。

权限支持定义不同角色和权限的管理，确保项目成员拥有适当的访问和操作权限，支持灵活的角色分配和权限调整。

允许用户修改空间名称、调整可见范围，以及更新空间描述，帮助团队根据实际需求配置空间设置。

     支持将项目以 HTML 或 PDF 格式导出，方便保存、分享项目文档。

双重校验，删除空间操作不可恢复，请谨慎操作

了解更多关于 PostIn 的信息，请访问以下链接：

PostIn使用教程-创建空间

PostIn是一款开源免费的API接口管理工具， 下面介绍私有部署的安装与配置。私有部署版本更适合有严格数据安全要求的企业，支持在本地或专属服务器上运行，实现对数据和系统的完全控制。私有部署版本支持 Windows、macOS、Linux 和Docker。

私有部署版本支持多种操作系统，包括 Windows、macOS 和 Linux，以及 Docker 容器化部署，方便团队根据自身环境灵活选择安装方式。

支持多种自定义配置选项，以下是一些常见的配置示例：

PostIn安装教程

在接口开发中，团队常常面临接口频繁变更和文档维护困难的问题。主流工具如 Postman 和 Swagger 虽能部分解决这些问题，但仍存在局限性。推荐一款开源免费的 API 管理工具 - Postin ，提供 API 设计、调试、文档生成和 MOCK 数据模拟等一站式解决方案，有效简化了开发流程，提升团队协作效率。

Postin 提供了一系列功能，包括空间管理、接口调试、接口管理和分享管理等，帮助团队高效管理和调试 API 接口，提升协作效率。

空间是 Postin 中最高级别的项目管理单元，用于帮助团队高效地组织和管理 API 资源。它作为一个独立的容器，可以容纳项目的所有 API 接口、文档、测试等资源。

    帮助用户创建和管理不同的项目空间，方便团队根据项目需求组织 API 接口、文档及相关资源，确保项目资源的高效分类和管理。

     支持管理多个环境配置（如开发、测试、生产），便于在不同环境中测试和验证 API。

     提供对可复用数据模型的定义和管理，支持在多个 API 设计和调试过程中使用，确保数据的一致性和准确性。

     提供项目进展和接口使用情况的跟踪，便于数据分析和优化决策。

     便于项目成员的角色和权限分配，确保高效协作。

     自定义项目权限设置，控制成员的操作权限，保障项目安全。

Postin 提供全面的接口管理功能，包括设计、调试、文档生成和Mock等功能，支持 HTTP 和 WebSocket 协议，帮助开发者高效管理和测试 API 接口。

Postin 提供快速便捷的接口调试功能，与接口管理中的接口区别在于需要手动输入参数，用于临时测试不需要管理的接口。支持 HTTP 和 WebSocket 协议，帮助开发者验证 API 接口的功能和行为，确保接口按预期工作。

   用于管理分享后的接口文档，方便团队成员和外部开发者快速获取所需信息，促进协作。

Postin 的优势包括简洁的界面，私有部署一键安装，开源免费，支持多版本和多终端使用，保障数据安全和可靠性，具备强大的系统集成功能，满足不同开发团队的需求

界面简洁，上手简单，支持一键式安装配置。

     直观的界面设计，结构清晰，让用户可以快速找到所需的功能模块。

     私有部署支持一键安装，安装后即刻可用，无需额外配置。

提供多层级权限控制、日志审计和备份与恢复功能，确保数据安全和操作透明，防止未经授权的访问和数据丢失。

     通过应用级、系统级和项目级权限管理，确保不同角色和成员在不同层次上获得恰当的访问权限，从而保障项目的安全性。

      支持导入Postman、Swagger 和 OpenAPI 接口文档，实现与主流工具的无缝集成，简化接口管理流程。

      集成到 TikLab 全家桶生态中的 TestHubo 产品，实现测试与接口管理的无缝协作。

支持不同版本的部署，可在多个平台和设备上使用，确保灵活性和兼容性，满足多样化的开发需求。