开发文档

快速开始

按照以下步骤，快速开始使用工业互联标识解析平台的API和SDK。

1. 注册账号

首先，您需要在我们的平台上注册一个开发者账号。注册完成后，您将获得API密钥，用于API调用的身份验证。

2. 安装SDK

选择您需要的编程语言SDK进行安装：

// 通过Maven安装
<dependency>
    <groupId>com.example</groupId>
    <artifactId>industrial-resolver-sdk</artifactId>
    <version>1.0.0</version>
</dependency>

pip install industrial-resolver-sdk

npm install industrial-resolver-sdk

3. 进行首次API调用

以下是一个简单的示例，展示如何使用SDK进行标识解析：

// Java 示例
import com.example.industrialresolver.Resolver;

public class QuickStart {
    public static void main(String[] args) {
        // 初始化SDK
        Resolver resolver = new Resolver("YOUR_API_KEY");
        
        // 解析标识
        String identifier = "urn:oid:1.2.3.4.5";
        ResolveResult result = resolver.resolve(identifier);
        
        // 处理结果
        System.out.println("解析结果: " + result.toString());
    }
}

API 参考

我们提供了RESTful API，支持标识编码、解析、数据查询等功能。

认证

所有API请求都需要在HTTP请求头中包含API密钥：

Authorization: Bearer YOUR_API_KEY

主要API端点

SDK 使用指南

我们的SDK封装了底层API调用，提供了更加友好的编程接口。

示例代码

以下是一些常见场景的示例代码，帮助您快速上手。

// 示例代码 - 标识解析
Resolver resolver = new Resolver("YOUR_API_KEY");

// 单个标识解析
String identifier = "urn:oid:1.2.3.4.5";
ResolveResult result = resolver.resolve(identifier);

// 批量标识解析
List<String> identifiers = Arrays.asList(
    "urn:oid:1.2.3.4.5",
    "urn:oid:1.2.3.4.6",
    "urn:oid:1.2.3.4.7"
);
Map<String, ResolveResult> results = resolver.batchResolve(identifiers);

// 示例代码 - 标识注册
Resolver resolver = new Resolver("YOUR_API_KEY");

// 创建标识属性
Map<String, Object> attributes = new HashMap<>();
attributes.put("productName", "智能设备A");
attributes.put("manufacturer", "示例制造商");
attributes.put("productionDate", "2023-06-15");

// 注册新标识
String prefix = "urn:oid:1.2.3.4";
RegisterResult result = resolver.register(prefix, attributes);
String newIdentifier = result.getIdentifier();
System.out.println("新创建的标识: " + newIdentifier);