Data constraints

This section explains the data rules that must be followed when submitting HTTP POST requests.

Email addresses

Format: user@domain.

  • user—Can be anything enclosed in quotes except the characters " or
    or a string.
  • starting with a-z, A-Z, 0-9 ! # $ & ' * + - / = ? ^ _ ` { | } ~
  • consisting of a-z, A-Z, 0-9 ! # $ & ' * + - / = ? ^ _ ` { | } ~ .
  • not containing consecutive dots .
  • domain—Can be between 3 and 160 ASCII characters consisting of 2 or more dot-separated domain labels. A domain label is between 1 and 63 ASCII characters, starting and ending with 0-9, A-Z, a-z and consisting of 0-9, A-Z, a-z or hyphen.

Wildcard email address

  • Between 1 and 128 characters consisting of a-z A-Z 0-9 ! @ # $ % & ' "*+- / =?^ _` { | }~.
  • The * character matches any string of 0 or more characters, and may span all parts of the email address, for example, abc*ef matches [email protected] . The + character matches any single character.

OMA email address

OMA email addresses are addresses that can be created on the OpenSRS Email System and are more restrictive than general email addresses.

Format: user@domain

  • user—Can be between 1 and 64 ASCII characters starting with 0-9A- Za-z._-], starting with 0-9, A-Z, a-z, and containing 0-9, A-Z, a-z, hyphen, underscore, or dot, but not containing adjacent dots.
  • domain—Can be between 3 and 160 characters consisting of 2 or more dot separated labels. A domain label is between 1 and 63 ASCII characters, starting and ending with 0-9, A-Z, a-z and consisting of 0- 9, A-Z, a-z or hyphen.

Password

  • Can be plain text or hashed.
  • If plain text, the text can be between 1 and 54 characters (Length must not exceed 54 characters).
  • If hashed, it is a ASCII string consisting of an hash type in curly braces followed by 1 to 150 characters.
  • Allowed hash types are: MD5 BCRYPT CRYPT DES SHA SHA1 SHA224 SHA256 SHA384 SHA512 SSHA SSHA1 SSHA224 SSHA256 SSHA384 SSHA512 GCRYPT (GCRYPT is for glibc hashed SHA and BCRYPT passwords from a shadow file on modern linux distributions).
  • Passwords are always stored and retrieved hashed. If a plain text password is assigned, it will be hashed before it is stored.
  • The only characters that can be used are ASCII characters with the decimal codes 33 and 35 to 126.
  • An empty password is not allowed.
  • A subset of ASCII 7-bit character set is allowed, including a to z, A to Z, 0 to 9, and the following special characters: ~ ! @ $ % ^ & * ( ) - _ = + / \ ] [ { } : ; > < , . ‘ | ? #
  • The following special characters are not allowed: Ö (ASCII character 153) Ä (ASCII character 142) Ü (ASCII character 154) ö (ASCII character 148) ä (ASCII character 132) ü (ASCII character 129)
  • Double quotation marks are not allowed (ASCII character 34). Delete (ASCII character 127) is not allowed. Space (ASCII character 32) is not allowed.

Domain

  • A JSON string between 3 and 160 ASCII characters consisting of 2 or more dot separated labels.
  • A domain label is between 1 and 63 ASCII characters, starting and ending with 0-9, A-Z, a-z and consisting of 0-9, A-Z, a-z or hyphen.

Text

  • A JSON string consisting of between 1 and 127 ASCII characters.

UNIX time

  • A number, a UNIX epoch time.

UTF-8 text

  • A JSON String consisting of any characters.