• 用户模块
    • 获取用户详情
    • 获取用户列表

    用户模块

    获取用户详情

    接口

    GET https://cloud.minapp.com/oserve/v1/miniapp/user-profile/:profile_id/

    其中 :profile_id 需替换为用户 ID（已废弃）

    GET https://cloud.minapp.com/oserve/v1/miniapp/user-profile/?user_id={{ user_id }}

    其中 user_id 可从用户列表中获取。

    代码示例

    {% tabs curl=”Curl”, node=”Node”, php=”PHP” %}

    {% content “curl”%}

    1. curl -X GET \
    2. -H "Authorization: Bearer 58f6cd9f84b1b0c04941fbd4d87bc5f14a785107" \
    3. -H "Content-Type: application/json" \
    4. https://cloud.minapp.com/oserve/v1/miniapp/user-profile/?user_id=55019

    {% content “node” %}

    1. var opt = {
    2.   uri: 'https://cloud.minapp.com/oserve/v1/miniapp/user-profile/?user_id=4271xx',   // 4271xx 对应 :user_id
    3.   method: 'GET',
    4.   headers: {
    5.     Authorization: `Bearer ${token}`,
    6.   }
    7. }
    9. request(opt, function(err, res, body) {
    10.   console.log(body)
    11. })

    {% content “php”%}

    1. <?php
    2. $user_id = '4271xx'; // 用户 ID
    3. $url = "https://cloud.minapp.com/oserve/v1/miniapp/user-profile/?user_id={$user_id}";
    5. $ch = curl_init();
    6. $header = array(
    7.   "Authorization: Bearer {$token}",
    8.   'Content-Type: application/json; charset=utf-8'
    9. );
    11. curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
    12. curl_setopt($ch, CURLOPT_TIMEOUT, 30);
    13. curl_setopt($ch, CURLOPT_URL, $url);
    14. curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
    15. curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    16. curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
    18. $res = curl_exec($ch);
    19. curl_close($ch);

    {% endtabs %}

    返回示例

    1. {
    2.   "avatar": "https://media.ifanrusercontent.com/media/tavatar/55/c3/55c3dbebcc61891be10d29ded808c84a01dxxxxx.jpg",
    3.   "city": "Guangzhou",
    4.   "country": "China",
    5.   "created_at": 1504504504,
    6.   "gender": 1,
    7.   "id": 550xx,
    8.   "nickname": "PCG",
    9.   "openid": "onzns0KsLKFyg3-VcW0GwTE6xxxx",
    10.   "unionid": "onzns0KsLKFyg3-VcW0GwTE6xxxx",
    11.   "province": "Guangdong",
    12.   "user_group": [
    13.       137
    14.   ],
    15.   "user_id": 366197xx
    16. }

    获取用户列表

    接口

    GET https://cloud.minapp.com/oserve/v1/miniapp/user-profile/

    参数说明

    参数 类型 必填 说明
    created_at String N 用户创建的时间，值为时间戳。查询创建时间大于等于 2017-01-01 的用户 created_at__gte=1483228800，查询创建时间小于等于 2017-01-01 的用户：created_at__lte=1483228800
    gender Number N 户的性别，其中 1 表示男，2 表示女
    group String N 给定用户组 ID 查询在用户组下的用户列表。只支持 in 查询：group__in=258,360
    limit Number N 限制返回资源的个数，默认为 20 条，最大可设置为 1000
    nickname String N 用户的微信昵称，支持等值查询 nickname=Tom, 模糊查询 nickname__contains=Tom
    offset Number N 设置返回资源的起始偏移值，默认为 0
    openid String N 用户的 OpenID
    order_by String N 排序（支持 created_at 进行排序）
    unionid String N 用户的 UnionID
    user_id String N 用户 ID

    代码示例

    {% tabs first=”Curl”, second=”Node”, third=”PHP” %}

    {% content “first” %}

    1. curl -X GET \
    2. -H "Authorization: Bearer 58f6cd9f84b1b0c04941fbd4d87bc5f14a785107" \
    3. -H "Content-Type: application/json" \
    4. -G \
    5. -d nickname__contains=Tom \
    6. -d gender=1 \
    7. -d created_at__gt=1483228800 \
    8. -d order_by=-created_at \
    9. https://cloud.minapp.com/oserve/v1/miniapp/user-profile/

    {% content “second” %}

    1. var request = require('request');
    3. var opt = {
    4.   uri: 'https://cloud.minapp.com/oserve/v1/miniapp/user-profile/',
    5.   method: 'GET',
    6.   headers: {
    7.     Authorization: `Bearer ${token}`,
    8.   },
    9.   qs: {     // query string, 被附加到uri的参数
    10.     nickname__contains: 'username',
    11.     gender: 1,
    12.     created_at__gte: 1483228800,
    13.     user_id: '363953xx',
    14.     order_by: '-created_at'
    15.   }
    16. }
    18. request(opt, function(err, res, body) {
    19.   console.log(body)
    20. })

    {% content “third”%}

    1. <?php
    2. $query_data = array(
    3.   'nickname__contains' => 'Tom',
    4.   'gender' =>  1,
    5.   'created_at__gte' => 1483228800,
    6.   'order_by' => '-created_at'
    7. );
    8. $query_string = http_build_query($query_data);
    9. $url = "https://cloud.minapp.com/oserve/v1/miniapp/user-profile/?".$query_string;
    11. $ch = curl_init();
    12. $header = array(
    13.   "Authorization: Bearer {$token}",
    14.   'Content-Type: application/json; charset=utf-8'
    15. );
    17. curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
    18. curl_setopt($ch, CURLOPT_TIMEOUT, 30);
    19. curl_setopt($ch, CURLOPT_URL, $url);
    20. curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
    21. curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    22. curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
    24. $res = curl_exec($ch);
    25. curl_close($ch);

    {% endtabs %}

    返回示例

    1. {
    2.   "meta": {
    3.     "limit": 20,
    4.     "next": null,
    5.     "offset": 0,
    6.     "previous": null,
    7.     "total_count": 1
    8.   },
    9.   "objects": [{
    10.     "avatar": "https://media.ifanrusercontent.com/media/tavatar/55/c3/55c3dbebcc61891be10d29ded808c84a01dxxxxx.jpg",
    11.     "city": "Guangzhou",
    12.     "country": "China",
    13.     "created_at": 1504504504,
    14.     "gender": 1,
    15.     "id": 550xx,
    16.     "nickname": "PCG",
    17.     "openid": "onzns0KsLKFyg3-VcW0GwTE6xxxx",
    18.     "unionid": "onzns0KsLKFyg3-VcW0GwTE6xxxx",
    19.     "province": "Guangdong",
    20.     "user_group": [
    21.       137
    22.     ],
    23.     "user_id": 366197xx
    24.   }]
    25. }