API定義

var _ = API("calculator", func() {
    Title("電卓API")
    Description("シンプルな電卓サービス")
    Version("1.0.0")
})

var _ = API("bookstore", func() {
    // 基本的なAPI情報 - OpenAPIドキュメントで使用
    Title("書店API")
    Description(`現代的な書店管理API。
    
このAPIは以下のエンドポイントを提供します：
- 書籍と在庫の管理
- 注文の処理
- 顧客管理
- 分析とレポート`)
    Version("2.0.0")
    
    // サービス利用規約 - 法的要件と使用条件
    TermsOfService("https://example.com/terms")
    
    // 連絡先情報 - サポートの問い合わせ先
    Contact(func() {
        Name("APIサポート")
        Email("[email protected]")
        URL("https://example.com/support")
    })
    
    // ライセンス情報 - APIの使用方法
    License(func() {
        Name("Apache 2.0")
        URL("https://www.apache.org/licenses/LICENSE-2.0.html")
    })
    
    // ドキュメント - 詳細なガイドとリファレンス
    Docs(func() {
        Description(`包括的なAPIドキュメントには以下が含まれます：
- 入門ガイド
- 認証の詳細
- APIリファレンス
- ベストプラクティス
- サンプルコード`)
        URL("https://example.com/docs")
    })
    
    // サーバー定義 - APIにアクセスできる場所
    Server("production", func() {
        Description("本番サーバー")
        
        // 変数を持つ複数のホスト
        Host("production", func() {
            Description("本番ホスト")
            // URI内の変数は実行時に置き換えられます
            URI("https://{version}.api.example.com")
            URI("grpcs://{version}.grpc.example.com")
            
            // バージョン変数を定義
            Variable("version", String, "APIバージョン", func() {
                Default("v2")
                Enum("v1", "v2")
            })
        })
    })
    
    // テスト用の開発サーバー
    Server("development", func() {
        Description("開発サーバー")
        
        Host("localhost", func() {
            // ローカル開発エンドポイント
            URI("http://localhost:8000")
            URI("grpc://localhost:8080")
        })
    })
})

Title("注文管理API")
Description(`
# 注文管理API

このAPIでは以下が可能です：
- 注文の作成と管理
- 出荷の追跡
- 返品の処理
- 請求書の生成

## レート制限
- 認証済みユーザーは1時間あたり1000リクエスト
- 匿名ユーザーは1時間あたり100リクエスト
`)

Contact(func() {
    Name("APIチーム")
    Email("[email protected]")
    URL("https://example.com/contact")
})

License(func() {
    Name("MIT")
    URL("https://opensource.org/licenses/MIT")
})

Docs(func() {
    Description(`詳細なドキュメントには以下が含まれます：
- APIリファレンス
- 統合ガイド
- ベストプラクティス
- サンプルコード`)
    URL("https://example.com/docs")
})

Server("main", func() {
    Description("メインAPIサーバー")
    
    // 本番ホスト
    Host("production", func() {
        Description("本番エンドポイント")
        // HTTPとgRPCの両方をサポート
        URI("https://api.example.com")
        URI("grpcs://grpc.example.com")
    })
    
    // 変数を持つリージョナルホスト
    Host("regional", func() {
        Description("リージョナルエンドポイント")
        URI("https://{region}.api.example.com")
        
        // リージョン変数を定義
        Variable("region", String, "地理的リージョン", func() {
            Description("APIエンドポイントのAWSリージョン")
            Default("us-east")
            Enum("us-east", "us-west", "eu-central")
        })
    })
})