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();
タクソノミーツリーにはカテゴリとタイプ（必須）、およびブランドとモデル（オプション）が含まれます。完全なタクソノミー深度に基づいてより具体的な画像要件を取得するために、ブランドとモデルのマッチングを強く推奨します。ブランドとモデルがマッチしない場合、認証に追加の写真が必要になる場合があります。
主要なフィルタリングエンドポイント
その他のエンドポイント
統合アプローチ
当社のタクソノミーを直接使用
ユーザーに 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 response = await fetch(
`https://api.legitmark.com/api/v2/types/${typeUuid}/brands`,
{ headers: { 'Authorization': 'Bearer leo_xxxxxxxxx' } }
);
const { data: brands } = await response.json();
既存のカテゴリをマッピング
プラットフォームのカテゴリを当社のカテゴリに変換：
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;
}
}
次のステップ
- ワークフローを設定 - サービスリクエスト作成から画像アップロードまでのステップバイステッププロセス
- ステータスについて学ぶ - サービスリクエストの状態とワークフロー遷移
クイックリファレンス
