A laboratórium célja és architecture-je
A graph-call-dashboard elkülöníti a Graph-integrációs kísérleteket az éles postafiók-motortól. Segít a fejlesztőknek megvizsgálni a callbackek érkezését, a folytatási viselkedést, a normalizált állapotot és a szolgáltatói szélsőséges eseteket. Használat előtt készítsd elő a Graph-alkalmazáshozzáférést.
Push és pull
Push módban a műszerfal Graph-előfizetéseket hoz létre, és fogadja a /graphWebhook és a /graphWebhook/lifecycle kéréseket. Rögzíti a kliensállapot- és értesítési token-ellenőrzéseket, és képes visszafejteni a gazdag értesítési tartalmat. Az egyező kliensállapot engedélyezi a visszafejtést. A tokenellenőrzés csak diagnosztikai. Az érvénytelen, nem elérhető vagy hiányzó tokenek önmagukban nem blokkolják a visszafejtést vagy az összes életciklus-frissítést. A hívások és események vizsgálatra elérhetők maradnak.
Pull módban a műszerfal támogatja a postafiók-mappák delta-folyamait, a mappaüzenet-delta folyamatokat és az Outlook főkategóriák teljes lekérdezéseit. A gyökér-, folytatási és újrajátszási műveletek végrehajtásokat hoznak létre. Egy végrehajtás követi a @odata.nextLink oldalait. Delta-folyamoknál eltárolja a végső @odata.deltaLink értéket a következő körhöz.
Az Outlook-címkék ehelyett a STANDARD_PULL módot használják. Minden futás a teljes, lapozott katalógust olvassa, folytatási hivatkozást nem tartva meg. Az összehasonlítási szülő a legutóbbi sikeres teljes lekérdezés. A teljes postafiók-futás a mappák és üzenetek előtt ezt a címkelekérdezést végzi el. Az olvasási jogosultságú címkékhez a MailboxSettings.Read jogosultság kell, adminisztrátori hozzájárulással. A normalizálás és a differ mutatja az állapotot és a leszármazást.
Ezek a laboratóriumi callbackek eltérnek az éles WebhookCatcher útvonalaitól és tartós feldolgozási szerződésétől. Egy laboratóriumi eseményrekord nem éles postafiók-vetítés.
Modulok
| Útvonal | Felelősség |
|---|---|
src/app | Oldalak és API-útvonalak |
src/components/dashboard | Felhasználók, előfizetések, webhook-hívások, diagnosztika |
src/components/delta | Explorer- és differ-nézetek |
src/server/graph | Kliens, címtár, előfizetések, tanúsítvány és visszafejtés |
src/server/webhooks | Bemeneti szolgáltatás és token-/kliensállapot-ellenőrzések |
src/server/delta | Lekérdezések, lapozás, hivatkozások, normalizálás |
prisma/schema.prisma | SQLite-előfizetési, webhook- és delta-állapot |
A Graph-hívások webhook-útvonalakat vagy delta API-kéréseket érnek el. Mindkét útvonal SQLite-állapotot rögzít. A műszerfal ebből az állapotból mutatja a kéréseket, válaszokat és normalizált különbségeket.
Gyakorlati használat
A laboratóriummal kis postafiók-hatókörrel reprodukálhatsz egy integrációs problémát. Hasonlítsd össze a nyers választ, a normalizált eseményeket, a szülő-végrehajtást és a differet. A Replay (újrajátszás) egy folytatást segít újra megvizsgálni. Nem ígéri, hogy a szolgáltató azonos történeti választ ad vissza.
Lásd: helyi beállítás és delta-értelmezés.