Shared Vocabulary

When designing applications, it is recommended to use standardized terms registered in shared vocabulary sites.

IANA Link Relations

Link relations are standardized identifiers that indicate the relationship between two resources. The main purpose is to clarify the semantic relationship between resources.

Example) author registered in IANA

<descriptor id="goBookAuthor" type="safe" rt="#BookAuthor" rel="author">

Please refer to IANA Link Relations.

Schema.org

Schema.org is a vocabulary for structured data jointly developed by Google, Microsoft, Yahoo, and Yandex.

Please refer to Semantic Terms.

ALPS files that import semantics from Schema.org are available.

Schema.org ALPS Index

Link to semantics using href.

Example) givenName and familyName

<descriptor id="Person">
    <descriptor href="https://alps-io.github.io/imports/schema.org/properties/givenName.json" />
    <descriptor href="https://alps-io.github.io/imports/schema.org/properties/familyName.json" />
</descriptor>

Narrowing Down

You can create descriptors that narrow down semantics from shared vocabulary.

Example)

<descriptor id="bankAccountId" href="https://alps-io.github.io/imports/schema.org/properties/accountId.json" />