16
16
<li ><a href =" #errors" >Error Handling</a ></li >
17
17
<li ><a href =" #multiple" >Requesting multiple users</a ></li >
18
18
<li ><a href =" #gender" >Specifying a gender</a ></li >
19
- <li ><a href =" #seeds " >Seeds </a ></li >
19
+ <li ><a href =" #passwords " >Passwords </a ></li >
20
20
</ul >
21
21
<ul >
22
+ <li ><a href =" #seeds" >Seeds</a ></li >
22
23
<li ><a href =" #format" >Formats</a ></li >
23
24
<li ><a href =" #previous" >Versioning</a ></li >
24
25
<li ><a href =" #nationalities" >Nationalities</a ></li >
@@ -58,45 +59,45 @@ $.ajax({
58
59
"gender": "<span >male</span >",
59
60
"name": {
60
61
"title": "<span >mr</span >",
61
- "first": "<span >samuel </span >",
62
- "last": "<span >ross </span >"
62
+ "first": "<span >romain </span >",
63
+ "last": "<span >hoogmoed </span >"
63
64
},
64
65
"location": {
65
- "street": "<span >5592 pockrus page rd </span >",
66
- "city": "<span >santa ana </span >",
67
- "state": "<span >oregon </span >",
68
- "postcode": <span >69974 </span >
66
+ "street": "<span >1861 jan pieterszoon coenstraat </span >",
67
+ "city": "<span >maasdriel </span >",
68
+ "state": "<span >zeeland </span >",
69
+ "postcode": <span >69217 </span >
69
70
},
70
- "email": "<span >samuel.ross @example.com</span >",
71
+ "email": "<span >romain.hoogmoed @example.com</span >",
71
72
"login": {
72
- "username": "<span >silverwolf434 </span >",
73
- "password": "<span >blackjac </span >",
74
- "salt": "<span >d14iEZQT </span >",
75
- "md5": "<span >261a57061d35918f5c3ef7f90f4f2a80 </span >",
76
- "sha1": "<span >c330ad8c974ab9982622d5d5506cfed4886a79ab </span >",
77
- "sha256": "<span >8ca4a1ca48975a69bd829de61298cd6a950dede740d4c0e755d07ee4cfc06fa5 </span >"
73
+ "username": "<span >lazyduck408 </span >",
74
+ "password": "<span >jokers </span >",
75
+ "salt": "<span >UGtRFz4N </span >",
76
+ "md5": "<span >6d83a8c084731ee73eb5f9398b923183 </span >",
77
+ "sha1": "<span >cb21097d8c430f2716538e365447910d90476f6e </span >",
78
+ "sha256": "<span >5a9b09c86195b8d8b01ee219d7d9794e2abb6641a2351850c49c309f1fc204a0 </span >"
78
79
},
79
- "registered ": <span >1155461743 </span >,
80
- "dob ": <span >1078494582 </span >,
81
- "phone": "<span >(179)-102-8139 </span >",
82
- "cell": "<span >(107)-396-0688 </span >",
80
+ "dob ": " <span >1983-07-14 07:29:45 </span >" ,
81
+ "registered ": " <span >2010-09-24 02:10:42 </span >" ,
82
+ "phone": "<span >(656)-976-4980 </span >",
83
+ "cell": "<span >(065)-247-9303 </span >",
83
84
"id": {
84
- "name": "<span >SSN </span >",
85
- "value": "<span >476-30-9095 </span >"
85
+ "name": "<span >BSN </span >",
86
+ "value": "<span >04242023 </span >"
86
87
},
87
88
"picture": {
88
- "large": "<span >https://randomuser.me/api/portraits/men/80 .jpg</span >",
89
- "medium": "<span >https://randomuser.me/api/portraits/med/men/80 .jpg</span >",
90
- "thumbnail": "<span >https://randomuser.me/api/portraits/thumb/men/80 .jpg</span >"
89
+ "large": "<span >https://randomuser.me/api/portraits/men/83 .jpg</span >",
90
+ "medium": "<span >https://randomuser.me/api/portraits/med/men/83 .jpg</span >",
91
+ "thumbnail": "<span >https://randomuser.me/api/portraits/thumb/men/83 .jpg</span >"
91
92
},
92
- "nat": "<span >US </span >"
93
+ "nat": "<span >NL </span >"
93
94
}
94
95
],
95
96
"info": {
96
- "seed": "<span >705567e86a824a27 </span >",
97
+ "seed": "<span >2da87e9305069f1d </span >",
97
98
"results": <span >1</span >,
98
99
"page": <span >1</span >,
99
- "version": "<span >1.0 </span >"
100
+ "version": "<span >1.1 </span >"
100
101
}
101
102
}
102
103
</pre >
@@ -128,6 +129,42 @@ http://api.randomuser.me/<span>?gender=female</span>
128
129
</pre >
129
130
</section >
130
131
132
+ <section id =" passwords" >
133
+ <h2 >Passwords</h2 >
134
+ <p >By default, passwords are chosen randomly from a list of ~10k top used passwords. Starting with version 1.1, you can have more control over how passwords are generated using the <span >password</span > option.</p >
135
+ <pre >
136
+ http://api.randomuser.me/<span >?password=upper,lower,1-16</span >
137
+ </pre >
138
+
139
+ <p >The example above would generate a password consisting of uppercase and lowercase characters ranging between 1 to 16 characters long.<br ><br >
140
+ You can specify options for the passwords using this format:</p >
141
+ <pre >
142
+ http://api.randomuser.me/<span >?password=CHARSETS,MIN_LENGTH-MAX_LENGTH</span >
143
+ OR
144
+ http://api.randomuser.me/<span >?password=CHARSETS,MAX_LENGTH</span >
145
+ </pre >
146
+ <p >You can mix and match the charsets below for the CHARSETS option above:</p >
147
+ <pre >
148
+ special !"#$%& '()*+,- ./:;<=>?@[\]^_`{|}~
149
+ upper ABCDEFGHIJKLMNOPQRSTUVWXYZ
150
+ lower abcdefghijklmnopqrstuvwxyz
151
+ number 0123456789
152
+ </pre >
153
+ <p >MIN_LENGTH and MAX_LENGTH are the min/max length of the passwords that you want to generate.<br >
154
+ By default, passwords will be between 8 - 64 characters long.<br ><br >
155
+ Here are some more examples of password option combinations:</p >
156
+ <pre >
157
+ // Special chars exactly 32 characters long
158
+ http://api.randomuser.me/<span >?password=special,32</span >
159
+
160
+ // Uppercase chars between 1 to 8 characters long
161
+ http://api.randomuser.me/<span >?password=upper,1-8</span >
162
+
163
+ // Special, uppercase, lowercase, and numeric chars between the default 8 to 64 characters long
164
+ http://api.randomuser.me/<span >?password=special,upper,lower,number</span >
165
+ </pre >
166
+ </section >
167
+
131
168
<section id =" seeds" >
132
169
<h2 >Seeds</h2 >
133
170
<p >Seeds allow you to always generate the same set of users. For example, the seed "foobar" will always return results for <a href =" http://api.randomuser.me/1.0/?seed=foobar" target =" _blank" >Becky Sims</a > (for version 1.0). Seeds can be any string or sequence of characters.</p >
@@ -158,7 +195,7 @@ http://api.randomuser.me/<span>?format=csv</span>
158
195
<pre >http://api.randomuser.me/</pre >
159
196
<p >The result that is returned automatically uses the latest version of the API.<br >
160
197
If you want to access a specific version of the API that won't be affected by updates, do this:</p >
161
- <pre >http://api.randomuser.me/<span >1.0 </span >/</pre >
198
+ <pre >http://api.randomuser.me/<span >1.1 </span >/</pre >
162
199
</section >
163
200
164
201
<section id =" nationalities" >
@@ -168,6 +205,7 @@ http://api.randomuser.me/<span>?format=csv</span>
168
205
<p >Currently, randomuser offers these nationalities:</p >
169
206
<ul >
170
207
<li >v1.0: AU, BR, CA, CH, DE, DK, ES, FI, FR, GB, IE, IR, NL, NZ, TR, US</li >
208
+ <li >v1.1: AU, BR, CA, CH, DE, DK, ES, FI, FR, GB, IE, IR, NL, NZ, TR, US</li >
171
209
</ul >
172
210
<p >You can specify a nationality like so:</p >
173
211
<pre >
0 commit comments