跳到主要内容

项目

项目是什么

项目是柚卡中最外层的业务隔离单元。你可以把一个项目理解为:

  • 一个接入应用
  • 一个部署环境
  • 一个租户
  • 一个品牌或一个产品线

项目之间的数据互相隔离。

一个项目通常包含什么

每个项目都有自己独立的:

  • 客户
  • 功能
  • 套餐
  • 卡密
  • API Key

因此,接入时通常建议:

  • 生产环境单独一个项目
  • 测试环境单独一个项目
  • 不同业务线尽量分开项目

项目与 API Key 的关系

每个 API Key 都属于某个项目。第三方应用带着该 API Key 调用公开 API 时,请求会自动落在对应项目下。

这意味着:

  • 不需要在公开 API 请求体里额外传 projectId
  • 同一个用户名在不同项目中互不影响

接入时最常关注的项目设置

自动创建客户

如果项目开启“兑换时自动创建客户”,客户在兑换卡密时即使还不存在,也可以自动开通。

这对“先激活后补资料”或“客户端直接输入卡密”的场景很有用。