caobowen/kimi-nexus

A reusable Composer package for integrating multiple third-party APIs across company projects.

Maintainers

Package info

github.com/MIEPayOpenSource/kimi-nexus

pkg:composer/caobowen/kimi-nexus

Statistics

Installs: 6

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

0.2.2 2026-05-15 06:43 UTC

Requires

Requires (Dev)

MIT b7969851d2483d1bdb8ef2428eb0040232a29601

phpapicomposersdkintegration

This package is not auto-updated.

Last update: 2026-05-15 06:45:42 UTC

README

Kimi Nexus 是一个用于公司内部多个项目快速对接第三方 API 的 Composer 库。

目标

  • 统一 API 对接方式（认证、重试、超时、错误处理）
  • 降低新项目接入 API 的重复工作
  • 提供可扩展的集成目录结构

安装（作为库开发）

composer install

安装（在其他项目中使用）

composer require caobowen/kimi-nexus:^0.1

说明：首次发布前可先使用 dev-main。

composer require caobowen/kimi-nexus:dev-main

目录结构

  • src/Core: 通用能力（配置、HTTP 客户端、异常）
  • src/Integrations: 各 API 的具体集成实现
  • tests: 测试目录

快速开始（Business.govt.nz）

<?php

use KimiNexus\Core\ApiConfig;
use KimiNexus\Integrations\BusinessGovtNz\BusinessGovtNzGateway;

$config = new ApiConfig('https://api.business.govt.nz/');

$client = BusinessGovtNzGateway::make($config);

// 示例接口：不发真实 HTTP，请求结果固定返回 helloworld
$result = $client->helloWorld();

var_dump($result);

已提供的 Business.govt.nz 入口

  • BusinessGovtNzGateway::make($config): 快速创建客户端入口
  • BusinessGovtNzApiClient::helloWorld($path = '/helloworld'): HelloWorld 本地示例接口（固定返回）

ABN Lookup（Australia ABR）

可选环境变量示例：

ABN_LOOKUP_BASE_URI=https://abr.business.gov.au/json/
ABN_LOOKUP_GUID=your-abr-guid
ABN_LOOKUP_TIMEOUT=20

说明：ABN_LOOKUP_BASE_URI 建议使用 https://abr.business.gov.au/json/（末尾带 /）。

<?php

use KimiNexus\Core\ApiConfig;
use KimiNexus\Integrations\AbnLookup\AbnLookupGateway;

$baseUri = getenv('ABN_LOOKUP_BASE_URI') ?: 'https://abr.business.gov.au/json/';
$timeout = (float) (getenv('ABN_LOOKUP_TIMEOUT') ?: 20);
$guid = (string) getenv('ABN_LOOKUP_GUID');

$config = new ApiConfig($baseUri, null, $timeout);

$client = AbnLookupGateway::make($config, $guid);

// 1) 按 ABN 查询
$byAbn = $client->searchByAbn('51 824 753 556');

// 2) 按名称模糊查询
$byName = $client->searchByName('COMMONWEALTH BANK', 20, false);

已提供入口：

  • 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）、熔断与限流