Download the PHP package caobowen/kimi-nexus without Composer
On this page you can find all versions of the php package caobowen/kimi-nexus. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download caobowen/kimi-nexus
More information about caobowen/kimi-nexus
Files in caobowen/kimi-nexus
Download caobowen/kimi-nexus
More information about caobowen/kimi-nexus
Files in caobowen/kimi-nexus
Vendor caobowen
Package kimi-nexus
Short Description A reusable Composer package for integrating multiple third-party APIs across company projects.
License MIT
Homepage https://github.com/MIEPayOpenSource/kimi-nexus
Package kimi-nexus
Short Description A reusable Composer package for integrating multiple third-party APIs across company projects.
License MIT
Homepage https://github.com/MIEPayOpenSource/kimi-nexus
Please rate this library. Is it a good library?
Informations about the package kimi-nexus
Kimi Nexus
Kimi Nexus 是一个用于公司内部多个项目快速对接第三方 API 的 Composer 库。
目标
- 统一 API 对接方式(认证、重试、超时、错误处理)
- 降低新项目接入 API 的重复工作
- 提供可扩展的集成目录结构
安装(作为库开发)
安装(在其他项目中使用)
说明:首次发布前可先使用 dev-main。
目录结构
src/Core: 通用能力(配置、HTTP 客户端、异常)src/Integrations: 各 API 的具体集成实现tests: 测试目录
快速开始(Business.govt.nz)
Business.govt.nz 环境变量
建议在 .env 中配置以下变量。
必填变量:
选填变量:
说明:
BUSINESS_GOVTNZ_PRIMARY_KEY:首选订阅 key(必填)。BUSINESS_GOVTNZ_SECONDARY_KEY:主 key 不可用时的回退 key(可选)。BUSINESS_GOVTNZ_BASE_URI:- 生产环境:
https://api.business.govt.nz/ - Sandbox:
https://api.business.govt.nz/sandbox
- 生产环境:
BUSINESS_GOVTNZ_TIMEOUT:请求超时秒数(默认20)。- NZBN API 认证关键头是
Ocp-Apim-Subscription-Key。 - 若你把 key 放在
ApiConfig第 2 个参数(apiKey)里,BusinessGovtNzGateway会自动兼容映射到Ocp-Apim-Subscription-Key。
Business.govt.nz 调用指引
- 在环境变量中设置 key(至少
BUSINESS_GOVTNZ_PRIMARY_KEY)。 - 根据环境设置
BUSINESS_GOVTNZ_BASE_URI:- 生产:
https://api.business.govt.nz/ - Sandbox:
https://api.business.govt.nz/sandbox
- 生产:
- 用
BusinessGovtNzGateway::make($config)创建客户端。 - 先调用
searchEntitiesByName()检索 NZBN,再调用viewEntityByNzbn()拉实体详情。 - 若返回
401 missing subscription key,优先检查:- key 是否为空
BASE_URI与 key 所属环境是否匹配(生产 key 对生产地址,sandbox key 对 sandbox 地址)
最小调用示例(搜索 + 详情):
已提供的 Business.govt.nz 入口
BusinessGovtNzGateway::make($config): 快速创建客户端入口BusinessGovtNzApiClient::helloWorld($path = '/helloworld'): HelloWorld 本地示例接口(固定返回)BusinessGovtNzApiClient::searchEntitiesByName($searchTerm, $filters = []): 调用GET /{gateway|sandbox}/nzbn/v5/entities进行实体名称搜索BusinessGovtNzApiClient::viewEntityByNzbn($nzbn, $options = []): 调用GET /{gateway|sandbox}/nzbn/v5/entities/{nzbn}获取实体详情
ABN Lookup(Australia ABR)
可选环境变量示例:
说明:ABN_LOOKUP_BASE_URI 建议使用 https://abr.business.gov.au/json/(末尾带 /)。
已提供入口:
AbnLookupGateway::make($config, $guid): 创建 ABN Lookup 客户端AbnLookupApiClient::searchByAbn($abn): 按 ABN 查询AbnLookupApiClient::searchByName($name, $maxResults = 20, $withDetails = false): 按企业名查询
后续建议
- 为每个供应商建立独立目录:
src/Integrations/{Vendor} - 每个集成包含:
Client、DTO、Exception - 新增统一重试策略、日志追踪(trace id)、熔断与限流
All versions of kimi-nexus with dependencies
PHP Build Version
Package Version
The package caobowen/kimi-nexus contains the following files
Loading the files please wait ...