この記事では、TypeSpec アプリの構築を開始する開発者に最適な学習リソースを提供します。 これらのリソースは、TypeSpec の基礎を理解し、高度な機能を探索し、TypeSpec を開発ワークフローに統合するのに役立ちます。
TypeSpec は 1.0 の一般提供に達し、安定したコア コンポーネントと強化されたコード生成機能を備えた運用対応の API ファースト開発プラットフォームとして成熟度をマークしました。
公式ドキュメント
TypeSpec ドキュメントは、TypeSpec について学習するための主要なリソースです。 これには、TypeSpec の使用を開始するのに役立つ包括的なガイド、API リファレンス、チュートリアルが含まれています。
TypeSpec ブログ
TypeSpec ブログでは、TypeSpec 開発に関するお知らせ、機能の更新、分析情報を提供しています。 ブログを定期的に確認して、新しいリリース、ベスト プラクティス、コミュニティのハイライトについて最新情報を入手してください。
ファースト ステップ ガイド
TypeSpec には、さまざまな開発シナリオ向けの包括的なファースト ステップ ガイドが用意されています。
- REST API 用の TypeSpec の概要 - セットアップ、基本的な構文、モデル、操作、ベスト プラクティスに関する詳細なチュートリアルです。
- OpenAPI のファースト ステップ ガイド - OpenAPI v2 または v3 で API 定義をビルドまたは使用する開発者になじみのある概念を使用した TypeSpec の概要。
TypeSpec プレイグラウンド
TypeSpec Playground は、TypeSpec の構文と機能をリアルタイムで試すことができる対話型の Web ベースのツールです。 すぐにフィードバックと検証が提供され、TypeSpec の学習と導入が容易になります。
言語リファレンス
言語リファレンスでは、TypeSpec の主要な概念、関数、およびモジュールに関する詳細情報を提供します。 TypeSpec の完全な機能と、それらを効果的に使用する方法を理解するために不可欠なリソースです。
TypeSpec for Microsoft 365 Copilot
TypeSpec for Microsoft 365 Copilot は、Microsoft 365 Copilot 用の宣言型エージェントと API プラグインを構築するためのドメイン固有の言語です。 自動マニフェスト生成を使用してタイプ セーフな開発を提供し、カスタムの Copilot 拡張機能を簡単に作成できます。
コミュニティとサポート
TypeSpec コミュニティに参加して、他の開発者とつながり、質問をしたり、エクスペリエンスを共有したりできます。 コミュニティには、エンゲージメントのための複数のチャネルが用意されています。
- Discord - リアルタイムのディスカッションと TypeSpec コミュニティとの直接的な関与。
- GitHub ディスカッション - 質問を投稿し、アイデアを共有し、バグを報告し、Q&A、言語の提案、Show-and-Tell などの整理されたカテゴリでプロジェクトを紹介します。
ビデオ
TypeSpec の動作を確認するビデオをご覧ください。 これらの記録では、API 設計のベスト プラクティス、TypeSpec の機能、実際のユース ケースなど、さまざまなトピックについて説明します。
- TypeSpec を使用した大規模な API - Microsoft による 2024 年のオースティン API サミットで提示された TypeSpec の機能の概要。Microsoft が TypeSpec を大規模に使用する方法を示します。
- TypeSpec 101 - セットアップ、モデリング、操作、応答、認証、バージョン管理、ベスト プラクティスをカバーする包括的なチュートリアル シリーズ。
- TypeSpec を使用したスキーマ優先の API 設計 - TypeSpec を使用 したスキーマ優先の API 設計原則の概要。