Versions Compared

Old Version 28

changes.mady.by.user tuhao

Saved on

compared with

New Version Current

changes.mady.by.user tuhao

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

1、注册账号

Expand
title注册账号

1、可以通过 https://test.birdsystem.com<系统域名>/site/index/register 主动注册一个测试账号

2、也可以通过销售经理主动开设账号

3、注册账号后，会提供对应的 用户名/密码

2、获取 api_key（通用）

Expand
title获取api_key

1、登录到BirdSystem, 测试环境的登录地址是 https://test.birdsystem.com/ 1、登录到系统
2、登录页面后，点击菜单栏 ”设置“ 下的 “个人信息”
3、打开后找到“API秘钥”字样，复制对应的值，用于后续接口对接登录凭证

如下图:

3、获取 company_id（通用）

Expand
title获取company_id

  1. 登录到BirdSystem, 测试环境的登录地址是 https://test.birdsystem.com/ 登录到系统

  2. 登录页面后，点击菜单栏右上角的站点名称

  3. 打开“进入其他站点”对话框，下拉框中显示的是当前用户有权限登录的站点, 站点名称的前两位/三位数字即company_id

如下图:

4、接口基本操作（通用）

Expand
title接口基本操作

BirdSystem API采用 系统API采用 restful风格，通过url的GET, POST, PUT, DELETE可以直接操作相应的对象.

基本使用参考:

建立连接

操作数据

5、对接具体业务接口

Expand
title具体业务接口

完整接口见 API接口文档拆分归类 。 以下是较常用业务接口:

站点信息

站点查询

辅助数据, 用于获取客人开通的全部站点信息。调用其他业务接口需要传company_id, 此接口可以获取到完整的可用的company_id.

邮递服务信息

邮递服务查询

用于获取发货渠道信息。下出库单需要提供出货渠道delivery_service_id, 此接口可以获取到完整的可用的delivery_service_id列表

产品信息

产品创建

产品删除

产品修改

产品查询

产品有效库存获取

用于创建和管理备案产品，以及产品库存。创建入库单(本地发货)和出库单都需要在鸟系统做产品信息备案，对接此接口方便批量备案产品.

入库单

客户发货单-批量创建

用于创建入库单，将产品入库到鸟系统

出库单

1、本地/专线订单

2、代理专线订单

3、FBA订单

订单删除 (通用)

订单修改 (通用)

订单查询 (通用)

用于创建出库单，将产品通过发货渠道发到买家手里

6、生产环境和测试环境

Expand
title生产环境和测试环境

生产环境地址: http://www.birdsystem.com <详询客服和IT技术人员>

api_key: 注册后能在自己账号中找到

company_id: 根据客人业务范围，在站点列表中选择

为了方便客人测试，我们准备了一个数据独立的测试环境，本对接文档中的各个案例，也是在测试环境下的数据

地址: http://test.birdsystem.com <详询客服和IT技术人员>

api_key: 3f25702379f8134cb05b9ab0ce13590c <详询客服和IT技术人员>

company_id: 36 <详询客服和IT技术人员>