Legitmark API Platform Documentation

概要

Legitmark は4レベルの階層分類システムを使用しています。各レベルが認証要件とサービス選択を決定します： 階層レベル：

レベル 1：カテゴリ（必須）- 広範な製品分類
レベル 2：タイプ（必須）- 具体的な製品サブカテゴリ
レベル 3：ブランド（オプション）- メーカーまたはデザイナー
レベル 4：モデル（オプション）- 具体的な製品バリアント

タクソノミーデータの取得

完全なツリー

初期セットアップ用に1回のリクエストですべてを取得： API リファレンス： タクソノミーツリーを取得 - GET /api/v2/categories/tree

const response = await fetch('https://api.legitmark.com/api/v2/categories/tree?active_only=true', {
  headers: { 'Authorization': 'Bearer leo_xxxxxxxxx' }
});
const { data: categories, metadata } = await response.json();

const { data: categories, metadata } = await legitmark.taxonomy.getTree({ activeOnly: true });

console.log(`${metadata.total_categories} categories, ${metadata.total_types} types`);
for (const category of categories) {
  console.log(`${category.name}: ${category.types?.length} types`);
}

タクソノミーツリーにはカテゴリとタイプ（必須）、およびブランドとモデル（オプション）が含まれます。完全なタクソノミー深度に基づいてより具体的な画像要件を取得するために、ブランドとモデルのマッチングを強く推奨します。ブランドとモデルがマッチしない場合、認証に追加の写真が必要になる場合があります。

主要なフィルタリングエンドポイント

その他のエンドポイント

統合アプローチ

当社のタクソノミーを直接使用

ユーザーに Legitmark カテゴリを表示：

const response = await fetch('https://api.legitmark.com/api/v2/categories?active_only=true', {
  headers: { 'Authorization': 'Bearer leo_xxxxxxxxx' }
});
const { data } = await response.json();

data.forEach(category => {
  console.log(category.name); // "バッグ", "シューズ" など
});

const { data: categories } = await legitmark.taxonomy.getCategories();

for (const category of categories) {
  console.log(category.name);
}

選択したタイプのブランドを取得

const response = await fetch(
  `https://api.legitmark.com/api/v2/types/${typeUuid}/brands`,
  { headers: { 'Authorization': 'Bearer leo_xxxxxxxxx' } }
);
const { data: brands } = await response.json();

const { data: brands } = await legitmark.taxonomy.getBrandsForType(typeUuid);

for (const brand of brands) {
  console.log(`${brand.name} (${brand.uuid})`);
}

既存のカテゴリをマッピング

プラットフォームのカテゴリを当社のカテゴリに変換：

const categoryMap = {
  "デザイナーハンドバッグ": "bags-category-uuid",
  "アスレチックシューズ": "shoes-category-uuid"
};

function getLegitmarkCategory(yourCategory) {
  return categoryMap[yourCategory];
}

キャッシュ

パフォーマンス向上のためにタクソノミーデータをキャッシュします。新しいブランドやカテゴリが追加されるため、タクソノミーカタログは時間とともに変化するので、定期的な同期が重要です：

class TaxonomyCache {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.data = null;
    this.lastFetch = null;
  }

  async getTree() {
    const maxAge = 24 * 60 * 60 * 1000; // 24時間
    
    if (this.data && Date.now() - this.lastFetch < maxAge) {
      return this.data;
    }

    const response = await fetch('https://api.legitmark.com/api/v2/categories/tree?active_only=true', {
      headers: { 'Authorization': `Bearer ${this.apiKey}` }
    });
    
    this.data = await response.json();
    this.lastFetch = Date.now();
    
    return this.data;
  }
}

プラットフォームに追加された新しいカテゴリ、ブランド、モデルを取得するために毎日同期してください。

次のステップ

ワークフローを設定 - サービスリクエスト作成から画像アップロードまでのステップバイステッププロセス
ステータスについて学ぶ - サービスリクエストの状態とワークフロー遷移

リアルタイムイベントを購読 - Webhook 通知とステータス更新処理

クイックリファレンス

インタラクティブ API リファレンス - ライブ認証と詳細仕様ですべてのエンドポイントをテスト

​概要

​タクソノミーデータの取得

​完全なツリー

​主要なフィルタリングエンドポイント

​その他のエンドポイント

​統合アプローチ

​当社のタクソノミーを直接使用

​選択したタイプのブランドを取得

​既存のカテゴリをマッピング

​キャッシュ

​次のステップ

​クイックリファレンス

概要

タクソノミーデータの取得

完全なツリー

主要なフィルタリングエンドポイント

その他のエンドポイント

統合アプローチ

当社のタクソノミーを直接使用

選択したタイプのブランドを取得

既存のカテゴリをマッピング

キャッシュ

次のステップ

クイックリファレンス