API作成・管理

医療従事者の専門知識を、コードでAPIとして公開しましょう

API基本情報

API名 *

カテゴリ *

説明 *

NPMパッケージ選択

@mecatoncheir パッケージ

📋 テンプレート選択

✅ 動作保証済み VM2サンドボックス環境で完全テスト済みのテンプレート

医療計算API

🏥

BMI計算

体重・身長からBMI値と健康アドバイスを算出

@mecatoncheir/bmi 使用可能

🧠

GAF評価

精神機能の全体的評価スケール

@mecatoncheir/gaf 開発中

カスタムテンプレート

📝

空のテンプレート

基本構造のみ。独自のAPIを一から作成

標準構造使用可能

APIコード (JavaScript)

🖥️ VM2サンドボックス環境動作保証済みテンプレートを使用してください

/**
 * BMI計算API - Mecatoncheir標準テンプレート
 * エンドポイント: POST /api/boxes/execute/:apiId
 * パッケージ: @mecatoncheir/bmi
 *
 * ⚠️ 重要: VM2サンドボックス環境で動作保証済み
 * Express.js形式（req, res）は使用不可
 */

// ==========================================
// 【必須】パッケージインポート
// ==========================================
const { calculateBMI } = require('@mecatoncheir/bmi');

// ==========================================
// 【必須】メイン処理関数
// ==========================================
function main(input) {
    try {
        // 入力バリデーション
        if (!input || typeof input !== 'object') {
            return {
                success: false,
                error: '入力データが無効です',
                code: 'VALIDATION_ERROR',
                timestamp: new Date().toISOString()
            };
        }

        if (!input.weight || !input.height) {
            return {
                success: false,
                error: '体重(weight)と身長(height)が必要です',
                code: 'VALIDATION_ERROR',
                timestamp: new Date().toISOString()
            };
        }

        // データ型の確認と変換
        const weight = parseFloat(input.weight);
        const height = parseFloat(input.height);
        const age = input.age ? parseInt(input.age) : null;

        if (isNaN(weight) || isNaN(height)) {
            return {
                success: false,
                error: '体重と身長は数値である必要があります',
                code: 'VALIDATION_ERROR',
                timestamp: new Date().toISOString()
            };
        }

        if (weight <= 0 || height <= 0) {
            return {
                success: false,
                error: '体重と身長は正の数値である必要があります',
                code: 'VALIDATION_ERROR',
                timestamp: new Date().toISOString()
            };
        }

        // BMI計算実行
        const result = calculateBMI(height, weight);

        // 健康アドバイスの生成
        let advice = `あなたのBMIは${result.bmi}で、${result.category}に分類されます。`;

        if (result.category === '低体重（やせ型）') {
            advice += ' 適度な運動と栄養バランスの良い食事を心がけましょう。';
        } else if (result.category === '普通体重') {
            advice += ' 理想的な体重です。現在の生活習慣を維持しましょう。';
        } else if (result.category.includes('肥満')) {
            advice += ' 食事の見直しと定期的な運動をお勧めします。';
        }

        // 成功レスポンス
        const responseData = {
            bmi: result.bmi,
            category: result.category,
            weight: weight,
            height: height,
            advice: advice
        };

        // 年齢が提供されている場合は追加情報
        if (age && age > 0) {
            responseData.age = age;
            responseData.note = '年齢を考慮したより詳細な健康アドバイスは医師にご相談ください。';
        }

        return {
            success: true,
            data: responseData,
            timestamp: new Date().toISOString()
        };

    } catch (error) {
        return {
            success: false,
            error: 'API処理中にエラーが発生しました: ' + error.message,
            code: 'EXECUTION_ERROR',
            timestamp: new Date().toISOString()
        };
    }
}

// ==========================================
// 【必須】VM2エクスポート
// ==========================================
module.exports = {
    main: main
};

VM2開発ベストプラクティス

必須要件

function main(input)関数の定義
module.exports = { main }でのエクスポート
入力データのバリデーション実装
エラーハンドリング（try-catch）の使用
レスポンスにsuccessフィールドを含める

推奨事項

レスポンスにtimestampを含める
エラーコード（code）の設定
入力データの型変換と値チェック
詳細なエラーメッセージの提供
JSDocコメントでの関数説明

使用禁止

Express.js形式（req, res）
ルーティング定義（app.get等）
@mecatoncheir/bmi以外のパッケージ
非同期処理（async/await）
ファイルシステムアクセス

利用可能パッケージ

@mecatoncheir/bmi - BMI計算ライブラリ
calculateBMI(height, weight)関数
標準JavaScript機能（Math, Date, JSON等）
組み込みオブジェクト（Array, Object等）

💡 開発のコツ

テンプレートから始めて段階的に機能を追加
エラーケースを想定した入力バリデーション
リアルタイム検証でコードの問題を早期発見
テスト機能で動作確認を頻繁に実行

APIテスト

APIコードの動作を確認できます

🚀 インテリジェント実行機能

module.exportsやrequire()を含むコード → Node.js環境で安全に実行
通常のJavaScriptコード → ブラウザ環境で高速実行
コード内容を自動分析して最適な実行環境を選択します

テスト入力 (JSON形式):

{"weight": 70, "height": 175, "age": 30}

テスト結果がここに表示されます

💰 共同負担金プラン選択

APIの使用制限と共同負担金を設定してください。

🔑 APIキー生成・管理

対象アプリケーション APIキーを紐づけるアプリケーションを選択します。初回利用時は「デフォルトアプリケーションを作成」を選択してください。

APIキー名

使用期限

🔗 作成済みAPI

APIを読み込み中...

API作成・管理

API基本情報

NPMパッケージ選択

📋 テンプレート選択

医療計算API

BMI計算

GAF評価

カスタムテンプレート

空のテンプレート

APIコード (JavaScript)

VM2開発ベストプラクティス 非表示

必須要件

推奨事項

使用禁止

利用可能パッケージ

💡 開発のコツ

APIテスト

💰 共同負担金プラン選択

🔑 APIキー生成・管理

既存のAPIキー

🔗 作成済みAPI

API詳細情報

VM2開発ベストプラクティス