介绍

本文档全面概述了泰案联OneDB API。它的目的是帮助开发人员请求和交换车辆和零件数据，用于内部It系统。您必须是泰案联OneDB API客户才能使用此API，并与内部IT解决方案交换数据。

OneDB API允许您以各种方式请求车辆数据，例如VIN搜索、号码搜索和通过制造商>型号>车辆车型树搜索。所有回复都遵循相同的标准，并包含有关您请求的车辆的所有重要信息。OneDB还为您的汽车售后市场需求提供品牌数据。您可以搜索零件号或OE号，并得到回传信息。

使用API不需要特定的编程语言和知识。API是独立于平台和语言的。数据传输和交换是通过RESTful/JSON完成的。

您可以参考如下三部分信息，初步了解如何使用我们的API。同时，如果您想从前端更直观地了解常用搜索流程，可以对比查看我们的中国网页目录（免费使用）：www.tecalliance.cn。

一、查询账号权限：TecDoc API->国家/语言/品牌/产品组/制造商。

二、查询Ktype车型层级（车型参数不到销售款型级别）的数据，搜索路径通常如下：

  1. VIN/Katashiki->车->配件。 VIN到kType / Katashiki到Ktype（输入VIN/Katashiki，输出Ktype）->TecDoc API - 特定车辆的零件搜索请求（输入Ktype ID，输出适配配件）。VIN到Ktype SEA，Katashiki到Ktype SEA适用于中国以外的用户。
  2. 车->配件。 TecDoc API - 使用车辆代码筛选进行车辆搜索（输入Ktype ID，输出Ktype）/ TecDoc API - 使用引擎代码筛选进行车辆搜索（输入引擎代码，输出Ktype）/ TecDoc API - 制造商，车型，车辆的车型树搜索（通过车型树逐步获取Ktype）->TecDoc API - 特定车辆的零件搜索请求（输入Ktype ID，输出适配配件）。
  3. 配件号->配件。 TecDoc API - 零件搜索（所有选项）（articleNumber参数输入零件号 / uid参数输入uid，输出配件），其中uid可从其他函数输出中获取。
  4. 组合筛选->配件。 TecDoc API - 零件搜索（所有选项）（oemNumber参数输入OE号+dataSupplierIds参数输入品牌ID+productGroups参数输入产品组ID+carId及linkageTargetType参数输入Ktype及车辆类型，输出配件）。可单独输入，或组合输入。 或者使用TecDoc API - OE号搜索（输入OE号，输出配件），其中OE号不计空格。
  5. 关联号->配件。 TecDoc API - 零件搜索（所有选项）（searchQuery参数输入配件关联号，输出配件）。其中，D码属于使用代码。
  6. 编号->配件。 TecDoc API - 多号码搜索（模糊搜索）（输入编号，输出配件）。
  7. 多个配件号->配件。 TecDoc API - 多零件号搜索（输入配件号，输出配件）。
  8. 配件->适配车型。 TecDoc API - 零配件适配车型（输入uid，输出配件适配车型）。

三、查询ChinaID（即ShortID）车型层级（车型参数到销售款型级别）的数据，搜索路径通常如下：

  1. VIN->车->配件。 ChinaID API - VIN码搜索（输入VIN，输出ChinaID）-> ChinaID API - 零件搜索（shortId参数输入shortId，输出配件）。
  2. VIN- > OE->配件。 附加内容（输入VIN，输出ShortID->输入ShortID，输出产品组->输入ShortID+产品组，输出OE->输入OE，输出配件）。
  3. 车->配件。 ChinaID API - 车辆号搜索（输入ShortID/ModelId/Ktype，输出ChinaID）/ ChinaID API - 制造商，车型，车辆的车型树搜索（通过车型树逐步获取ChinaID）-> ChinaID API - 零件搜索（shortId参数输入shortId，输出配件）。
  4. 从车开始逐步搜索配件。 ChinaID API - 零件号搜索 - shortID > 产品组 > 品牌 > 零件（输入ShortID，输出产品组->输入ShortID+产品组，输出品牌->输入ShortID+产品组+品牌，输出配件）。
  5. 配件号->配件。 ChinaID API - 零件搜索（articleNumber参数输入零件号/uid参数输入uid，输出配件），其中uid可从其他函数输出中获取。
  6. 组合筛选->配件。 ChinaID API - 零件搜索（dataSupplierIds参数输入品牌ID+productGroups参数输入产品组ID+ShortID参数输入ShortID，输出配件）。可单独输入，或组合输入。
  7. 关联号->配件。 ChinaID API - 零件搜索（searchQuery输入配件关联号，输出配件）。其中，D码属于使用代码。
  8. 配件->适配车型。 ChinaID API - 适配车辆（uid参数输入uid/dataSupplierId参数输入品牌ID/articleNumber输入配件号，输出配件适配车型）。