Longhorn

POST https://longhorn.956.jp/api/v1/oee/oee_shot

{
  "api_key": "YOUR_API_KEY",
  "keyword": "鋳造ライン",
  "oee_parameters": {
    "planned_production_time_sec": 36000,
    "planned_downtime_sec": 1800,
    "loss_time_sec": 30.0,
    "total_count": 1000,
    "defect_count": 20,
    "ideal_cycle_time_sec": 30
  }
}

{
  "success": true,
  "oee_result": {
    "oee": 0.8167,
    "availability": 0.9492,
    "performance": 0.878,
    "quality": 0.98,
    "metrics": {
      "planned_production_time_sec": 36000,
      "planned_downtime_sec": 1800,
      "loss_time_sec": 30.0,
      "load_time_sec": 34200,
      "run_time_sec": 34170.0,
      "operating_time_sec": 34170.0,
      "ideal_cycle_time_sec": 30,
      "ideal_run_time_sec": 30000,
      "actual_cycle_time_sec": 34.17,
      "performance_loss_time_sec": 4170.0,
      "quality_loss_time_sec": 683.4,
      "total_count": 1000,
      "defect_count": 20,
      "good_count": 980
    }
  },
  "diagnosis": {
    "engine": "foreman",
    "engine_label": "工場長診断",
    "headline": "性能ロスが主因。「非計画停止をなくす」と OEE は 81.7% → 84.2%（+2.5pt）。",
    "primary_loss": "performance",
    "levers": [
      { "id": "zero_stops", "label": "非計画停止をなくす", "delta_pt": 2.5, "predicted_pct": 84.2 }
    ]
  },
  "message": "OEE shot analysis completed successfully (from Longhorn)."
}

セット分析

エンドポイント

POST https://longhorn.956.jp/api/v1/oee/oee_set

リクエストボディ例

{
  "api_key": "YOUR_API_KEY",
  "keyword": "鋳造ライン",
  "daily_data": [
      {
        "date": "2025-11-10",
        "planned_production_time_sec": 34200,
        "planned_downtime_sec": 5400,
        "loss_time_sec": 0,
        "ideal_cycle_time_sec": 30.0,
        "total_count": 1000,
        "defect_count": 20
      },
      {
        "date": "2025-11-11",
        "planned_production_time_sec": 34200,
        "planned_downtime_sec": 5400,
        "loss_time_sec": 0,
        "ideal_cycle_time_sec": 30.0,
        "total_count": 1000,
        "defect_count": 20
      }
    ]
}

レスポンスボディ例

{
  "success": true,
  "keyword": "鋳造ライン",
  "aggregated_oee_result": { ... },
  "daily_results": [ ... ],
  "diagnosis": { "engine": "foreman", "engine_label": "工場長診断", "headline": "...", "primary_loss": "availability" }
}

keyword: 分析対象となる部門や工程など任意の文字列を指定できます（例: "鋳造ライン"）。

metrics 属性ガイド

注意：aggregated_oee_result の metrics は複数日のデータを集計分析したものです。平均値ではありません。

What-if（改善仮定）

ショットと同じ入力に、仮定（不良ゼロ、停止ゼロ、サイクル短縮など）を載せて新しい OEE を返します。履歴には保存しません。有効なサブスクリプションと月次枠の余裕が必要です。シナリオ数に関わらず 1 リクエストです（最大 8 件）。

エンドポイント

POST https://longhorn.956.jp/api/v1/oee/oee_whatif

リクエストボディ例

{
  "api_key": "YOUR_API_KEY",
  "keyword": "鋳造ライン",
  "oee_parameters": {
    "planned_production_time_sec": 36000,
    "planned_downtime_sec": 1800,
    "loss_time_sec": 1800,
    "total_count": 1000,
    "defect_count": 20,
    "ideal_cycle_time_sec": 30
  },
  "scenarios": [
    { "preset": "zero_defects" },
    { "preset": "zero_stops" },
    { "label": "不良半減", "changes": { "defect_count": 10 } }
  ]
}

scenarios を省略すると、 zero_defects / zero_stops / cut_defects_10pct / cycle_minus_5pct を適用します。zero_stops は停止時間をゼロにし、その時間で生産できた個数を上乗せします。cycle_minus_5pct は同じ稼働時間で生産数を5%増やします（性能が既に上限のときは省略）。

レスポンスボディ例

{
  "success": true,
  "keyword": "鋳造ライン",
  "baseline": { "oee": 0.8167, "pct": 81.7, "availability": 0.95, "performance": 0.88, "quality": 0.98 },
  "scenarios": [
    { "id": "zero_defects", "preset": "zero_defects", "label": "不良をゼロにする", "delta_pt": 1.7, "predicted_pct": 83.4, "changes": { "defect_count": 0 } }
  ],
  "message": "OEE what-if completed successfully (from Longhorn)."
}

データ取得API

OEE解析済みデータ（shot / set）を外部システムから取得するためのAPIです。

---

① ショット分析データ取得

POST /oee/retrieve_shot

リクエストボディ

{
  "api_key": "YOUR_API_KEY",
  "keyword": "鋳造ライン",
  "from_time": "2025-11-25T10:30:00",   // 日付と時刻の間にTを挿入
  "count": 50
}

仕様

• created_at の 降順（DESC） で返却
• 指定キーワードがある場合は部分一致検索
• 最新データから過去方向に取得

レスポンス例

{
  "success": true,
  "oee_metrics": [ ... ]
}

---

② セット分析データ取得

POST /oee/retrieve_set

リクエストボディ

{
  "api_key": "YOUR_API_KEY",
  "keyword": "鋳造ライン",
  "from_date": "2025-11-01",
  "until_date": "2025-11-30"
}

仕様

• target_date の 昇順（ASC） で返却
• 日付範囲指定でセット分析結果を取得可能
• 対象期間が未指定の場合は「当月」が自動適用される

レスポンス例

{
  "success": true,
  "oee_metrics": [ ... ]
}

MCP / OpenAPI

Claude や ChatGPT から、REST と同じショット・セット・What-if をツールとして呼び出せます。計算は Longhorn 側です。詳細は MCP 接続ページ と OpenAPI を参照してください。

エンドポイント

POST https://longhorn.956.jp/mcp
GET  https://longhorn.956.jp/openapi.yaml

認証

Authorization: Bearer YOUR_API_KEY または X-API-KEY。REST の JSON api_key も従来どおり有効です。

ツール

• oee_shot ライブOEE + 工場長診断
• oee_set 期間OEE
• oee_whatif 改善仮定
• oee_retrieve_shot ショット履歴（デモキー不可）