В цій статті
Додатків необхідно оновлювати свої підписки до закінчення терміну дії підписок. Крім того, додатки можуть в будь-який момент скасувати підписку, щоб більше не отримувати повідомлення.
Розглянемо процес створення підписки.
створення підписки
Створення підписки - це перший етап, необхідний, щоб почати отримувати повідомлення для певної колекції об'єктів. Процес підписки виконується вказаним нижче чином.
характеристики підписок
Протягом 5 секунд служба веб-перехоплювачів повинна надати відгук 200. в тексті якого має бути значення validationtoken типу plain / text. Маркер перевірки є випадковою рядок, яку веб-перехоплювач повинен скасувати після вказівки її у відгуку.
Приклад створення запиту на підписку
Приклад створення відгуку підписки
Відгук підписки - це повторення запиту до вказаних нижче додатковими властивостями і значеннями.
- Id - унікальний ідентифікатор для кожної підписки. Клієнт повинен зберігати цей ідентифікатор, щоб зіставляти його з повідомленням.
- SubscriptionExpirationDateTime - фактичний час закінчення терміну дії на випадок, якщо воно не зазначено в запиті або якщо час, вказане в запиті, більше трьох днів.
- ChangeType додає два типи повідомлень: Acknowledgment і Missed. Вони будуть описані в розділі, присвяченому повідомленнями.
Наприклад, в прикладі запиту вище створюється відгук приблизно наступного вигляду:
відновлення підписки
Приклад запиту на продовження підписки
Приклад відгуку для запиту на продовження підписки
Відгук для запиту на продовження підписки є повтор відгуку для запиту на створення підписки із зазначенням нової дати закінчення терміну дії.
скасування підписки
Щоб скасувати підписку, клієнт повинен видалити її, вказавши ідентифікатор підписки.
При успішній скасування підписки у відгуку міститься HTTP-код відгуку 204 No Content.
повідомлення
Ймовірно, ви вже помітили, що відгук для запиту на підписку включає два додаткових типу змін: Missed і Acknowledgment. Це особливі типи повідомлень, які використовуються зазначеним нижче чином.
Кожне повідомлення (незалежно від його типу) має зазначену нижче структуру.
Крім того, повідомлення, пов'язане зі зміною ресурсу (наприклад, при отриманні, читанні або видаленні повідомлення), має додаткове властивість ResourceData. що містить ідентифікатор зміненого елемента. Клієнт може використовувати такий ідентифікатор для обробки цього елемента відповідно до своєї бізнес-логікою (наприклад, отримати елемент, синхронізувати його папку і т. Д.).
приклади повідомлень
Повідомлення про одержання пошти
Коли в папку "Вхідні" користувача надходить нове повідомлення, служба повідомлень відправляє повідомлення, в якому властивість ChangeType має значення Created.
Повідомлення про прочитання повідомлення
пропущене повідомлення
Подальші дії
Ми дуже раді випуску REST API повідомлень для Outlook і веб-перехоплювачів для пошти, календаря та контактів. Спробуйте їх в роботі і напишіть нам відгук в UserVoice. Це допоможе поліпшити наші API, і ви зможете створювати прекрасні інтерфейси в своїх додатках.