Legitmark API Platform Documentation

概述

Legitmark 为希望在工作流程中以编程方式使用 Legitmark 的合作伙伴提供认证 API。该集成可访问 Legitmark 高度成熟的工作流程、流程和认证服务，通过结构化的工作流程预先收集需求并提供实时结果。

设置

设置组织账户

如果您已有 Legitmark 账户但需要设置为组织，请联系 accounts@legitmark.com 了解详情。如果您还没有账户，他们可以帮助您开始。

创建 API 密钥

前往 开发者设置 创建新的 API 密钥。密钥格式为 leo_xxx，用于认证所有 API 请求。

添加 Webhook 目标地址（可选）

在 开发者设置 中，添加 HTTPS 端点 URL 作为 Webhook 目标地址，以便在鉴定完成、图片被拒绝或请求被取消时接收实时通知。还没有端点？使用 Svix Play 生成一个临时 URL 用于测试。

安装 SDK

npm install legitmark

TypeScript SDK

最快的集成方式是使用官方 TypeScript SDK：

import { Legitmark } from 'legitmark';

const legitmark = new Legitmark('leo_your_api_key');

const { sr } = await legitmark.sr.create({
  service: 'service-uuid',
  item: { category: 'category-uuid', type: 'type-uuid', brand: 'brand-uuid' },
});

await legitmark.images.uploadForSide(sr.uuid, sideUuid, './photo.jpg');
await legitmark.sr.submit(sr.uuid);