系统API
本文整理智简魔方财务系统中“系统 API”相关的配置、操作或问题处理内容，供管理员和运维人员按原文步骤查阅与执行。
魔方财务对接 API
一、前言
每套魔方财务都可对外提供 API 能力，允许您的客户进行自动化对接，使用 api 销售或管理在系统中订购的产品
您可用于
①引导您的客户开发，对接到公司内部系统，实现在内部系统中管理资源
②引导您的客户开发，对接到公司 CRM，实现直接在公司内部系统中购买资源
③引导您的代理商开发，对接到他们的会员系统，实现客户在他们的会员系统下单后自动下单至您的系统进行交付
④与使用魔方财务的客户进行对接，代理其他魔方财务的产品
⑤与使用魔方财务的客户对接，让他们代理您的产品
魔方财务即可做代理商，又可做供应商，支持无限代理。
二、为客户提供 API 接口，让别人代理您的产品
开启 API 功能
您可前往【魔方财务后台-系统-常规设置-API】，点击开启【资源 API】
引导客户获取 API
客户通过访问您的系统网站，注册一个账户后，在【安全中心-API】点击【查看密钥】即可获得。
三、对接魔方财务，代理对方产品
前往会员中心获取 API
代理商通过访问上游系统网站，注册一个账户后，在【安全中心-API】点击【查看密钥】即可获得。
对接上游
代理商获得 api 密钥后，前往您自己的财务系统后台，在【资源-魔方财务 API】点击【添加 api】
- **名称：**自定义 建议填写上游的公司名称，便于查看。
- **接口地址（ip 或域名）：**上游系统的 ip 或域名
- **用户名：**您在上游注册的账号，手机/邮箱
- **密码：**您在上游获取的 api 密钥 【上游前台-安全中心-API】点击【查看密钥】
设置产品
对接成功后状态显示（绿色），即可添加商品，导航至商品，点击【添加商品】
接口设置
- **接口类型：**为魔方财务 api
- **上游：**选择您对应的上游接口，可在步骤 3.2 中查看如何对接。
- **上游产品：**接口选择后，即可将上游所有的产品拉取过来，这时您选择您要对应的上游商品，并点击【同步数据】
定价设置
系统会默认拉取上游商品的定价/周期，代理商这里有两种方案可供选择
- **百分比：**当选择百分比时，默认以上游商品价格的 120%作为销售价格，百分比也可自定义。
- 自定义：可自定义上游已有的周期价格。
注：可配置项价格也是根据定价方案进行设置。
若上游修改了产品定价等信息，下游可点击【同步数据】更新或者会根据自动任务每小时同步一次数据。
四、开始销售
以上设置完成后，您就可以出售您代理的商品了，但还需注意以下事项：
- **开通：**您开通商品时会自动在上游创建订单，并使用余额付款，支付成功后，即可获取产品 ip/用户名/密码等必要信息。
注意：确保您在上游创建的账户有充足的余额，余额不足会导致产品开通失败
- **暂停/解除暂停：**您可以暂停商品并选择暂停原因，若不填，则上游默认显示代理商暂停
- **删除：**您点击删除，会立即将相关信息删除并将状态改为已删除，但上游只会将产品状态设为已取消。
- 购买产品并开通后，产品详情页会记录上游的产品 id。
