ISO IEC 20802-2-2016 PDF

Полное наименование и описание

Стандарт ISO/IEC 20802-2:2016 — «Information technology — Open data protocol (OData) v4.0 — Part 2: OData JSON Format». Определяет представления запросов и ответов протокола OData версии 4.0 в формате JSON, расширяя основную спецификацию (часть 1) правилами аннотаций, контекстных URL, контролируемой выдачей метаданных и другими соглашениями для переносимого обмена структурированными данными по HTTP.

Аннотация

ISO/IEC 20802-2:2016 задаёт синтаксис и семантику JSON-представлений для OData v4.0: как кодируются сущности и коллекции, какие служебные аннотации используются (например, odata.context, odata.type), как управлять объёмом метаданных, форматирование чисел и обработка ошибок. Документ предназначен для обеспечения взаимной совместимости сервисов и клиентов, использующих OData в JSON.

Общая информация

• Статус: Опубликован — международный стандарт (подтверждён, стадия 90.93).
• Дата публикации: 15 декабря 2016 г. (издание 1).
• Организация-издатель: ISO / IEC (совместно), разработка — технический комитет ISO/IEC JTC 1.
• ICS / категории: 35.100.70 (Application layer).
• Редакция / версия: Edition 1.0 (2016).
• Количество страниц: 43 страницы (официальное издание).

Информация по статусу, дате публикации, издателю, ICS и объёму страниц соответствуют официальной карточке стандарта.

Область применения

Стандарт применяется при реализации и использовании REST/HTTP-сервисов, совместимых с OData v4.0, где обмен данными между клиентом и сервисом производится в формате JSON. Типичные сценарии: проектирование Web API для корпоративной интеграции, публичные и внутренние REST-интерфейсы, промежуточное ПО (middleware), генераторы SDK и инструменты сериализации/десериализации, где требуются чёткие правила аннотирования, контекстных ссылок и представления типов.

Ключевые темы и требования

• Формат и правила представления сущностей и коллекций в JSON (структура payload, порядок полей для потоковой передачи).
• Механизм аннотаций OData (иначе — instance annotations), включая odata.context, odata.type, odata.nextLink, odata.count и др.
• Контролируемая выдача метаданных: параметры odata.metadata=full|minimal|none и связанные правила для уменьшения/увеличения объёма контрольной информации.
• Представление числовых типов и параметр IEEE754Compatible для сериализации Edm.Int64 и Edm.Decimal (встретятся как числа или строки в зависимости от совместимости с клиентом).
• Спецификация формата ошибок в JSON (включая target, details), правила для медиа-ресурсов и потоковых свойств (odata.mediaReadLink и т.п.).
• Поддержка специальных ответов: delta-ответы, ссылки навигации/associationLink, контекстные URL для навигационных свойств и возможности относительных URL в ответах.

Эти темы детализированы в самой спецификации JSON-формата OData v4.0 и являются ключевыми для совместимости реализаций.

Применение и пользователи

Основные пользователи стандарта: разработчики и архитекторы Web API, команды интеграции данных, поставщики платформ и библиотек (серверных и клиентских SDK), организации, внедряющие корпоративные интерфейсы и публичные REST-сервисы, а также авторы инструментов генерации кода и тестовых средств. Стандарт помогает обеспечить совместимость между разными реализациями OData при обмене структурированными наборами данных в JSON.

Связанные стандарты

ISO/IEC 20802-2:2016 является частью серии ISO/IEC 20802 (OData v4.0). Непосредственно связана с ISO/IEC 20802-1:2016 — «Part 1: Core» (определяет основные семантические правила OData). Также связана с сопутствующими спецификациями OData, описывающими URL-правила, CSDL/модель и другие форматы представления.

Ключевые слова

OData, OData v4.0, JSON Format, odata.metadata, odata.context, odata.type, odata.nextLink, IEEE754Compatible, Open Data Protocol, REST API, ISO/IEC 20802

FAQ

В: Что это за стандарт?

О: Международный стандарт, задающий формат JSON для запросов и ответов Open Data Protocol (OData) версии 4.0 — то есть правила, по которым данные и служебные аннотации передаются в JSON между сервисом и клиентом.

В: Что он регулирует?

О: Синтаксис и семантику JSON-представлений OData: структуру payload (сущности, коллекции), набор и формат аннотаций (odata.*), параметры управления выдачей метаданных, правила сериализации чисел и формат ошибок, а также связанные требования для совместимости реализаций.

В: Кто обычно использует?

О: Разработчики Web API и клиентских библиотек, архитекторы интеграционных решений, поставщики middleware и инструментария для работы с OData, а также организации, которым нужна совместимая передача структурированных данных по HTTP.

В: Он актуален или заменён?

О: Выпуск 2016 года остаётся действующим: стандарт был опубликован в декабре 2016 г. и его состояние показано как «опубликован» с пометкой подтверждённого международного стандарта (стадия 90.93). При пересмотрах стандартов ISO/IEC обычно проводится проверка каждые 5 лет; официальные карточки указывают подтверждение соответствующих частей серии при очередном обзоре.

В: Это часть серии?

О: Да — ISO/IEC 20802 состоит как минимум из части 1 (Core) и части 2 (JSON Format). Первая часть задаёт базовые семантики OData, вторая — конкретную JSON-форму обмена данными; возможны и другие взаимосвязанные документы/части, покрывающие URL-правила, CSDL и пр.

В: Какие ключевые слова?

О: OData, JSON, odata.context, odata.metadata, odata.type, odata.nextLink, IEEE754Compatible, Open Data Protocol, REST API, сериализация данных.