PHPackages                             cherrylu/iotroot - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. cherrylu/iotroot

ActiveLibrary[API Development](/categories/api)

cherrylu/iotroot
================

php version api for iotroot platform which run by 国家物联网标识管理中心

2.0.4(1y ago)06PHP

Since May 23Pushed 11mo ago1 watchersCompare

[ Source](https://github.com/Wimpy-Kid/iotroot)[ Packagist](https://packagist.org/packages/cherrylu/iotroot)[ RSS](/packages/cherrylu-iotroot/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (7)Used By (0)

### 先决条件

[](#先决条件)

- PHP &gt;= 5.3

### 安装

[](#安装)

```
$ composer require cherrylu/iotroot
```

### 使用

[](#使用)

- [初始声明](#declare)
- [编码申请](#ecodeApply)
- [编码下载-获取已审批编码](#ecodeDownload)
- [编码退回-解绑编码](#ecodeRelease)
- [获取模板](#getTemplates)
- [过滤模板字段](#getTemplateItems)
- [产品回传-上传产品](#returnProduct)
- [查询产品审核状态](#productStatus)
- [批次回传-绑定编码](#returnBatch)
- [企业Logo、营业执照数据补录](#tempCompanyData)
- [产品图片数据补录](#tempProductData)

### 初始声明

[](#初始声明)

```
use Cherrylu\iotroot\iotroot;
use Cherrylu\iotroot\encrypter;

$iotroot = new iotroot('input-your-client-id-here', 'input-your-key-here');
```

### 编码申请

[](#编码申请)

```
$res = $iotroot->ecodeApply(1000);
```

### 编码下载-获取已审批编码

[](#编码下载-获取已审批编码)

```
/** string 编码申请(ecodeApply)后返回的文件ID */
$fileId = '123123';
$res = $iotroot->queryEcodes($fileId);
```

### 编码退回-解绑编码

[](#编码退回-解绑编码)

```
/** string 编码下载(queryEcodes)返回的数据中获取 */
$ecodes = '123123';
$res = $iotroot->releaseEcodes($ecodes);
```

### 获取模板

[](#获取模板)

```
$res = $iotroot->queryTemplateInfo();
```

### 过滤模板字段

[](#过滤模板字段)

```
// 获取通用模板数据
$templates = $iotroot->queryTemplateInfo();

// 必填的产品字段
$requiredProductItems = $iotroot->productItemFilter($templates['result'][0]);

// 所有产品字段
$allProductItems = $iotroot->productItemFilter($templates['result'][0], false);

// 必填的非产品字段
$requiredNonProductItems = $iotroot->nonProductItemFilter($templates['result'][0]);

// 所有的非产品字段
$allNonProductItems = $iotroot->nonProductItemFilter($templates['result'][0], false);
```

### 产品回传-上传产品

[](#产品回传-上传产品)

```
/** string 模板ID，从获取模板(queryTemplateInfo)获取 */
$templateId  = '123123';
$productName = '辰砂手串';
$typeNumber  = '4208';
$img         = base64_encode(file_get_contents('img.jpg'));

/** array 产品信息，productItemFilter获取产品信息所需字段 */
$typeList = [
    [
        "type" => "销售企业信息",
        "list" => [
            [ "name" => "统一社会信用代码", "info" => 'test' ],
            [ "name" => "法人信息", "info" => 'test' ],
            [ "name" => "机构地址", "info" => 'test' ],
            [ "name" => "联系方式", "info" => 'test' ],
            [ "name" => "机构名称", "info" => 'test' ],
            [ "name" => "CNAS检测机构", "info" => 'test' ],
            [ "name" => "CMA检测机构", "info" => 'test' ],
        ]
    ],
    [
        "type" => "认证信息",
        "list" => [
            [ "name" => "认证单位", "info" => 'test' ],
            [ "name" => "认证标准", "info" => 'test' ]
        ]
    ],
];
$res = $iotroot->returnProduct($productName, $typeNumber, $templateId, $img, $typeList);
```

### 查询产品审核状态

[](#查询产品审核状态)

```
/** string 产品回传(returnProduct)后返回的returnId */
$returnId = '123123';
$res = $iotroot->queryProductStatus($returnId);
```

### 批次回传-绑定编码

[](#批次回传-绑定编码)

```
/** string 产品审核状态(queryProductStatus)返回的数据中获取 */
$productCode = '123123';

/** array 编码下载(queryEcodes)返回的数据中获取 */
$ecodes = ['123123'];

/** array 从nonProductItemFilter获取所需字段 */
$moduleList = [
    [
        'type' => '监督检查信息',
        'detailList' => [
            ['name' => '检测日期', 'info' => '2023-09-09'],
            ['name' => '产品图片', 'info' => 'https://img.zbtesting.cn/319/2024/0127/ZSJ32401460511-ssdWUF.jpg'],
            ['name' => '检测标准', 'info' => 'CMA'],
            ['name' => '检测员', 'info' => '李四'],
            ['name' => '追溯码', 'info' => '5609'],
            ['name' => '授权签字人', 'info' => '张三'],
            ['name' => '证书编号', 'info' => '10101010101'],
            ['name' => '检测结论', 'info' => '辰砂手串'],
        ]
    ],
    [
        'type' => '检验检测信息',
        'detailList' => [
            [ 'name' => '多色性', 'info' => '未检'],
            [ 'name' => '双折射率', 'info' => '未检'],
            [ 'name' => '折射率', 'info' => '1.53（点测）'],
            [ 'name' => '荧光观察', 'info' => '未检'],
            [ 'name' => '红外光谱', 'info' => '未检'],
            [ 'name' => '紫外可见光谱', 'info' => '未检'],
            [ 'name' => '密度', 'info' => '因绳未测'],
            [ 'name' => '质量', 'info' => '41.16g'],
            [ 'name' => '外观描述', 'info' => '红色'],
            [ 'name' => '光性特征', 'info' => '未检'],
            [ 'name' => '放大检查', 'info' => '粒状结构'],
        ]
    ]
];

$iotroot->ecodeBatchReturn($productCode, $ecodes, $moduleList);
```

### 企业Logo、营业执照数据补录

[](#企业logo营业执照数据补录)

```
/** string 产品回传(returnProduct)后返回的returnId */
$logoBase64 = base64_encode(file_get_contents('logo.jpg')); // 可以为空字符
$licenseBase64 = base64_encode(file_get_contents('license.jpg')); // 可以为空字符
$res = $iotroot->queryProductStatus($logoBase64, $licenseBase64);
```

### 产品图片数据补录

[](#产品图片数据补录)

##### 切勿泄露产品code码，有漏洞可以利用产品code码篡改数据

[](#切勿泄露产品code码有漏洞可以利用产品code码篡改数据)

```
/** string 产品回传(returnProduct)后返回的returnId，也可以通过查看网页上产品列表api返回的数据获取，目前没有api能直接获取所有产品的code */
$productCode = '123123123123';
$imgBase64 = base64_encode(file_get_contents('img.jpg'));
$res = $res = $iotroot->tempProductData($productCode, $imgBase64);
```

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance43

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

6

Last Release

712d ago

Major Versions

0.0.1 → 2.0.02024-06-03

### Community

Maintainers

![](https://www.gravatar.com/avatar/874d2bc621ff736d985a9b624d76301cbaadb5784d6c4a89b42ca0e685a8e50c?d=identicon)[Wimpy-Kid](/maintainers/Wimpy-Kid)

---

Top Contributors

[![Wimpy-Kid](https://avatars.githubusercontent.com/u/22192623?v=4)](https://github.com/Wimpy-Kid "Wimpy-Kid (17 commits)")

### Embed Badge

![Health badge](/badges/cherrylu-iotroot/health.svg)

```
[![Health](https://phpackages.com/badges/cherrylu-iotroot/health.svg)](https://phpackages.com/packages/cherrylu-iotroot)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

265103.1M454](/packages/google-gax)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
