# Get the ClassIn client download address

**![!deprecated](../img/waring.png)warning：This interface has been deprecated and will be deleted in future releases**

_Alternative interfaces are recommended： [ClassIn Download Button link](iframe.md)._

Get the ClassIn client download address，need SID，safekey，timeStamp，Returns the download address of the current system version.

## URL

`https://api.eeo.cn/partner/api/course.api.php?action=getDownloadUrl`

## HTTP Request Methods

- POST

## Coding format

- UTF-8

## Request data

| key | Required | More Restrictions  |	Instructions | Description
| ----| ----|----|----| ----- |
| SID | Yes | Null |	School ID	| It is available through the eeo.cn application
| safeKey |	Yes | Fixed 32-bit all lowercase characters  | School authentication security key |	safeKey=MD5(SECRET+timeStamp)
| timeStamp	| Yes | Null | imestamp used by safeKey | Unix Epoch timeStamp is the number of seconds passed by 00:00 (world standard time) on January 1, 1970


## Response data

| key | Type | Sample value | meaning
| ----|-----|-----| ----|
| data | object |	| Returns the data information object
| └ WinXP | string |	`https://api.eeo.cn/download/...` |	WinXP version
| └ Win7  | string |	`https://api.eeo.cn/download/...` |	Windows 7 or above
| └ MacOS  | string |	`https://api.eeo.cn/download/...` |	MacOS version
| └ CloudWinXP  | string |	`https://www.baidu.com/s/...` |	Cloud dirver down WinXP version
| └ CloudWin7  | string |	`https://www.baidu.com/s/...` |	Cloud dirver down Win7 version
| └ CloudMacOS  | string |	`https://www.baidu.com/s/...` |	loud dirver down MacOS version
| error_info | 	object |	|	Return message object
| └ errno |	number |	1	 | The error code
| └ error |	string |	"Normal execution" |	Error list


## Sample

- HTTP request

```http
POST /partner/api/course.api.php?action=getDownloadUrl HTTP/1.1
Host: www.eeo.cn
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

SID=2339736&safeKey=8d3fb00ceddd29638e2d5dd12d69841d&timeStamp=1492793638
```

- Shell cURL analog request instruction

```bash
curl -H "Content-Type: application/x-www-form-urlencoded" -X "POST" \
      -d "SID=1234567" \
      -d "safeKey=0f7781b3033527a8cc2b1abbf45a5fd2" \
      -d "timeStamp=1484719085" \
      "https://api.eeo.cn/partner/api/course.api.php?action=getDownloadUrl"
```



## Response sample（The normal return ` json ` packet example）

```json
{
  "data": {
    "WinXP": "https://api.eeo.cn/download/...",
    "Win7": "https://api.eeo.cn/download/...",
    "MacOS": "https://api.eeo.cn/download/...",
    "CloudWinXP": "https://www.baidu.com/s/...",
    "CloudWin7": "https://www.baidu.com/s/...",
    "CloudMacOS": "https://www.baidu.com/s/...",
  },
  "error_info": {
    "errno": 1,
    "error": "程序正常执行"
  }
}
```
<!-- ## Results the preview：

[ClassIn Win7 Download button](https://api.eeo.cn/download/classin_win_install_1.6.3.1_s.exe)

[ClassIn WinXP Download button](https://api.eeo.cn/download/classin_winxp_install_1.6.3.1_s.exe)

[ClassIn MacOS Download button](https://api.eeo.cn/download/classin_mac_install_1.6.3.1_s.dmg)

[ClassIn iOS Download url](http://m.eeo.cn/download.html)

## Instructions for use：

#### Copy the following code to the &lt;body&gt; tag of your site page, where &lt;a&gt; link is replaced with your download button, and please ensure that the &lt;a&gt; tag [data-id] attribute is consistent


```
  <a data-id="classInDownLoad_win7">ClassIn win7 Download button</a>
  <a data-id="classInDownLoad_winxp">ClassIn winxp Download button</a>
  <a data-id="classInDownLoad_macOS">ClassIn macOS Download button</a>
  <a data-id="classInDownLoad_iOS">ClassIn iOS Download button</a>
  <script type="text/javascript" charset="utf-8" src="https://api.eeo.cn/partner/api/geturl_classindownload.js"></script>
``` -->

## Error code instruction

| Error code|	Instruction|
|:-------|-----|
| 1   | expression successful execution.
| 100	| expression parameter not all or error.
| 102	| expression dont have permissions（Security verification failed）.