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);