🔓
VibeLock_OpenAPI 说明文档

用户7096

9月7日修改

一、VibeLock 简介

VibeLock 是面向 Vibe Coding 时代的 AI 开发者商业化操作系统。

AI 让普通人也能做软件，但没人帮他们商业化——VibeLock 以代码加密授权为入口，为 AI 开发者提供从打包、加密、授权、分发到企业服务的一站式商业化解决方案。几句话讲清楚：加密是钩子，授权是锁定，服务是纵深。​

平台承载三大模块：

•
商家后台：产品/授权/客户/安装包/数据管理​

•
软件商城：客户自助购买/激活/续费​

•
Open API：AI 自动化运维​

✨

VibeLock为 AI Agent 生态中的产品提供商业化授权、防盗版和计量计费能力。通过 VibeLock，保护知识产权，实现商业化变现。​

官网地址：

https://lock.pandlee.cn/

API 基础 URL：https://lock.pandlee.cn:8088（注意：API 走 8088 端口，443 端口不提供 API）

VibeLock 提供以下核心能力：

•
产品管理：创建和管理软件产品，定义功能点、授权版本和商城规格​

•
授权管理：生成激活码，管理授权生命周期（激活、续期、吊销）​

•
商城分发：将产品发布到 VibeLock 商城，触达更多用户​

•
遥测数据：定义 Schema 并接收 Skill 自动埋点上报的数据​

•
Credit 体系：基于 Credit 消耗的计费模式，按授权操作扣除 Credit​

•
Open API：提供完整的 RESTful API，支持商家通过 API 自动化管理产品和授权​

•
客户端 SDK API：提供激活、心跳、自动更新、遥测上报等客户端集成接口​

1.1 API 分类说明

VibeLock 提供两类 API，分别面向不同场景：

API 类别

路径前缀

说明

商家 Open API

/open/v1/*

面向商家后台操作，需 X-Api-Token 鉴权，用于产品、授权、Credit 等管理​

客户端 SDK API

/api/*

面向软件产品的客户端集成，免登或凭激活码鉴权，用于激活、心跳、更新、遥测等​

1.2 Open API 概述

VibeLock Open API 允许商家通过程序化方式管理产品、授权和业务数据。所有 API 均基于 RESTful 风格设计，使用 JSON 格式进行数据交换。​

API 基础信息：

•

基础 URL：https://lock.pandlee.cn:8088

•
Open API 路径：/open/v1​

•
请求格式：JSON（Content-Type: application/json）​

•
响应格式：JSON​

•
鉴权方式：X-Api-Token 请求头​

•
字符编码：UTF-8​

💡

新手提示：本文档中所有示例的 https://api.example.com 请替换为实际 API 基础 URL https://lock.pandlee.cn:8088。例如 3.3.1 GET /open/v1/profile 的完整 URL 为 https://lock.pandlee.cn:8088/open/v1/profile。

二、如何获取后台 API Token

API Token 是调用 VibeLock Open API（/open/v1/*）的凭证，每个商家可以创建多个 Token，分别设置不同的权限范围和有效期。​

2.1 创建 API Token

登录 VibeLock 商家后台后，在 API Token 管理 页面创建新的 Token：​

1.
进入商家后台，导航到 API Token 管理页面​

2.
点击 创建 Token 按钮​

3.
填写以下信息：​
◦
Token 名称：给 Token 起一个易于识别的名称​
◦
权限范围（Scope）：​
▪
readonly — 只读权限，仅允许 GET 请求​
▪
readwrite — 读写权限，允许所有类型的请求（GET/POST/PUT/DELETE）​
◦
有效期（天）：设置 Token 的有效天数，0 表示永久有效​