エキスパートエンタープライズサブスクリプションサービス MACアドレスサービス

概要

MACアドレス検索APIです。IEEE OUI（先頭24bit）等を整理したベンダー情報を、MACアドレスやベンダー名から検索・取得できます。複数条件（AND結合）・ワイルドカード・部分一致に対応し、結果は1件でも複数でも同一形式で返却します。出力形式は JSON／TOML を選択できます。

主な機能

• MACアドレス／OUIからのベンダー情報取得（/maca/{mac}。先頭24bitのOUIで完全一致）
• 複数条件検索（/maca/search。mac・vendor・registry・address を指定でき、複数指定時はAND結合）
• 照合方式の切り替え
  • 完全一致（既定）
  • 部分一致（partial=1 で各条件を %値% 照合）
  • ワイルドカード（値に *〔0文字以上〕／ ?〔1文字〕を含めるとパターン照合。partial より優先）
• MACアドレスの区切り（: - . 空白）を自動除去し、大文字化して先頭OUIで照合
• 出力形式の選択（format=json〔既定〕／toml）
• 返却件数の指定（max。既定・上限とも1000件）
• レスポンスは統一形式（results は常に配列）

API

エンドポイント

メソッド	パス	説明
GET	/maca/{mac}	MACアドレス／OUIから取得（検索と同一形式で返す）
GET	/maca/search	複数条件で検索
GET	/health	ヘルスチェック

パラメータ

検索フィールド（複数指定可・AND結合）:

名前	説明	例
mac	MACアドレス／OUI（先頭24bit・大文字HEX6桁）で照合	mac=E80AB9
vendor	ベンダー名（organization）で照合	vendor=Cisco
registry	レジストリ区分（MA-L／MA-M／MA-S）で照合	registry=MA-L
address	住所（address）で照合	address=San+Jose

照合・共通パラメータ:

名前	説明	例
partial	1 を付けると各条件を部分一致（%値%）で照合	partial=1
max	最大返却件数（既定1000・上限1000）	max=50
format	出力形式。json（既定）／toml	format=toml
cacheSeconds	カスタムキャッシュ期間（秒・0〜31536000）	cacheSeconds=3600

MACアドレス／OUIの許容形式: AA:BB:CC:DD:EE:FF ／ AA-BB-CC-... ／ AABBCC... ／ AABBCC（OUIのみ）。ワイルドカードを含む場合は先頭切り出しを行いません。

リクエスト例

# MACアドレスからベンダー情報を取得
curl "https://maca.expert-g.cloud/maca/AA:BB:CC:DD:EE:FF"

# OUI（先頭24bit）から取得
curl "https://maca.expert-g.cloud/maca/E80AB9"

# ベンダー名の部分一致で検索
curl "https://maca.expert-g.cloud/maca/search?vendor=Apple&partial=1"

# ワイルドカード検索（TOMLで取得）
curl "https://maca.expert-g.cloud/maca/search?vendor=*Cisco*&format=toml"

URL例:

GET https://maca.expert-g.cloud/maca/search?mac=E80AB9*
GET https://maca.expert-g.cloud/maca/search?vendor=Nokia&registry=MA-L

レスポンス例

1件でも複数でも同一形式で返却します。results は常に配列です。

{
  "query": {"mac": "E80AB9"},
  "count": 1,
  "results": [
    {
      "oui": "E80AB9",
      "registry": "MA-L",
      "organization": "Cisco Systems, Inc",
      "address": "..."
    }
  ]
}

format=toml を指定した場合は、count と [[results]]（テーブル配列）で返却します（null値は空文字）。

エラー時は {"error": "..."} を返します（400: 条件不正／形式不正、503: データ未構築）。

ライセンス

本サービスはエキスパートエンタープライズサブスクリプションサービスで提供されます。

• ライセンス詳細: LICENSE

サービス

• エキスパートエンタープライズサブスクリプションサービス

会社情報

• 株式会社エキスパートエンタープライズ
• 株式会社エキスパートソフトウェア