Identically adopts ISO 19168-1:2020, specifying the behaviour of Web APIs that provide access to features in a data set in a manner independent of the underlying data store. Defines discovery and query operations. KEYWORDS: Web; APIs; Data set; Discovery; Query
Table of contents
Header
About this publication
Preface
Foreword
Introduction
1 Scope
2 Normative references
3 Terms, definitions and abbreviated terms
3.1 Abbreviated terms
4 Conformance
5 Conventions
5.1 Identifiers
5.2 Link relations
5.3 Use of HTTPS
5.4 HTTP URIs
5.5 API definition
5.5.1 General remarks
5.5.2 Role of OpenAPI
5.5.3 References to OpenAPI components in normative statements
5.5.4 Paths in OpenAPI definitions
5.5.5 Reusable OpenAPI components
6 Overview
6.1 Design considerations
6.2 Encodings
6.3 Examples
7 Requirements class “Core”
7.1 Overview
7.2 API landing page
7.2.1 Operation
7.2.2 Response
7.2.3 Error situations
7.3 API definition
7.3.1 Operation
7.3.2 Response
7.3.3 Error situations
7.4 Declaration of conformance classes
7.4.1 Operation
7.4.2 Response
7.4.3 Error situations
7.5 HTTP 1.1
7.5.1 HTTP status codes
7.6 Unknown or invalid query parameters
7.7 Web caching
7.8 Support for cross-origin requests
7.9 Encodings
7.10 String internationalization
7.11 Coordinate reference systems
7.12 Link headers
7.13 Feature collections
7.13.1 Operation
7.13.2 Response
7.13.3 Error situations
7.14 Feature collection
7.14.1 Operation
7.14.2 Response
7.14.3 Error situations
7.15 Features
7.15.1 Operation
7.15.2 Parameter limit
7.15.3 Parameter bbox
7.15.4 Parameter datetime
7.15.5 Parameters for filtering on feature properties
7.15.6 Combinations of filter parameters
7.15.7 Response
7.15.8 Error situations
7.16 Feature
7.16.1 Operation
7.16.2 Response
7.16.3 Error situations
8 Requirements classes for encodings
8.1 Overview
8.2 Requirements Class “HTML”
8.3 Requirements Class “GeoJSON”
8.4 Requirements Class “Geography Markup Language (GML), Simple Features Profile, Level 0”
8.5 Requirements class “Geography Markup Language (GML), Simple Features Profile, Level 2”
