> ## Documentation Index
> Fetch the complete documentation index at: https://docs.legitmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# はじめに

> Legitmark 認証プラットフォームの統合ワークフロー。

## 概要

Legitmark は、ワークフローでプログラム的に Legitmark を使用したいパートナー向けに認証 API を提供しています。この統合により、Legitmark の高度なワークフロー、プロセス、認証サービスにアクセスでき、要件を事前に収集してリアルタイムの結果を提供する構造化されたワークフローを通じて利用できます。

## セットアップ

<Steps>
  <Step title="組織アカウントのセットアップ">
    Legitmark アカウントをお持ちで組織としてセットアップが必要な場合は、[**accounts@legitmark.com**](mailto:accounts@legitmark.com) にお問い合わせください。アカウントをお持ちでない場合も、ご連絡いただければ開始できます。
  </Step>

  <Step title="API キーの作成">
    [**開発者設定**](https://app.legitmark.com/settings/developer) で新しい API キーを作成します。キーの形式は `leo_xxx` で、すべての API リクエストの認証に使用されます。
  </Step>

  <Step title="Webhook 送信先の追加（オプション）">
    [**開発者設定**](https://app.legitmark.com/settings/developer) で、HTTPS エンドポイント URL を Webhook 送信先として追加します。鑑定完了、画像拒否、リクエストキャンセル時にリアルタイム通知を受信できます。

    エンドポイントがまだ準備できていない場合は、[Svix Play](https://play.svix.com/) でテスト用の一時 URL を生成できます。
  </Step>

  <Step title="SDK のインストール">
    ```bash theme={null}
    npm install legitmark
    ```
  </Step>
</Steps>

## TypeScript SDK

最も簡単な統合方法は、公式 [TypeScript SDK](https://github.com/legitmark-eng/legitmark-typescript) を使用することです：

```typescript theme={null}
import { Legitmark } from 'legitmark';

const legitmark = new Legitmark('leo_your_api_key');

// service はオプション - 省略した場合は自動解決
const { sr } = await legitmark.sr.create({
  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);
```

SDK には完全な TypeScript 型、自動リトライ、認証ワークフロー全体の処理が含まれています — [型付き Webhook イベント処理](/ja/webhook-reference/handling)も含まれます。詳細な使用方法については [SDK ドキュメント](https://github.com/legitmark-eng/legitmark-typescript) を参照してください。

## 統合ガイド

<CardGroup cols={2}>
  <Card title="認証" href="/ja/partner/authentication" icon="key">
    API キーの使用、レート制限、セキュリティベストプラクティス
  </Card>

  <Card title="タクソノミー" href="/ja/partner/taxonomy" icon="sitemap">
    Legitmark の分類システムとマッピング戦略の理解
  </Card>

  <Card title="ワークフロー" href="/ja/partner/workflow" icon="arrow-down-arrow-up">
    サービスリクエスト作成から画像アップロードまでのステップバイステッププロセス
  </Card>

  <Card title="ステータス" href="/ja/partner/service-request-states" icon="list-check">
    サービスリクエストの状態とワークフロー遷移
  </Card>
</CardGroup>

## クイックリファレンス

<CardGroup cols={2}>
  <Card title="API リファレンス" href="/api-reference/introduction" icon="code">
    ライブ認証と詳細仕様ですべてのエンドポイントをテスト
  </Card>

  <Card title="Webhook リファレンス" href="/ja/webhook-reference/introduction" icon="webhook">
    リアルタイム webhook 通知とステータス更新処理
  </Card>
</CardGroup>