JkyAdapter

QDataV2 吉客云（Jky）数据集成适配器

由 广东轻亿云软件科技有限公司 开发
「轻易云数据集成平台」官方适配器

Python 3.11+ License: AGPL v3 PyPI version CI

功能作用

本适配器用于集成 吉客云开放平台（https://open.jackyun.com/），通过 invoke() 方法可调用吉客云提供的全部 API 接口，包括但不限于：

  • 供应商管理（查询、创建、更新、停用）
  • 订单数据同步
  • 商品信息管理
  • 库存数据查询
  • 客户管理
  • 财务对账
  • 更多 API...

多接口支持

本适配器支持多种接口模式，通过 settings.interface 参数切换：

接口 说明 适用场景
standard（默认） 主接口 标准业务集成
qimen 奇门网关接口 淘系订单对接

统一调用方式

使用 invoke() 方法可调用吉客云平台的任意 API：

# 查询列表
result = await adapter.invoke(
    method="query",
    object_type="oms.trade.fullinfoget",
    params={"pageNo": 1, "pageSize": 100}
)

# 获取单个对象
result = await adapter.invoke(
    method="get",
    object_type="erp.vend.get",
    params={"code": "VENDOR_001"}
)

# 创建对象
result = await adapter.invoke(
    method="create",
    object_type="erp.vend.create.v2",
    data={"code": "NEW_VENDOR", "name": "新供应商", ...}
)

# 更新对象
result = await adapter.invoke(
    method="update",
    object_type="erp.vend.update",
    data={"vendId": "123", "name": "更新后的名称", ...}
)

快速开始

查看 QUICKSTART.md 获取 5 分钟上手指南。

# 安装
pip install qdata-adapter-jky

# 配置环境变量
cp .env.example .env
# 编辑 .env 填入你的 API 凭据

# 运行示例
python examples/quickstart.py

API 文档

认证配置

Standard 接口

环境变量 说明
JKY_APP_KEY 应用密钥
JKY_APP_SECRET 应用密码
JKY_TOKEN 访问令牌
JKY_VERSION API 版本（默认 1.0）

Qimen 接口

环境变量 说明
JKY_QIMEN_HOST 奇门网关地址（默认：https://zci2vl4joy.api.taobao.com/router/qm）
JKY_QIMEN_APP_KEY 奇门 AppKey
JKY_QIMEN_APP_SECRET 奇门 AppSecret
JKY_QIMEN_TARGET_APP_KEY 奇门网关 ERP 应用标识
JKY_QIMEN_JKY_APP_KEY 吉客云开放平台 AppKey
JKY_QIMEN_JKY_APP_SECRET 吉客云开放平台 AppSecret
JKY_QIMEN_CUSTOMER_ID 吉客云客户 ID

Qimen 接口使用示例

import asyncio

from qdata_adapter_jky import JkyAdapter
from qdata_adapter import ConnectorContext


async def main():
    # 配置 Qimen 接口
    context = ConnectorContext(
        connector_id="my-qimen-connector",
        app_software_code="jky",
        base_url="https://zci2vl4joy.api.taobao.com/router/qm",
        auth_config={
            "app_key": "your-qimen-app-key",
            "app_secret": "your-qimen-app-secret",
            "target_app_key": "your-target-app-key",
            "jkyappkey": "your-jky-app-key",
            "jkyappsecret": "your-jky-app-secret",
            "jkycustomerid": "your-customer-id",
        },
        settings={"interface": "qimen"},
    )

    adapter = JkyAdapter(context)

    # 查询订单
    result = await adapter.invoke(
        method="query",
        object_type="jackyun.tradenotsensitiveinfos.list.get",
        params={
            "pageSize": "200",
            "pageIndex": 1,
            "startConsignTime": "2024-01-01 00:00:00",
            "endConsignTime": "2024-01-31 23:59:59",
            "tradeType": "1",
            "fields": "tradeNo,postFee,tradeStatus,goodsDetail"
        }
    )


asyncio.run(main())

接口对比

特性 Standard Qimen
认证方式 Token + Sign 双签名（jkysign + taobao sign）
适用场景 标准业务接口 淘系订单、奇门网关
签名算法 MD5 MD5（双层）
JSON 格式 紧凑 PHP 风格（带空格）

License

AGPL-3.0 © 广东轻亿云软件科技有限公司

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for vincent067 from gravatar.com vincent067

Credits

Author: 广东轻亿云软件科技有限公司

Maintainer: QData Team

License

MIT License (MIT)

Requires

Python >=3.11

Provides Extra

dev docs all

Tags

qdata adapter jky integration qeasy

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qdata_adapter_jky-0.1.1.tar.gz (1.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qdata_adapter_jky-0.1.1-py3-none-any.whl (26.7 kB view details)

Uploaded Python 3

File details

Details for the file qdata_adapter_jky-0.1.1.tar.gz.

File metadata

  • Download URL: qdata_adapter_jky-0.1.1.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for qdata_adapter_jky-0.1.1.tar.gz
Algorithm Hash digest
SHA256 2184b92169ba2ba900384c8648d622bf0112908a1e45e42f4133f1f4e9e45a8d
MD5 944e608fa7e909c1d6b8a37bf8e58b05
BLAKE2b-256 a6af9c20fb7545a2b742ecf552aa06139ee8d848418a75139759582c19ed7c26

See more details on using hashes here.

Provenance

The following attestation bundles were made for qdata_adapter_jky-0.1.1.tar.gz:

Publisher: publish.yml on vincent067/qdata-adapter-jky

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qdata_adapter_jky-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for qdata_adapter_jky-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b3eccae91bf7f4572a64659985fc786f15a47a1b1d23193466f938e5535936ff
MD5 3f57e90659aff527423377db212ed052
BLAKE2b-256 09a552bd36912099a16e35c378c92028302d656c82ae1c31c53b6f8fbdf626bf

See more details on using hashes here.

Provenance

The following attestation bundles were made for qdata_adapter_jky-0.1.1-py3-none-any.whl:

Publisher: publish.yml on vincent067/qdata-adapter-jky

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page