开放文档 - 唯思派

当前位置：首页 > 开放文档 > 机构用户

注意事项:

本文以期刊论文类型为示例(目前暂支持期刊论文、临床指南、药典, 其它类型的求助功能待开放, 请及时关注公众号)
示例代码语言主要有: GO、PHP、Python, 其它语言请使用AI工具进行转换
用户可以通过客服申请机构码, 然后通过后端程序生成求助发布链接, 直接跳转到发布求助页面
如果机构密钥泄露可以通过机构后台重新生成

文献类型和必传参数:

参数/文献类型	期刊论文	临床指南	药典
文献类型参数	type_id=1	type_id=7	type_id=8
文献信息参数	journal_doi=10.1001/xxxx(文献的doi)	title=xxxx(标题) clinical_organization=xxxx(制定机构/来源) clinical_year=xxxx(发布年份)	title=xxxx(药品名) pharmacopeia_source=xxxx(来源药典) pharmacopeia_version=xxxx(发布版本)

校验值由机构码、机构用户码、时间戳、文献类型参数、文献信息参数(按照上表文献信息参数位置和参数名)拼接通过md5加密, 再拼接机构密钥md5加密而成
生成的URL参数由机构码、机构用户码、时间戳、文献类型参数、文献信息参数和校验值构成缺一不可
当生成的链接有效时, 在发布页面可以看到会按照以下提示信息:

go代码示例:

package main

import (
    "crypto/md5"
    "encoding/hex"
    "fmt"
    "net/url"
    "strconv"
    "time"
)

func md5Hash(s string) string {
    hasher := md5.New()
    hasher.Write([]byte(s))
    return hex.EncodeToString(hasher.Sum(nil))
}

func createURL(uid, typeID string, info map[string]string) string {
    domain := "https://www.wispass.com/posthelp?"
    institutionKey := "KjYnR4BFAf8dh9BnxeP26izRwW2SG36k"
    institutionCode := "MEnn8Gzf1h69KH08kjJeF4ZCjcrDSy5f"
    institutionUID := uid
    t := strconv.FormatInt(time.Now().Unix(), 10)

// 生成签名
    tempSign := institutionCode + institutionUID + t + typeID
    for _, value := range info {
        tempSign += value
    }
    sign := md5Hash(md5Hash(tempSign) + institutionKey)

// 创建 URL 参数
    params := url.Values{}
    params.Set("institution_code", institutionCode)
    params.Set("institution_uid", institutionUID)
    params.Set("t", t)
    params.Set("type_id", typeID)
    for key, value := range info {
        params.Set(key, value)
    }
    params.Set("sign", sign)

return domain + params.Encode()
}

func main() {
    // 期刊论文
    uid := "xxxxxx"
    typeID := "1"
    info1 := map[string]string{"journal_doi": "10.1038/s41587-023-02115-w"}
    fmt.Println(createURL(uid, typeID, info1))

// 临床指南
    uid = "xxxxxx"
    typeID = "7"
    info2 := map[string]string{
        "title":                 "2023 意大利指南：无功能的良性和局部症状性甲状腺结节的管理",
        "clinical_organization": "Endocr Metab Immune Disord Drug Targets . 2023 Feb 1.",
        "clinical_year":         "2023年",
    }
    fmt.Println(createURL(uid, typeID, info2))

// 药典
    uid = "xxxxxx"
    typeID = "8"
    info3 := map[string]string{
        "title":                "USP Monographs: Desoximetasone Ointment",
        "pharmacopeia_source":  "美国药典",
        "pharmacopeia_version": "USP38-NF33 S2",
    }
    fmt.Println(createURL(uid, typeID, info3))
}

php代码示例:

<?php
function md5Hash($string) {
    // 对字符串进行 md5 加密
    return md5($string);
}

function createUrl($uid, $typeId, $info) {
    $domain = "https://www.wispass.com/posthelp?";
    $institutionKey = "KjYnR4BFAf8dh9BnxeP26izRwW2SG36k";
    $institutionCode = "MEnn8Gzf1h69KH08kjJeF4ZCjcrDSy5f";
    $institutionUid = $uid;
    $t = time();  // 当前时间戳

// 生成签名
    $tempSign = $institutionCode . $institutionUid . $t . $typeId . implode('', $info);
    $sign = md5Hash(md5Hash($tempSign) . $institutionKey);

// 创建 URL 参数
    $param = [
        'institution_code' => $institutionCode,
        'institution_uid' => $institutionUid,
        't' => $t,
        'type_id' => $typeId,
        'sign' => $sign,
    ];

// 合并 info 参数
    $param = array_merge($param, $info);

// URL 编码并构建最终的 URL
    $queryString = http_build_query($param);
    return $domain . $queryString;
}

// 测试代码
if (true) {
    // 期刊论文
    $uid = "xxxxxx";
    $typeId = "1";
    $info = ['journal_doi' => "10.1038/s41587-023-02115-w"];
    echo createUrl($uid, $typeId, $info) . "\n";

// 临床指南
    $uid = "xxxxxx";
    $typeId = "7";
    $info = [
        'title' => "2023 意大利指南：无功能的良性和局部症状性甲状腺结节的管理",
        'clinical_organization' => "Endocr Metab Immune Disord Drug Targets . 2023 Feb 1.",
        'clinical_year' => "2023年",
    ];
    echo createUrl($uid, $typeId, $info) . "\n";

// 药典
    $uid = "xxxxxx";
    $typeId = "8";
    $info = [
        'title' => "USP Monographs: Desoximetasone Ointment",
        'pharmacopeia_source' => "美国药典",
        'pharmacopeia_version' => "USP38-NF33 S2",
    ];
    echo createUrl($uid, $typeId, $info) . "\n";
}
?>

python代码示例:

from urllib.parse import quote
from time import time
import hashlib

def md5(string: str) -> str:
    """对字符串进行md5加密"""
    return hashlib.md5(string.encode('utf-8')).hexdigest()

def create_url(uid: str, type_id: str, info: dict) -> str:
    """
    参数:
    uid: 用户在机构的唯一识别码, 不能为空, 长度不能超过50个字符
    type_id: 求助的文献类型
    info: 传入的参数信息
    """
    domain = "https://www.wispass.com/posthelp?"
    institution_key = "KjYnR4BFAf8dh9BnxeP26izRwW2SG36k"
    institution_code = "MEnn8Gzf1h69KH08kjJeF4ZCjcrDSy5f"
    institution_uid = uid
    t = str(int(time()))
    # 在此生成的签名的参数位置不能随意变动, 只能按照示例进行代码的位置生成
    temp_sign = md5(str().join([institution_code, institution_uid, t, type_id] + list(info.values())))
    sign = md5(temp_sign + institution_key)
    param = dict(
        institution_code=institution_code,
        institution_uid=institution_uid,
        t=t, type_id=type_id, **info, sign=sign)
    return domain + "&".join([f"{key}={quote(value)}" for key, value in param.items()])

if __name__ == "__main__":
    # 期刊论文
    uid = "xxxxxx"
    type_id = "1"
    info = dict(journal_doi="10.1038/s41587-023-02115-w")
    print(create_url(uid, type_id, info))
    # 临床指南
    uid = "xxxxxx"
    type_id = "7"
    info = dict(title="2023 意大利指南：无功能的良性和局部症状性甲状腺结节的管理",
    clinical_organization="Endocr Metab Immune Disord Drug Targets . 2023 Feb 1.",
    clinical_year="2023年")
    print(create_url(uid, type_id, info))
    # 药典
    uid = "xxxxxx"
    type_id = "8"
    info = dict(title="USP Monographs: Desoximetasone Ointment",
    pharmacopeia_source="美国药典",
    pharmacopeia_version="USP38-NF33 S2")
    print(create_url(uid, type_id, info))

注意事项:

go代码示例:

php代码示例:

python代码示例:

wispass工作室 Copyright © 蜀ICP备2024051606号-2 www.wispass.com