Skip to content
This repository has been archived by the owner on Jul 12, 2023. It is now read-only.

Latest commit

 

History

History
57 lines (37 loc) · 1.48 KB

ens-spec.md

File metadata and controls

57 lines (37 loc) · 1.48 KB

Resource Identifier (RI) Scheme name: ens

Scheme syntax

ens://v?r=[region]&c=[verification code]

Scheme semantics

Send COVID-19 exposure notifications verification codes into a compatible mobile application or operating system for verification of a diagnosis to share within the exposure notifications system.

  • ens : describes that the exposure notifications application to be opened.

  • v : verify, currently this is the only available action.

  • r : region, the region that this verification code is for.

    • Regions must be ISO_3166-2 codes.
    • For country level, the 2 character code is used.
    • If sub-regions are being used, this should be 2 character country, '-' (dash) followed by the 2 or 3 character subdivision code.

  • c : verification code to validate the diagnosis.

Encoding considerations

Use URL encoding if applicable. This URI is intended to be sent over SMS. While there is no stricit limit on length, it is recommended that the greeting text combined with the URI not exceed 160 characters in total.

Examples

Country level, 16 digit verification codes.

For Austraila:

ens://v?r=AU&c=1234abcd5678efgh

Country + Subdivision, 16 digit verification codes.

For the State of Washington, in the United States:

ens://v?r=US-WA&c=abcdefgh12345678

And for State of New South Wales in Austraila:

ens://v?r=AU-NSW&c=abcdefgh12345678