În acest articol
Aplicațiile trebuie să își actualizeze abonamentele înainte de expirarea abonamentelor. În plus, aplicațiile se pot dezabona în orice moment pentru a nu mai primi notificări.
Luați în considerare procesul de creare a unui abonament.
Creați un abonament
Crearea unui abonament este primul pas necesar pentru a începe să primiți notificări pentru o anumită colecție de obiecte. Procesul de abonare se efectuează după cum urmează.
Caracteristicile abonamentului
În interval de 5 secunde, serviciul de interceptare Web trebuie să ofere un răspuns de 200. Textul serviciului ar trebui să aibă o valoare de validare a tipului simplu / text. Un jeton de validare este un șir aleator pe care interceptorul Web trebuie să îl anuleze după specificarea acestuia în răspuns.
Exemplu de creare a unei solicitări de abonament
Exemplu de creare a unui răspuns la abonament
Un răspuns la abonament este o repetare a unei interogări cu proprietățile și valorile suplimentare enumerate mai jos.
- Id este identificatorul unic pentru fiecare abonament. Clientul trebuie să stocheze acest identificator pentru a se potrivi cu notificările.
- SubscriptionExpirationDateTime este timpul real de expirare în cazul în care nu este specificat în cerere sau dacă timpul specificat în cerere este mai mare de trei zile.
- ChangeType adaugă două tipuri de notificări: Confirmare și Pierdute. Acestea vor fi descrise în secțiunea Notificare.
De exemplu, în exemplul de mai sus, este generat un răspuns care arată astfel:
Reînnoirea abonamentului
Exemplu de cerere de reînnoire
Exemplu de răspuns pentru o solicitare de reînnoire a abonamentului
Răspunsul pentru o solicitare de reînnoire a abonamentului este un răspuns repetat pentru o solicitare de abonament cu o nouă dată de expirare.
anulaţi abonamentele
Pentru a anula un abonament, clientul trebuie să îl șterge specificând codul de abonament.
Dacă abonamentul este anulat cu succes, răspunsul conține codul de răspuns HTTP 204 No Content.
anunț
Probabil ați observat deja că răspunsul pentru solicitarea de abonament include două tipuri suplimentare de modificări: Pierdute și confirmare. Acestea sunt tipuri speciale de notificări utilizate în modul următor.
Fiecare notificare (indiferent de tipul acesteia) are următoarea structură.
În plus, notificarea referitoare la modificarea resurselor (de exemplu, când se citește, se citește sau se șterge un mesaj) are o proprietate suplimentară ResourceData. conținând identificatorul elementului modificat. Clientul poate folosi un astfel de identificator pentru a procesa acest element în funcție de logica sa de afaceri (de exemplu, obține un element, sincronizează dosarul său etc.).
Eșantioane de notificări
Notificarea primirii poștei
Când un mesaj nou apare în căsuța de e-mail a utilizatorului, serviciul de notificare trimite o notificare în care proprietatea ChangeType este setată la Creare.
Notificarea citirii unui mesaj
Eroare de notificare
Pașii următori
Suntem foarte mulțumiți de lansarea notificărilor REST API pentru interceptoarele Outlook și Web pentru e-mail, calendar și contacte. Încercați-le în lucrare și scrieți-ne feedback în UserVoice. Acest lucru vă va ajuta să vă îmbunătățiți API-urile și veți putea crea interfețe excelente în aplicațiile dvs.
Trimiteți-le prietenilor: