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
    }
  },
  "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": [ ... ]
}

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

metrics 属性ガイド

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

属性名	意味	単位	例
planned_production_time_sec	計画生産時間（シフト全体の生産時間）	秒	36000
planned_downtime_sec	計画停止時間（休憩・点検など）	秒	1800
loss_time_sec	突発停止損失時間（異常停止など）	秒	30
load_time_sec	負荷時間（生産可能な正味時間）＝計画生産時間−計画停止	秒	34200
run_time_sec	実稼働時間（突発損失を引いた稼働時間）	秒	34170
operating_time_sec	稼働実績時間（run_time と同値）	秒	34170
ideal_cycle_time_sec	理想サイクルタイム（1個あたり最速）	秒	30
ideal_run_time_sec	理論的な必要稼働時間＝理想CT×総生産数	秒	30000
actual_cycle_time_sec	実平均サイクルタイム＝run_time / total_count	秒	34.17
performance_loss_time_sec	性能損失時間（理想より遅い場合は正、速い場合は負で、負値は性能ゲイン）	秒	4170
quality_loss_time_sec	品質損失時間	秒	683.4
total_count	生産総数	個	1000
defect_count	不良数	個	20
good_count	良品数＝total−defect	個	980
keyword	分析対象となる部門や工程など任意の文字列（例: "鋳造ライン"）	文字列	"鋳造ライン"

データ取得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": [ ... ]
}