Skip to content

Commit 289d50e

Browse files
committed
Update documentation on DCACCOUNT
Corresponding core PR: chatmail/core#7360
1 parent 61b239a commit 289d50e

File tree

1 file changed

+12
-6
lines changed

1 file changed

+12
-6
lines changed

uri-schemes.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -161,16 +161,22 @@ https://i.delta.chat/#EEA98F87742EF2FD6C23677F1E1142828C202998&a=demo.fn8hk%40fi
161161

162162
### Syntax
163163

164-
currently this only accepts a url that gives back account setup information as a json object.
165-
see the [mailadm](https://github.com/deltachat/mailadm) project for more details as this api was designed for use with burner account qr codes generated by mailadm.
164+
This scheme contains either the domain name of a chatmail server or an HTTPS URL.
166165

167-
```
168-
DCACCOUNT:https://example.org/new_email?t=1w_7wDjgjelxeX884x96v3
169-
```
166+
If domain name is used, e.g. as `DCACCOUNT:example.org`,
167+
then the client should generate a 9-character alphanumeric lowercase username,
168+
e.g. `ipvzrws6x@example.org`,
169+
and a password that is at least 30 characters long,
170+
drawn from the full set of alphanumeric characters (`A-Z`, `a-z`, `0-9`).
171+
172+
If URL is used, e.g. `DCACCOUNT:https://example.org/new_email?t=1w_7wDjgjelxeX884x96v3`,
173+
then the client should make an HTTP/1.1 GET request
174+
and receive account setup information as a JSON object.
175+
See the [mailadm](https://github.com/deltachat/mailadm) project for more details as this API was designed for use with burner account QR codes generated by mailadm.
170176

171177
You may want to use [`DCLOGIN`](#DCLOGIN) instead, if you want a qr code containing login information for a single account.
172178

173-
#### The http endpoint needs the following api:
179+
#### The HTTP endpoint needs the following api:
174180

175181
##### On Success
176182

0 commit comments

Comments
 (0)