microsoft / microsoft/OpenAPI.NET.OData

add support for emitting webhooks

Ouverte
#508 6 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

priority:p2 type:enhancement
Langage dominant
C#
Étoiles
240
Forks
70
Merge moyen
7 h 59 min
PR mergées (30 j)
13

Description

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:

  1. come up with an annotation that means "used for a webhook"
  2. add this annotation to the metadata via XOD
  3. leverage that annotation here so a webhook definition can be added to the description
  4. have kiota project the types from webhooks components, and not trim them.

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par retracer la Microsoft Graph pipeline, le XOD metadata flow et la suppression par Kiota des types qui ne sont pas utilisés par les endpoints entrants. Définissez comment les annotations de webhook doivent être représentées et consommées dans la description générée. Le travail est terminé lorsque les définitions de webhook conservent les types requis et que Kiota les projette au lieu de les supprimer.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
csharp, openapi
Domaine
api, backend-api-design
Type d'issue
Fonctionnalité
Difficulté
5/5
Temps estimé
Plus d'une semaine
Activité
À l'abandon
Clarté
Plutôt claire
Accessibilité débutants
25/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.