项目受试者列表
该API接口可以获取某个项目的项目全部受试者列表。
请求
URL:https://BASE_URL/subjects
访问方式:GET
其中,BASE_URL详见 API通用规则 说明,下文将不再一一赘述。
请求示例:
https://edc-api.totrial.com/v1/subjects?pid=a2d0afcb980bc16e91c075cd2f3b6775&access-token=67b35797bfab390f7256e4f8d170a433
参数说明
| 参数 | 数据类型 | 参数说明 | 是否必须 | 额外说明 | 示例 |
|---|---|---|---|---|---|
| access-token | string | API Key | 是 | 认证授权密钥 | 67b35797bfab390f7256e4f8d170a433 |
| pid | string | 项目唯一标识号 | 是 | 项目ID | a2d0afcb980bc16e91c075cd2f3b6775 |
| pageSize | integer | 每页记录数量 | 否 | 默认值为20 | 20 |
| page | integer | 页码 | 否 | 默认值为1 | 1 |
响应
| 名称 | 数据类型 | 说明 |
|---|---|---|
| items | array | 受试者列表,多个item组成的数组,item解释详见某个受试者基本信息 |
| _links | object | _links对象 |
| _meta | object | 分页对象,包含下列属性: totalCount:总记录数量;pageCount:总分页数; currentPage:当前页码;perPage:每页记录数量 |
_links
| 名称 | 数据类型 | 说明 |
|---|---|---|
| self | object | 当前请求的url对象,包含以下属性:href,url字符串 |
| next | object | 下一页的url对象,包含以下属性:href,url字符串 |
| last | object | 最后一页的url对象,包含以下属性:href,url字符串 |
XML响应示例
<response>
<items>
<item>
<seq>186</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>002</screenid>
<subjid/>
<name>MYR</name>
<registration_date>2016-10-18</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>187</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>001</screenid>
<subjid/>
<name>FGZ</name>
<registration_date>2016-11-02</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>188</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>003</screenid>
<subjid/>
<name>LKX</name>
<registration_date>2016-11-02</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>189</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>004</screenid>
<subjid/>
<name>LGY</name>
<registration_date>2016-11-02</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>190</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>005</screenid>
<subjid/>
<name>LZH</name>
<registration_date>2016-11-02</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>192</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>006</screenid>
<subjid/>
<name>LSJ</name>
<registration_date>2016-11-02</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>193</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>007</screenid>
<subjid/>
<name>ZXT</name>
<registration_date>2016-11-02</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>197</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>008</screenid>
<subjid/>
<name>XGL</name>
<registration_date>2016-11-02</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>198</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>009</screenid>
<subjid/>
<name>YDL</name>
<registration_date>2016-11-02</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>199</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>010</screenid>
<subjid/>
<name>GXY</name>
<registration_date>2016-11-02</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>200</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>011</screenid>
<subjid/>
<name>WYH</name>
<registration_date>2016-11-04</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>201</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>012</screenid>
<subjid/>
<name>CRZ</name>
<registration_date>2016-11-04</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>202</seq>
<cid>31</cid>
<invid>05</invid>
<site>XXXXXXXXX医院</site>
<screenid>003</screenid>
<subjid/>
<name>LCR</name>
<registration_date>2016-11-05</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>203</seq>
<cid>31</cid>
<invid>05</invid>
<site>XXXXXXXXX医院</site>
<screenid>005</screenid>
<subjid/>
<name>X-J</name>
<registration_date>2016-11-05</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>204</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>013</screenid>
<subjid/>
<name>W-P</name>
<registration_date>2016-11-07</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>205</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>013</screenid>
<subjid/>
<name>W-P</name>
<registration_date>2016-11-07</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>206</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>014</screenid>
<subjid/>
<name>YFQ</name>
<registration_date>2016-11-07</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>207</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>015</screenid>
<subjid/>
<name>WWX</name>
<registration_date>2016-11-07</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>208</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>016</screenid>
<subjid/>
<name>L-Y</name>
<registration_date>2016-11-07</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
<item>
<seq>209</seq>
<cid>31</cid>
<invid>01</invid>
<site>XXXXXXXXX医院</site>
<screenid>017</screenid>
<subjid/>
<name>ZCZ</name>
<registration_date>2016-11-08</registration_date>
<status>1</status>
<updated_at>1478673194</updated_at>
</item>
</items>
<_links>
<self>
<href>
https://edc-api.totrial.com/v1/sites?pid=a2d0afcb980bc16e91c075cd2f3b6775&access-token=67b35797bfab390f7256e4f8d170a433&page=1
</href>
</self>
<next>
<href>
https://edc-api.totrial.com/v1/sites?pid=a2d0afcb980bc16e91c075cd2f3b6775&access-token=67b35797bfab390f7256e4f8d170a433&page=2
</href>
</next>
<last>
<href>
https://edc-api.totrial.com/v1/sites?pid=a2d0afcb980bc16e91c075cd2f3b6775&access-token=67b35797bfab390f7256e4f8d170a433&page=10
</href>
</last>
</_links>
<_meta>
<totalCount>196</totalCount>
<pageCount>10</pageCount>
<currentPage>1</currentPage>
<perPage>20</perPage>
</_meta>
</response>
Json响应示例
{
"items": [
{
"seq": 186,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "002",
"subjid": null,
"name": "MYR",
"registration_date": "2016-10-18",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 187,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "001",
"subjid": null,
"name": "FGZ",
"registration_date": "2016-11-02",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 188,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "003",
"subjid": null,
"name": "LKX",
"registration_date": "2016-11-02",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 189,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "004",
"subjid": null,
"name": "LGY",
"registration_date": "2016-11-02",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 190,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "005",
"subjid": null,
"name": "LZH",
"registration_date": "2016-11-02",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 192,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "006",
"subjid": null,
"name": "LSJ",
"registration_date": "2016-11-02",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 193,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "007",
"subjid": null,
"name": "ZXT",
"registration_date": "2016-11-02",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 197,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "008",
"subjid": null,
"name": "XGL",
"registration_date": "2016-11-02",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 198,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "009",
"subjid": null,
"name": "YDL",
"registration_date": "2016-11-02",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 199,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "010",
"subjid": null,
"name": "GXY",
"registration_date": "2016-11-02",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 200,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "011",
"subjid": null,
"name": "WYH",
"registration_date": "2016-11-04",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 201,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "012",
"subjid": null,
"name": "CRZ",
"registration_date": "2016-11-04",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 202,
"invid": "05",
"site": "XXXXXXXXX医院",
"screenid": "003",
"subjid": null,
"name": "LCR",
"registration_date": "2016-11-05",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 203,
"invid": "05",
"site": "XXXXXXXXX医院",
"screenid": "005",
"subjid": null,
"name": "X-J",
"registration_date": "2016-11-05",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 204,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "013",
"subjid": null,
"name": "W-P",
"registration_date": "2016-11-07",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 205,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "013",
"subjid": null,
"name": "W-P",
"registration_date": "2016-11-07",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 206,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "014",
"subjid": null,
"name": "YFQ",
"registration_date": "2016-11-07",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 207,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "015",
"subjid": null,
"name": "WWX",
"registration_date": "2016-11-07",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 208,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "016",
"subjid": null,
"name": "L-Y",
"registration_date": "2016-11-07",
"status": 1,
"updated_at": 1463985446
},
{
"seq": 209,
"invid": "01",
"site": "XXXXXXXXX医院",
"screenid": "017",
"subjid": null,
"name": "ZCZ",
"registration_date": "2016-11-08",
"status": 1,
"updated_at": 1463985446
}
],
"_links": {
"self": {
"href": "https://edc-api.totrial.com/v1/subjects?pid=a2d0afcb980bc16e91c075cd2f3b6775&access-token=67b35797bfab390f7256e4f8d170a433&page=1"
},
"next": {
"href": "https://edc-api.totrial.com/v1/subjects?pid=a2d0afcb980bc16e91c075cd2f3b6775&access-token=67b35797bfab390f7256e4f8d170a433&page=2"
},
"last": {
"href": "https://edc-api.totrial.com/v1/subjects?pid=a2d0afcb980bc16e91c075cd2f3b6775&access-token=67b35797bfab390f7256e4f8d170a433&page=10"
}
},
"_meta": {
"totalCount": 196,
"pageCount": 10,
"currentPage": 1,
"perPage": 20
}
}