API Agreement

3 min read

interface address

The unified interface address and request method of the new development platform provide a unified HTTP POST request method call
Gateway address https://open.duomai.com/apis

Public parameters

Parameter name	Is it necessary	Example	Remarks
app_key	yes	2312521	Media application appkey original siteid
timestamp	yes	1596592757	Second-level timestamp
service	yes	cps-mesh.cpslink.links.post	interface service name
sign	yes	5D17CCCD5B29F98171D6D0D43136B366	sign

Signing process

The following is an example of the calling process by promoting the transfer chain

Parameter example

//Common Parameter
app_key=test&timestamp=1596699247&service=cps-mesh.cpslink.links.post
//API Parameter
{"url":"https://www.jd.com","site_id":"27"}

1. Sort the requested public parameters in lexicographic order and then key+value splicing

app_keytestservicecps-mesh.cpslink.links.posttimestamp1596699247

2. The post request json parameters are spliced at the end, please ignore the GET request

app_keytestservicecps-mesh.cpslink.links.posttimestamp1596699247 {"url":"https://www.jd.com","site_id":"27"}

3. Splicing on both sides app_secret=(media push hash) View hash

app_secretapp_keytestservicecps-mesh.cpslink.links.posttimestamp 1596699247app_secret

4. Convert the signature string MD5 to uppercase to get the sign signature parameter

1326B1AA19903FC2DBCB9AF8CB365A10

5. Splice the public parameters as Query parameters to get the request url

https://open.duomai.com/apis?app_key=test×tamp=1596699247&service=cps-mesh.cpslink.links.post&sign=1326B1AA19903FC2DBCB9AF8CB365A10

6. Set HTTP request header information, and use API parameters as JSON BODY

POST /apis?app_key=test&timestamp=1596699247&service=cps-mesh.cpslink.links.post&sign=1326B1AA19903FC2DBCB9AF8CB365A10 HTTP/1.1
Host: open.duomai.com
Content-Type: application/json

{"url":"https://www.jd.com","site_id":"27"}

Code example

php

    $appKey = "your siteId";
    $appSecret = "your hash";
    $header = [
        "Content-Type" => "application/json"
    ];
    $query = [
        "app_key" => $appKey,
        "timestamp" => time(),
        "service"=> "cps-mesh.cpslink.links.post"
    ];
    ksort($query);
    $signStr = '';
    foreach ($query as $kev => $val) {
        $signStr .= $kev . $val;
    }
    $body = json_encode([
        "url"=>"https://www.jd.com",
        "site_id"=>"27",
    ]);
    $query["sign"] = strtoupper(md5($appSecret . $signStr . $body . $appSecret));
    try {
        $client = new \GuzzleHttp\Client();
        $response = $client->request('POST', "https://open.duomai.com/apis", [
            "verify"=>false,
            "headers" => $header,
            "query" => $query,
            "body"=> $body
        ]);
    } catch (ClientException $e) {
        $response = $e->getResponse();
    }
    echo $response->getStatusCode();
    echo $response->getHeaderLine('content-type');
    echo $response->getBody()->getContents();die;

golang

    AppKey := "test"
    AppSecret := "test"
    Router:= "https://open.duomai.com/apis/"
    Service:="cps-mesh.cpslink.links.post"
    var body []byte
    params := map[string]string{
        "url":"https://www.jd.com",
        "site_id":"27",
    }
    body,_ = json.Marshal(params)

    nowTime := time.Now().Local()
    // 设置get参数
    val := url.Values{}
    val.Set("timestamp", fmt.Sprintf("%d", nowTime.Unix()))
    val.Set("app_key", AppKey)
    val.Set("service", Service)
    var buf strings.Builder
    keys := make([]string, 0, len(val))
    for k := range val {
        keys = append(keys, k)
    }
    sort.Strings(keys)
    for _, k := range keys {
        vs := val[k]
        keyEscaped := url.QueryEscape(k)
        for _, v := range vs {
            buf.WriteString(keyEscaped)
            buf.WriteString(url.QueryEscape(v))
        }
    }
    // 签名string
    signStr := fmt.Sprintf("%s%s%s%s", AppSecret, buf.String(), string(body), AppSecret)
    // 设置签名
    hash := md5.New()
    hash.Write([]byte(signStr))
    val.Set("sign", strings.ToUpper(fmt.Sprintf("%x", hash.Sum(nil))))
    // 请求
    reqest, _ := http.NewRequest("POST", fmt.Sprintf("%s%s?%s", Router, Service, val.Encode()), bytes.NewBuffer(body))
    reqest.Header.Add("Content-Type", "application/json")
    httpClient := &http.Client{}
    var response *http.Response
    response, err := httpClient.Do(reqest)
    if err != nil {
        return
    }
    defer response.Body.Close()
    byteData, err := ioutil.ReadAll(response.Body)

DuoMai

Open Platform