When generating API models, the Akita CLI will identify common data formats, like dates, times, and URLs. When Akita learns that a parameter's value matches a known data format, it adds an
x-akita-format annotation to the parameter.
x-akita-format annotation has two parts, the
kind of data format, like
datetime, as well as any specific formats, such as the
RFC3339 format for dates and times, or the Unix timestamp format of seconds after the epoch. The kinds and formats that SuperLearn supports are listed below.
Please let us know if there are additional data formats you would like to see. We have also gotten requests for introducing custom data formats. They are on our roadmap! (But please still let us know if you are interested.)
Countries of the world, including native and English spellings and country codes.
Names of currencies, including native and English spellings and abbreviations.
Dates, times, and timestamps.
Written and spoken languages, including native and English spellings.
URLs and other uniform resource identifiers.
ISO 3166 Alpha-2 two-letter country code.
ISO 3166 Alpha-3 three-letter country code.
Country name as expressed in that country.
Country name in English.
Top level domain name.
Currency name in English.
Currency name, abbreviated.
Date and time as returned by ANSI C date and time functions, like
The Go language's handy time stamp.
The Go language's handy time stamp, with microsecond precision.
The Go language's handy time stamp, with millisecond precision.
Time as commonly seen on a stove or microwave.
Date and time as specified by RFC 2822.
Date and time as specified by RFC 2822, with numeric timezone.
Date and time as specified by RFC 822. This is a subset of the date/time formats accepted by RFC 2822.
Date and time as specified by RFC 822, with numeric timezone. This is a subset of the date/time formats accepted by RFC 2822.
Date and time as specified by RFC 850.
Date and time as specified by RFC 3339.
Date and time as rendered by Ruby's DateTime library.
Timestamp represented as milliseconds since the Unix Epoch (00:00:00 UTC on 1 January 1970).
Timestamp represented as nanoseconds since the Unix Epoch (00:00:00 UTC on 1 January 1970).
Timestamp represented as seconds since the Unix Epoch (00:00:00 UTC on 1 January 1970).
Timezone represented as offset from UTC.
Two-letter abbreviation of language name, as specified by ISO 693-1.
Three-letter abbreviation of language name, as specified by ISO 693-2.
Language name, as expressed natively.
Language name in English.
International telephone number, including the international calling code. Supports
United States phone number, including area code but excluding international calling code. Supports a variety of separators, see examples.
Absolute URL, including HTTP or HTTPS protocol, trailing paths, and/or anchors.
Updated 2 months ago