RandomUser 网站介绍

tools

api

- 介绍
- 使用
- 结果
- API 错误
- 请求多个用户
- 指定性别
- 密码
- 种子
- 格式
- 使用早期版本
- 国家
- 页码
- 包含/不包含字段
- 杂项
- 结束语

介绍

在 2013 年 8 月，该项目开始启动。项目的目的是：创建一个免费的、易于使用的服务，用于为应用的测试生成随机的用户数据。

使用

可以使用 AJAX 来调用随机用户生成器的 API，返回的结果中将包含一个随机生成用户。如果使用了 jQuery，可以调用 $.ajax() 方法：

$.ajax({

  url: 'https://randomuser.me/api/',

  dataType: 'json',

  success: function(data) {

    console.log(data);

  }

});

结果

根据你的选择，API 会给你返回一个格式化的对象。你可以对它进行解析，并在应用中使用它们。

默认的格式是 JSON。通过使用不同的格式化参数，可以获取不同格式的数据。

{

  "results": [

    {

      "gender": "male",

      "name": {

        "title": "mr",

        "first": "romain",

        "last": "hoogmoed"

      },

      "location": {

        "street": "1861 jan pieterszoon coenstraat",

        "city": "maasdriel",

        "state": "zeeland",

        "postcode": 69217

      },

      "email": "romain.hoogmoed@example.com",

      "login": {

        "username": "lazyduck408",

        "password": "jokers",

        "salt": "UGtRFz4N",

        "md5": "6d83a8c084731ee73eb5f9398b923183",

        "sha1": "cb21097d8c430f2716538e365447910d90476f6e",

        "sha256": "5a9b09c86195b8d8b01ee219d7d9794e2abb6641a2351850c49c309f1fc204a0"

      },

      "dob": "1983-07-14 07:29:45",

      "registered": "2010-09-24 02:10:42",

      "phone": "(656)-976-4980",

      "cell": "(065)-247-9303",

      "id": {

        "name": "BSN",

        "value": "04242023"

      },

      "picture": {

        "large": "https://randomuser.me/api/portraits/men/83.jpg",

        "medium": "https://randomuser.me/api/portraits/med/men/83.jpg",

        "thumbnail": "https://randomuser.me/api/portraits/thumb/men/83.jpg"

      },

      "nat": "NL"

    }

  ],

  "info": {

    "seed": "2da87e9305069f1d",

    "results": 1,

    "page": 1,

    "version": "1.1"

  }

}

API 错误

如果服务挂了，或者服务出问题了，将会返回一个key 为 error 的 json 格式的信息：

{

  error: "Uh oh, something has gone wrong. Please tweet us @randomapi about the issue. Thank you."

}

请求多个用户

随机用户生成器允许的单次最大请求用户数是：5000，请求人数的指定需要使用 results 参数：

https://randomuser.me/api/?results=5000

指定性别

通过在请求上添加 gender 参数，你可以指定随机生成的用户是否全都是男性、全都是女性、或者两者都有。gender 的有效值为：male，female，或者为空。如果传递其它的值，服务返回的用户既包含男性，也包含女性：

https://randomuser.me/api/?gender=female

密码

默认地，密码是从 10000 个最常用的密码中随机选择的。从版本 1.1 开始，对于密码的生成规则，可以使用 password 选项，对密码的生成进行更多的控制。

https://randomuser.me/api/?gender=female

调用上面的 API 可以生成：由大、小写字母组成的、长度在 1 ~ 16 的密码。

使用下面的格式来指定密码的选项：

https://randomuser.me/api/?password=CHARSETS,MIN_LENGTH-MAX_LENGTH

OR

https://randomuser.me/api/?password=CHARSETS,MAX_LENGTH

上面格式中的 CHARSETS 可以使用下面的混合模式：

special    !"#$%&'()*+,- ./:;<=>?@[\]^_`{|}~

upper      ABCDEFGHIJKLMNOPQRSTUVWXYZ

lower      abcdefghijklmnopqrstuvwxyz

number     0123456789

MIN_LENGTH 和 MAX_LENGTH 是生成密码的最小长度和最大长度。默认的范围是：8 到 64。

下面是密码选项组合的示例：

// 32位长度的特殊字符

https://randomuser.me/api/?password=special,32

// 1~8位长度的大写字符

https://randomuser.me/api/?password=upper,1-8

// 8~64位长度的特殊字符、大写、小写、数字的组合

https://randomuser.me/api/?password=special,upper,lower,number

种子

种子（seed）可以生成同样的用户集合。例如，名为 foobar 的种子将总是返回 Becky Sims（1.0 版本）结果。种子可以是任意的字符串或字符的序列。

https://randomuser.me/api/?seed=foobar

格式

当前支持以下格式的数据：

JSON（默认）
PrettyJSON 或 pretty
CSV
YAML
XML

使用 format 参数指定返回数据的格式：

https://randomuser.me/api/?format=csv

使用早期版本

如果有新的 API 版本发布，它可能会搞坏你的应用。通过下面的代码获取 API：

https://randomuser.me/api/

上面的 API 将自动使用最新的 API 获取数据。

如果你不想应用受到新版 API 的影响，并想指定 API 版本，那应该使用下面的调用：

https://randomuser.me/api/1.1/

国家

你可以请求不同国家的随机用户。

图片将不会受到国家的影响，但是如果指定了国家，生成的用户数据，例如位置、电话、ID等，会变得更为合理一些。

当前的随机用户支持下列国家：

v1.0: AU, BR, CA, CH, DE, DK, ES, FI, FR, GB, IE, IR, NL, NZ, TR, US
v1.1: AU, BR, CA, CH, DE, DK, ES, FI, FR, GB, IE, IR, NL, NZ, TR, US

这样来指定国家：

https://randomuser.me/api/?nat=gb

不指定该参数，默认将返回随机的国家。对于国家，可以有一些简单的控制，可以使用一个用逗号分割的列表：

https://randomuser.me/api/?nat=us,dk,fr,gb

页码

使用 page 参数，可以请求某个种子下的多个页码。

为了返回同样的数据，请确保使用同样的种子和同样的页码：

https://randomuser.me/api/?page=3&results=10&seed=abc

包含/不包含字段

有时候，你或许只想要一些随机的名称，而不需要一些不相关的数据（例如：位置，电话等）。这时，就需要使用 inc 和 exc 参数。这两个参数分别用来指定结果中包含和不包含的字段。

通过指定返回的字段，生成器可以通过跳过 CPU 密集型的字段（例如：login）来节约时间。

包含与不包含的字段接收以逗号分隔的下列字段的集合：

gender
name
location
email
login
regstered
dob
phone
cell
id
picture
nat

如果你只想使用用户的 name，gender，nat 字段，那应该这样写：

https://randomuser.me/api/?inc=gender,name,nat

如果除了 login 数据，其它的用户信息都想要，那应该这样写：

https://randomuser.me/api/?exc=login

杂项

还可以给请求上添加一些其它的参数：

dl -- 下载相应格式的结果：https://randomuser.me/api/?results=25&nat=gb,us,es&fmt=csv&dl
noinfo -- 如果只想要数据，而不关心种子，数量，页码和版本：https://randomuser.me/api/?results=5&inc=name,gender,nat&noinfo
callback -- 如果在 JSONP 中想要有效载荷，使用 callback 参数提供一个回调。该参数只在 JSON 格式下有效：https://randomuser.me/api/?results=5&callback=randomuserdata

结束语

如果你发现了 API 的问题，或是想为这个项目的数据库贡献一些数据，那请你移驾访问我们的 Guthub Repo。不胜感激！