microsoft / microsoft/OpenAPI.NET.OData
add support for emitting webhooks
オープン
まだ誰も着手していません。
priority:p2
type:enhancement
- 主要言語
- C#
- スター
- 240
- フォーク
- 70
- 平均マージ
- 7時間 59分
- マージ済み PR(30日)
- 13
説明
Microsoft Graph has types that are only used when the service calls to the client's APIs: change notifications.
In the Microsoft Graph pipeline, those types are being trimmed by kiota because they are not used anywhere (any inbound endpoint).
We should:
- come up with an annotation that means "used for a webhook"
- add this annotation to the metadata via XOD
- leverage that annotation here so a webhook definition can be added to the description
- have kiota project the types from webhooks components, and not trim them.
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
調査の方向性
まず Microsoft Graph pipeline、XOD metadata flow、および inbound endpoints で使用されない型を Kiota が trimming する処理を追跡します。生成された description で webhook annotations をどのように表現し、利用するかを定義します。Webhook definitions が必要な型を保持し、Kiota がそれらを trimming せずに投影できれば完了です。
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- csharp, openapi
- 領域
- api, backend-api-design
- issue の種類
- 機能追加
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 活発さ
- 停滞
- 明瞭さ
- おおむね明確
- 初心者へのやさしさ
- 25/100