查询用户签约列表 
商户使用本接口来查询用户签约信息,返回用户在该签约模板下的合约列表(包括处于「已解约」状态下的合约);被用户主动删除的合约无法被查询到。结果中「已签约」合约排列于「已解约」合约之前。
| 请求参数 | 类型 | 描述 | 
|---|---|---|
| openid | string | 商户appid下的用户标识 | 
| query | object | 声明请求的查询参数 | 
| plan_id | string | 签约模板号 | 
| contract_status | string | 签约状态 | 
| offset | integer | 分页页码 | 
| limit | integer | 分页大小 | 
php
$instance->v3->eduschoolpay->users->_openid_->contracts->getAsync([
  'openid' => 'oUpF8uMuAJOM2pxb1Q',
  'query' => [
    'plan_id'         => '101164396123311331',
    'contract_status' => 'ADD',
    'offset'          => 0,
    'limit'           => 20,
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();php
$instance->chain('v3/eduschoolpay/users/{openid}/contracts')->getAsync([
  'openid' => 'oUpF8uMuAJOM2pxb1Q',
  'query' => [
    'plan_id'         => '101164396123311331',
    'contract_status' => 'ADD',
    'offset'          => 0,
    'limit'           => 20,
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();php
$instance['v3/eduschoolpay/users/{openid}/contracts']->getAsync([
  'openid' => 'oUpF8uMuAJOM2pxb1Q',
  'query' => [
    'plan_id'         => '101164396123311331',
    'contract_status' => 'ADD',
    'offset'          => 0,
    'limit'           => 20,
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();php
$response = $instance->v3->eduschoolpay->users->_openid_->contracts->get([
  'openid' => 'oUpF8uMuAJOM2pxb1Q',
  'query' => [
    'plan_id'         => '101164396123311331',
    'contract_status' => 'ADD',
    'offset'          => 0,
    'limit'           => 20,
  ],
]);
print_r(json_decode((string) $response->getBody(), true));php
$response = $instance->chain('v3/eduschoolpay/users/{openid}/contracts')->get([
  'openid' => 'oUpF8uMuAJOM2pxb1Q',
  'query' => [
    'plan_id'         => '101164396123311331',
    'contract_status' => 'ADD',
    'offset'          => 0,
    'limit'           => 20,
  ],
]);
print_r(json_decode((string) $response->getBody(), true));php
$response = $instance['v3/eduschoolpay/users/{openid}/contracts']->get([
  'openid' => 'oUpF8uMuAJOM2pxb1Q',
  'query' => [
    'plan_id'         => '101164396123311331',
    'contract_status' => 'ADD',
    'offset'          => 0,
    'limit'           => 20,
  ],
]);
print_r(json_decode((string) $response->getBody(), true));| 返回字典 | 类型 | 描述 | 
|---|---|---|
| data | object[] | 查询结果列表 | 
| contract_id | string | 签约协议号 | 
| mchid | string | 商户号 | 
| appid | string | 商户appid | 
| openid | string | 商户appid下的用户标识 | 
| plan_id | string | 签约模板号 | 
| contract_status | string | 签约状态 | 
| create_time | string | 签约时间 | 
| out_contract_code | string | 外部签约号 | 
| offset | integer | 请求资源起始位置 | 
| limit | integer | 最大资源条数 | 
| total_count | integer | 资源总条数 | 
| links | object | 相关链接 | 
| next | string | 下一页链接 | 
| prev | string | 上一页链接 | 
| self | string | 当前链接 | 
参阅 官方文档