{"_id":"56ad2b663fc1020d009776da","category":{"_id":"56abdd81d4432d1900eed235","__v":6,"version":"569f9cf6650e1d1900f96b5e","pages":["56abddd30b9e0b0d006162b1","56abde024e4b730d009eb11a","56abe05f678b58170031ec46","56ad2053d21f1b0d00fd2f82","56ad2a922a7860170013f70d","56ad2b663fc1020d009776da"],"project":"569f9cf6650e1d1900f96b5b","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-01-29T21:45:37.383Z","from_sync":false,"order":2,"slug":"introduction","title":"Introduction"},"version":{"_id":"569f9cf6650e1d1900f96b5e","project":"569f9cf6650e1d1900f96b5b","__v":12,"createdAt":"2016-01-20T14:43:02.785Z","releaseDate":"2016-01-20T14:43:02.785Z","categories":["569f9cf7650e1d1900f96b5f","56abdd81d4432d1900eed235","56abe0558beeff0d003b8118","56ad2f8b1c09150d00a183a8","56ad4e1cd21f1b0d00fd2f97","56b00ad88f7a4f0d0029dc92","56b2432e9621f20d00efb2bd","56b25826147e900d00d6497a","56b7af2a4b372d2100722c48","56b8c4d938b1070d0028920f","56b8cdab14feef0d0082415d","58599813cf9e112d0032cdab"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"user":"5582e90181672a3900bb4fc7","project":"569f9cf6650e1d1900f96b5b","__v":16,"githubsync":"","parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-01-30T21:30:14.975Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":5,"body":"## Email addresses \n\nFormat: *user:::at:::domain*.\n  * user—Can be anything enclosed in quotes except the characters \" or \\\nor a string.\n   * starting with a-z, A-Z, 0-9 ! # $ & ' * + - / = ? ^ _ ` { | } ~\n   *  consisting of a-z, A-Z, 0-9 ! # $ & ' * + - / = ? ^ _ ` { | } ~ . \n   * not containing consecutive dots . \n  *  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. \n\n## Wildcard email address \n\n  * Between 1 and 128 characters consisting of a-z A-Z 0-9 ! @ # $ % & ' \"*+- / =?^ _` { | }~.\n  * The ***** character matches any string of 0 or more characters, and may span all parts of the email address, for example, abc*ef matches abcdef@domain.pef . The + character matches any single character.\n\n## OMA email address\n\nOMA email addresses are addresses that can be created on the OpenSRS Email System and are more restrictive than general email addresses.\n\nFormat: *user@domain*\n\n  * 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.\n  * 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.\n\n## Password \n\n  * Can be plain text or hashed.\n  * If plain text, the text can be **between 1 and 54 characters** (Length must not exceed 54 characters). \n  * If hashed, it is a ASCII string consisting of an hash type in curly braces followed by 1 to 150 characters.\n  * 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). \n  * Passwords are always stored and retrieved hashed. If a plain text password is assigned, it will be hashed before it is stored.\n  * The only characters that can be used are ASCII characters with the decimal codes 33 and 35 to 126.\n  * An empty password is not allowed.\n  * 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: ~ ! @ $ % ^ & * ( ) - _ = + / \\ ] [ { } : ; > < , . ‘ | ? #\n  * 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) \n  * Double quotation marks are not allowed (ASCII character 34). Delete (ASCII character 127) is not allowed. Space (ASCII character 32) is not allowed.\n\n## Domain \n\n  * A JSON string between 3 and 160 ASCII characters consisting of 2 or more dot separated labels.\n  * 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. \n\n## Text \n\n  * A JSON string consisting of between 1 and 127 ASCII characters. \n\n## UNIX time \n\n  * A number, a UNIX epoch time. \n\n## UTF-8 text \n\n  * A JSON String consisting of any characters.","excerpt":"This section explains the data rules that must be followed when submitting HTTP POST requests.","slug":"data-constraints","type":"basic","title":"Data constraints"}

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 abcdef@domain.pef . 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.