https://open.caiyunapp.com/api.php?action=feedcontributions&feedformat=atom&user=XTao
Caiyun Wiki - User contributions [en]
2026-05-25T06:20:27Z
User contributions
MediaWiki 1.30.0
https://open.caiyunapp.com/index.php?title=%E5%BD%A9%E4%BA%91%E5%A4%A9%E6%B0%94_API/v2.5&diff=5544
彩云天气 API/v2.5
2020-02-24T06:56:17Z
<p>XTao: /* API 降水强度对照 */</p>
<hr />
<div>{{彩云天气 API 版本状态}}<br />
<br />
== 数据覆盖范围 ==<br />
<br />
=== 天气数据覆盖区域 ===<br />
# 小时级和天级天气数据覆盖全球任意经纬度；<br />
# 分钟级降水数据覆盖中国大陆及港澳、台湾、钓鱼岛、南沙群岛、韩国、朝鲜、美国、欧洲南部、日本。国内城市提供城市和经纬度对照表。即将开通东南亚、印度。<br />
<br />
=== 空气质量数据覆盖区域 ===<br />
<br />
中国全境。即将开通全球。<br />
<br />
==状态==<br />
状态：继承v2.4，本版本已经是稳定版本。<br />
<br />
* [[实况天气接口/v2.5|实况天气接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</code><br />
<br />
* 分钟级+小时级+天级预报接口 <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/forecast.json</code><br />
* [[分钟级降雨预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</code><br />
* [[小时级预报接口/v2.5|小时级预报接口]]：[https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json <code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</code>]<br />
* [[天级预报接口/v2.5|天级预报接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</code><br />
* [[通用预报接口/v2.5|通用点数据接口]]：<code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code><br />
<br />
== 数据类型及预报时长 ==<br />
<br />
=== 数据类型 ===<br />
{| class="wikitable"<br />
|'''数据类型'''<br />
|'''描述'''<br />
|-<br />
|'''实时数据'''<br />
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型<br />
|-<br />
|'''分钟级降水数据'''<br />
|未来两小时每分钟降水强度及每半小时降水概率、未来两小时降水情况的自然语言描述<br />
|-<br />
|'''逐小时数据'''<br />
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型及未来 24 小时自然语言描述<br />
|-<br />
|'''逐日数据'''<br />
|温度、湿度、风向、风速、气压、云量、降水量（mm／h）／降水强度、PM 2.5、AQI、天气类型、日出日落时间、生活指数<br />
|-<br />
|'''生活指数'''<br />
|穿衣、洗车、感冒、紫外线<br />
|-<br />
|'''预警信息'''<br />
<br />
'''（同步于中央气象台）'''<br />
|台风、暴雨、暴雪、寒潮、大风、沙尘暴、高温、干旱、雷电、冰雹、霜冻、大雾、霾、道路结冰<br />
|}<br />
<br />
=== 预报时长 ===<br />
{| class="wikitable"<br />
|'''数据类型'''<br />
|'''描述'''<br />
|-<br />
|'''分钟级降水数据'''<br />
|未来两小时逐分钟<br />
|-<br />
|'''逐小时数据'''<br />
|未来十五天逐小时<br />
|-<br />
|'''逐日数据'''<br />
|未来十五天逐日<br />
|-<br />
|'''空气质量(AQI 和 PM2.5) '''<br />
|未来十五天逐小时<br />
|-<br />
|'''生活指数'''<br />
|未来十五天逐日<br />
|}<br />
<br />
注：并不表示我们会向所有类型的 API 用户提供所列全部数据。彩云API预报接口默认返回5天数据，如果需15天数据需要增加参数，可在URL后增加参数 <code>dailysteps=15&hourlysteps=360</code> 来控制返回预报时长。<br />
<br />
== API 降水强度对照 ==<br />
<br />
=== 降水强度对照表 ===<br />
{| class="wikitable"<br />
|'''降水强度值'''<br />
|'''降水量数值 mm／h'''<br />
|'''天气现象'''<br />
|-<br />
|'''<0.031'''<br />
|'''<0.08'''<br />
|无雨／雪<br />
|-<br />
|'''0.031～0.25'''<br />
|'''0.08~3.44'''<br />
|小雨／雪<br />
|-<br />
|'''0.25～0.35'''<br />
|'''3.44~11.33'''<br />
|中雨／雪<br />
|-<br />
|'''0.35～0.48'''<br />
|'''11.33~51.30'''<br />
|大雨／雪<br />
|-<br />
|'''>=0.48'''<br />
|'''>=51.30'''<br />
|暴雨／雪<br />
|}<br />
注：<br />
# 雨雪相态判断使用 SKYCON 表示，<code>RAIN</code> 表示雨，<code>SNOW</code> 表示雪。<br />
# API 默认返回降水强度，如果需要 API 返回降水量需要在 API URL 增加参数 <code>unit=metric:v2</code><br />
如：https://api.caiyunapp.com/v2.5/your_token/121.4750,24.7695/forecast?unit=metric:v2<br />
<br />
== AQI数据基本对照表 ==<br />
{| class="wikitable"<br />
|'''AQI数值'''<br />
|'''空气质量等级'''<br />
|-<br />
|'''0 ~50'''<br />
|优<br />
|-<br />
|'''50~100'''<br />
|良<br />
|-<br />
|'''100~150'''<br />
|轻度污染<br />
|-<br />
|'''150~200'''<br />
|中度污染<br />
|-<br />
|'''>200'''<br />
|重度污染<br />
|}<br />
<br />
== 预报数据更新频率 ==<br />
<br />
{| class="wikitable"<br />
|'''数据类型'''<br />
|'''频率'''<br />
|-<br />
|'''实况天气数据'''<br />
|1 分钟<br />
|-<br />
|'''分钟级天气预报数据'''<br />
|1 分钟<br />
|-<br />
|'''小时级天气预报数据'''<br />
|15 分钟<br />
|-<br />
|'''天级天气预报数据'''<br />
|2 小时<br />
|-<br />
|'''PM 2.5 / AQI 数据'''<br />
|1 小时<br />
|}<br />
注：采用多数据源校正数据，每个数据源的更新频率不同，小时级和天级预报更新频率为综合测算估值。<br />
<br />
== 预报数据地域精度 ==<br />
{| class="wikitable"<br />
|'''数据类型'''<br />
|'''精度'''<br />
|-<br />
|'''分钟级预报'''<br />
|<br />
|-<br />
|'''小时级预报'''<br />
|<br />
|-<br />
|'''天级预报'''<br />
|<br />
|-<br />
|'''PM 2.5 / AQI 数据'''<br />
|5 km*5 km<br />
|}<br />
注：采用多数据源校正数据，每个数据源的地域精度不同，小时级和天级预报地域精度为综合测算估值。<br />
<br />
== 风力风速风向等级对照表 ==<br />
<br />
'''风力等级对照表'''<br />
<br />
{| class="wikitable"<br />
|'''风力等级'''<br />
|'''风速范围 （km/h）'''<br />
|'''自然语言描述'''<br />
|-<br />
|'''0级'''<br />
|<1<br />
|无风<br />
|-<br />
|'''1级'''<br />
|1-5<br />
|微风徐徐<br />
|-<br />
|'''2级'''<br />
|6-11<br />
|清风<br />
|-<br />
|'''3级'''<br />
|12-19<br />
|树叶摇摆<br />
|-<br />
|'''4级'''<br />
|20-28<br />
|树枝摇动<br />
|-<br />
|'''5级'''<br />
|29-38<br />
|风力强劲<br />
|-<br />
|'''6级'''<br />
|39-49<br />
|风力强劲<br />
|-<br />
|'''7级'''<br />
|50-61<br />
|风力超强<br />
|-<br />
|'''8级'''<br />
|62-74<br />
|狂风大作<br />
|-<br />
|'''9级'''<br />
|75-88<br />
|狂风呼啸<br />
|-<br />
|'''10级'''<br />
|89-102<br />
|暴风毁树<br />
|-<br />
|'''11级'''<br />
|103-117<br />
|暴风毁树<br />
|-<br />
|'''12级'''<br />
|118-133<br />
|飓风<br />
|-<br />
|'''13级'''<br />
|134-149<br />
|台风<br />
|-<br />
|'''14级'''<br />
|150-166<br />
|强台风<br />
|-<br />
|'''15级'''<br />
|167-183<br />
|强台风<br />
|-<br />
|'''16级'''<br />
|184-201<br />
|超强台风<br />
|-<br />
|'''17级'''<br />
|202-220<br />
|超强台风<br />
|}<br />
<br />
'''风向对照表'''<br />
<br />
{| class="wikitable"<br />
|'''风向'''<br />
|'''符号'''<br />
|'''中心角度'''<br />
|'''角度'''<br />
|-<br />
|'''北'''<br />
|N<br />
|0<br />
|348.76-11.25<br />
|-<br />
|'''北东北'''<br />
|NNE<br />
|22.5<br />
|11.26-33.75<br />
|-<br />
|'''东北'''<br />
|NE<br />
|45<br />
|33.76-56.25<br />
|-<br />
|'''东东北'''<br />
|ENE<br />
|67.5<br />
|56.26-78.75<br />
|-<br />
|'''东'''<br />
|E<br />
|90<br />
|78.76-101.25<br />
|-<br />
|'''东东南'''<br />
|ESE<br />
|112.5<br />
|101.26-123.75<br />
|-<br />
|'''东南'''<br />
|SE<br />
|135<br />
|123.76-146.25<br />
|-<br />
|'''南东南'''<br />
|SSE<br />
|157.5<br />
|146.26-168.75<br />
|-<br />
|'''南'''<br />
|S<br />
|180<br />
|168.76-191.25<br />
|-<br />
|'''南西南'''<br />
| SSW<br />
|202.5<br />
|191.26-213.75<br />
|-<br />
|'''西南'''<br />
|SW<br />
|225<br />
|213.76-236.25 <br />
|-<br />
|'''西西南'''<br />
|WSW<br />
|247.5<br />
|236.26-258.75<br />
|-<br />
|'''西'''<br />
|W<br />
|270<br />
|258.76-281.25<br />
|-<br />
|'''西西北'''<br />
|WNW<br />
|295.5<br />
|281.26-303.75<br />
|-<br />
|'''西北'''<br />
|NW<br />
|315<br />
|303.76-326.25<br />
|-<br />
|'''北西北'''<br />
|NNW<br />
|337.5<br />
|326.26-348.75<br />
|}<br />
<br />
== 天气预警 ==<br />
<br />
获取天气预警信息，需要在API接口后增加参数：alert=true <br />
<br />
增加参数以后，返回的数据里会增加：alert:{} 字段 <br />
<br />
预警信息类型取 code 字段'''前两位'''<br />
<br />
预警类型编码对照表：<br />
<br />
{| class="wikitable"<br />
|'''预警级别'''<br />
|'''级别编码'''<br />
|-<br />
|台风<br />
|01<br />
|-<br />
|暴雨<br />
|02<br />
|-<br />
|暴雪<br />
|03<br />
|-<br />
|寒潮<br />
|04<br />
|-<br />
|大风<br />
|05<br />
|-<br />
|沙尘暴<br />
|06<br />
|-<br />
|高温<br />
|07<br />
|-<br />
|干旱<br />
|08<br />
|-<br />
|雷电<br />
|09<br />
|-<br />
|冰雹<br />
|10<br />
|-<br />
|霜冻<br />
|11<br />
|-<br />
|大雾<br />
|12<br />
|-<br />
|霾<br />
|13<br />
|-<br />
|道路结冰<br />
|14<br />
|-<br />
|森林火灾<br />
|15<br />
|-<br />
|雷雨大风<br />
|16<br />
|}<br />
<br />
预警级别取 code 字段'''后两位'''<br />
<br />
预警级别编码对照表：<br />
{| class="wikitable"<br />
|'''预警级别'''<br />
|'''级别编码'''<br />
|-<br />
|'''蓝色'''<br />
|01<br />
|-<br />
|'''黄色'''<br />
|02<br />
|-<br />
|'''橙色'''<br />
|03<br />
|-<br />
|'''红色'''<br />
|04<br />
|}<br />
举例："code": "0901”, // 预警类型编码＋预警级别编码 '''“雷电蓝色预警”'''<br />
<br />
== 生活指数等级 ==<br />
<br />
{| class="wikitable"<br />
|'''生活指数名称'''<br />
|'''等级'''<br />
|'''等级描述'''<br />
|-<br />
| rowspan="5" |紫外线<br />
|ultraviolet1<br />
|最弱<br />
|-<br />
|ultraviolet2<br />
|弱<br />
|-<br />
|ultraviolet3<br />
|中等<br />
|-<br />
|ultraviolet4<br />
|强<br />
|-<br />
|ultraviolet5<br />
|很强<br />
|-<br />
| rowspan="4" |洗车<br />
|carWashing1<br />
|适宜<br />
|-<br />
|carWashing2<br />
|较适宜<br />
|-<br />
|carWashing3<br />
|较不适宜<br />
|-<br />
|carWashing4<br />
|不适宜<br />
|-<br />
| rowspan="9" |穿衣<br />
|dressing0<br />
|极热<br />
|-<br />
|dressing1<br />
|极热<br />
|-<br />
|dressing2<br />
|很热<br />
|-<br />
|dressing3<br />
|热<br />
|-<br />
|dressing4<br />
|温暖<br />
|-<br />
|dressing5<br />
|凉爽<br />
|-<br />
|dressing6<br />
|冷<br />
|-<br />
|dressing7<br />
|寒冷<br />
|-<br />
|dressing8<br />
|极冷<br />
|-<br />
| rowspan="4" |感冒<br />
|coldRisk1<br />
|少发<br />
|-<br />
|coldRisk2<br />
|较易发<br />
|-<br />
|coldRisk3<br />
|易发<br />
|-<br />
|coldRisk4:<br />
|极易发<br />
|}<br />
<br />
== 数据来源 ==<br />
{| class="wikitable"<br />
|'''数据类型'''<br />
|'''数据源'''<br />
|-<br />
| rowspan="5" |天气数据<br />
|中国气象科学数据共享服务网<br />
|-<br />
|台湾地区交通部中央气象局<br />
|-<br />
|美国大气与海洋管理局<br />
|-<br />
|日本气象厅<br />
|-<br />
|Open Weather Map<br />
|-<br />
|空气质量数据<br />
|PM 25.in、环保部、WMO<br />
|}<br />
<br />
== 数据 API 语言种类 ==<br />
<br />
英语、中文简体、中文繁体<br />
<br />
== 调用次数如何计算 ==<br />
<br />
用户发出一次 URL 请求并得到返回数据为一次调用<br />
<br />
== 数据坐标 ==<br />
<br />
数据所用坐标系 GCJ－02 坐标系统<br />
<br />
== 是否支持返回历史数据 ==<br />
<br />
API接口仅支持返回过去一天的历史数据，接口默认返回当前时刻到未来的数据。需要调用过去一天的数据，可以在 URL 后加参数 <code>beigin=时间戳</code> 即可。<br />
<br />
== 按区域代码adcode返回对应城市的数据 ==<br />
<br />
通用接口： http://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/weather.json?adcode=110100<br />
<br />
adcode 列表见 [[行政区域经纬度对照表]]<br />
<br />
==格式变更==<br />
*实况接口（/realtime.json）中各变量，在json中的位置，从result.xxxx变为result.realtime.xxxx<br />
<br />
*v2.4及以上版本, 生活指数相关的字段重组到 life_index 字段下<br />
<br />
*v2.4及以上版本, 空气质量相关的字段重组到 air_quality 字段下（位于realtime，hourly和daily中）<br />
*v2.2及以下版本，逐日预报时间信息是北京时间；v2.3及以上版本，逐日预报时间信息，都带了时区，和当地时区一致<br />
*v2.4及以上版本pres字段改为了pressure<br />
==特性增强==<br />
*air_quality（预报和实况）中， 增加美标和国标的AQI<br />
<br />
*air_quality（预报和实况）中，增加空气质量自然语言描述descripition六个等级，可能出现的字符串有七种:'缺数据'，'优'，'良'，'轻度污染'，'中度污染'，'重度污染'，'严重污染'<br />
*使用了新的数据融合算法，提高了十五日内逐小时降水预报准确度；<br />
*新增了雨夹雪（SLEET），雷阵雨(THUNDER_SHOWER)，雷阵雨并伴有冰雹（HAIL）3个天气现象；<br />
{{天气现象v2.5}}<br />
<br />
[[Category:API 产品]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E9%80%9A%E7%94%A8%E9%A2%84%E6%8A%A5%E6%8E%A5%E5%8F%A3/v2.5&diff=5543
通用预报接口/v2.5
2020-02-24T06:54:10Z
<p>XTao: </p>
<hr />
<div>{{彩云天气 API 版本状态}}<br />
<br />
=='''授权与认证'''==<br />
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。<br />
<br />
把您的 token 拼到 API 请求的 URL 中，如<br />
<br />
<code><br />
https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json<br />
</code><br />
<br />
其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！<br />
<br />
=='''请求样例'''==<br />
<br />
=== '''示例1如下''' ===<br />
<blockquote><code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</code><br />
<br />
</blockquote><blockquote>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.jsonp?callback=MYCALLBACK</blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote><br />
<br />
=== '''示例2如下''' ===<br />
<blockquote><code>https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/121.6544,25.1552/weather?lang=en_US</code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI） 、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''用户提供所需时区偏移秒，考虑欧美夏令时，默认东八（tzshift=28800）；例如，用户希望取得印度（东5.5区）习惯定义下的逐日天气，加参数&tzshift=19800（=3600*5.5），然后daily的计算都会做相应处理。</blockquote><blockquote>'''定制返回的起始时间戳 begin'''：默认为当前utc时间戳，可以用来返回两日内的历史数据</blockquote><blockquote>'''定制返回逐小时预报总小时数 hourlysteps'''：默认为48小时（包括当前时刻）</blockquote><blockquote>'''定制返回逐日预报总天数 dailysteps'''：默认为5天（包括今天）</blockquote><blockquote>'''返回周围预警: alert='''true (注意小写)</blockquote><br />
<br />
=='''返回结构和说明'''==<br />
<blockquote>'''realtime'''分字段含义，请移步：[[实况天气接口/v2.5|实况接口/v2.5]]</blockquote><blockquote>'''minutely'''分字段含义，请移步：[[分钟级降雨预报接口|逐分钟降水短临预报接口/v2.5]]</blockquote><blockquote>'''hourly'''分字段含义，请移步：[[小时级预报接口/v2.5|逐小时预报接口/v2.5]]</blockquote><blockquote>'''daily'''分字段含义，请移步：[[天级预报接口/v2.5|逐日预报接口/v2.5]]</blockquote><blockquote>'''alert'''分字段含义，如下：</blockquote><syntaxhighlight lang="javascript"><br />
<br />
{ status:ok,<br />
api_version:v2.5,<br />
api_status:active,<br />
unit:metric,<br />
lang:en_US,<br />
result:{<br />
forecast_keypoint:cloudy, clear weather after 23 this midnight,<br />
primary:0,<br />
realtime:{status:ok, ###请参考：实况接口/v2.5<br />
temperature:-1.21,<br />
pres:56320.24,<br />
humidity:0.09,<br />
wind:{direction:284.91,speed:30.12}},<br />
precipitation:{local:{status:ok,intensity:0.0,datasource:gfs}},<br />
cloudrate:0.3,<br />
dswrf:677.9,<br />
visibility:24.1,<br />
<br />
skycon:PARTLY_CLOUDY_DAY,<br />
ultraviolet:{index:5.0,desc:Moderat},<br />
comfort:{index:11,desc:Icy wind cold},<br />
<br />
pm25:3,<br />
pm10:10.0,<br />
o3:97.0,<br />
no2:2.0,<br />
so2:7.0,<br />
co:0.4,<br />
aqi:10<br />
},<br />
minutely:{status:ok, ###请参考：逐分钟降水短临预报接口/v2.5<br />
precipitation_2h:[0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,<br />
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,<br />
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,<br />
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,<br />
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0],<br />
precipitation:[0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,<br />
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,<br />
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0],<br />
datasource:gfs,<br />
description:No snow in the next hour<br />
},<br />
hourly:{status:ok, ###请参考：逐小时预报接口/v2.5<br />
description:cloudy, clear weather after 23 this midnight,<br />
temperature:[{value:-1.21,datetime:2018-11-20 16:00},{value:-0.51,datetime:2018-11-20 17:00}]},<br />
pres:[{value:56320.2411405722,datetime:2018-11-20 16:00},{value:56309.4272949293,datetime:2018-11-20 17:00}],<br />
humidity:[{value:0.09,datetime:2018-11-20 16:00},{value:0.11,datetime:2018-11-20 17:00}],<br />
wind:[{direction:284.91,speed:30.12,datetime:2018-11-20 16:00},{direction:288.24,speed:32.91,datetime:2018-11-20 17:00}],<br />
precipitation:[{value:0.0,datetime:2018-11-20 16:00},{value:0.0,datetime:2018-11-20 17:00}],<br />
cloudrate:[{value:0.3,datetime:2018-11-20 16:00},{value:0.3,datetime:2018-11-20 17:00}],<br />
dswrf:[{value:677.9121814107,datetime:2018-11-20 16:00},{value:596.25984,datetime:2018-11-20 17:00}],<br />
visibility:[{value:24.1,datetime:2018-11-20 16:00},{value:24.1,datetime:2018-11-20 17:00}],<br />
<br />
skycon:[{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 16:00},{value:WIND,datetime:2018-11-20 17:00}],<br />
pm25:[{value:3,datetime:2018-11-20 16:00},{value:0,datetime:2018-11-20 17:00}],<br />
aqi:[{value:10,datetime:2018-11-20 16:00},{value:0,datetime:2018-11-20 17:00}],<br />
},<br />
daily:{status:ok, ###请参考：逐日预报接口/v2.5<br />
temperature:[{date:2018-11-20,max:1.19,avg:-4.35,min:-16.0},{date:2018-11-21,max:2.0,avg:-7.32,min:-18.0}],<br />
pres:[{date:2018-11-20,max:56600.24,avg:56422.06,min:56309.43},{date:2018-11-21,max:56833.63,avg:56653.05,min:56553.63}],<br />
humidity:[{date:2018-11-20,max:0.23,avg:0.14,min:0.09},{date:2018-11-21,max:0.15,avg:0.11,min:0.06}],<br />
wind:[{date:2018-11-20,max:{direction:290.25,speed:35.9},avg:{direction:278.27,speed:19.65},min:{direction:230.17,speed:4.77}},<br />
{date:2018-11-21,max:{direction:276.13,speed:43.0},avg:{direction:262.47,speed:24.54},min:{direction:216.1,speed:12.48}}],<br />
precipitation:[{date:2018-11-20,max:0.0,avg:0.0,min:0.0},{date:2018-11-21,max:0.0,avg:0.0,min:0.0}],<br />
<br />
dswrf:[{date:2018-11-20,max:743.7,avg:321.5,min:0.0},{date:2018-11-21,max:748.3,avg:202.3,min:0.0}],<br />
cloudrate:[{date:2018-11-20,max:0.76,avg:0.49,min:0.0},{date:2018-11-21,max:0.15,avg:0.02,min:0.0}],<br />
visibility:[{date:2018-11-20,max:24.1,avg:24.1,min:24.1},{date:2018-11-21,max:24.1,avg:24.1,min:24.1}],<br />
<br />
skycon:[{date:2018-11-20,value:PARTLY_CLOUDY_DAY},{date:2018-11-21,value:CLEAR_DAY}],<br />
skycon_08h_20h:[{date:2018-11-20,value:CLEAR_DAY},{date:2018-11-21,value:CLEAR_DAY}]},<br />
skycon_20h_32h:[{date:2018-11-20,value:PARTLY_CLOUDY_NIGHT},{date:2018-11-21,value:CLEAR_NIGHT}],<br />
ultraviolet:[{index:5,desc:Very high,datetime:2018-11-20},{index:5,desc:Very high,datetime:2018-11-21}],<br />
comfort:[{index:13,desc:Dry cold,datetime:2018-11-20},{index:13,desc:Dry cold,datetime:2018-11-21}],<br />
carWashing:[{index:1,desc:Suitable,datetime:2018-11-20},{index:1,desc:Suitable,datetime:2018-11-21}],<br />
coldRisk:[{index:4,desc:Extremely prone,datetime:2018-11-20},{index:4,desc:Extremely prone,datetime:2018-11-21}],<br />
dressing:[{index:8,desc:Extremely cold,datetime:2018-11-20},{index:8,desc:Extremely cold,datetime:2018-11-21}],<br />
<br />
pm25:[{date:2018-11-20,max:3,avg:1.12,min:0},{date:2018-11-21,max:1,avg:0.58,min:0}],<br />
aqi:[{date:2018-11-20,max:10,avg:1.25,min:0},{date:2018-11-21,max:0,avg:0.0,min:0}],<br />
<br />
astro:[{date:2018-11-20,sunset:{time:19:07},sunrise:{time:08:40}},{date:2018-11-21,sunset:{time:19:07},sunrise:{time:08:41}}],<br />
},<br />
alert:{alert:{status:"ok"<br />
content:{<br />
0:{ request_status: "ok",<br />
source: "国家预警信息发布中心",<br />
<br />
county: "无",<br />
province: "江苏省",<br />
regionId: "unknown"<br />
city: "南京市",<br />
code: "1303", ##预警类型code<br />
adcode: "320100",<br />
<br />
alertId: "32010041600000_20181130104521",<br />
status: "预警中",<br />
title: "南京市气象台发布霾橙色预警[Ⅱ级/严重]",<br />
description: "南京市气象台2018年11月30日10时41分升级霾黄色预警信号为霾橙色预警信号。目前我市已经出现中度霾，预计未来24小时内霾将持续，请注意防范。"<br />
<br />
location: "江苏省南京市",<br />
latlon: {<br />
0: 32.060255,<br />
1: 118.796877<br />
}<br />
pubtimestamp: 1543545921,<br />
}<br />
}<br />
}<br />
},<br />
location:[31.658613,<br />
87.815109]<br />
server_time:1542702509,<br />
tzshift:28800,<br />
}<br />
<br />
</syntaxhighlight>{{预警类型}}<br />
<br />
{{天气现象}}<br />
<br />
=='''生活指数'''==<br />
{{生活指数}}<br />
<br />
=='''支持的单位制'''==<br />
<br />
{{Template:彩云天气 API/支持的单位制}}<br />
<br />
[[Category:API 产品]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API_2&diff=5489
五分钟学会彩云小译 API 2
2019-11-01T10:11:47Z
<p>XTao: </p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= API 应用 =<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token，并获取到 secret_key<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 接口说明 ===<br />
<br />
* 文本翻译 API 地址<br />
"http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
* 参数说明<br />
{| class="wikitable"<br />
|-<br />
! 字段名 !! 类型 !! 含义 !! 必填 !! 备注<br />
|-<br />
| source || string/list || 源文本 || true || 支持字符串，也支持字符串的 list<br />
|-<br />
| trans_type || string || 翻译方向 || true || 见下方支持的语言<br />
|-<br />
| detect || boolean || 是否自动识别源语种 || false || 具体见下方说明<br />
|-<br />
| salt || string || uuid string || true || 根据 salt 来防重放，所以要求是 uuid<br />
|-<br />
| current_time || string || 当前UTC时间戳(秒) || true || timestamp<br />
|-<br />
| sign || string || 签名 || true || 见下方签名方法<br />
|}<br />
<br />
* 签名方法<br />
** sign=sha256(YOUR_TOKEN+salt+current_time+YOUR_SECRET_KEY+source_input)；<br />
** source_input: 如果 source 是 字符串，且长度<= 20，则就是 source，如果长度> 20, 则取字符串的前10个字符+后10个字符(source[:10]+str(len(source))+source[-10:])； 如果 source 是 list, 则以list的第一个 item 为基础，如果长度 <=20，则为source[0]，否则为 source[0][:10]+str(len(source[0]))+source[0][-10:];<br />
** secret_key: 用户在开放平台获取的 secret_key;<br />
<br />
* header 说明<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + YOUR_TOKEN,<br />
}<br />
<br />
=== python 示例===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，将 YOUR_SECRET_KEY 设置为你的 secret_key, 并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
import requests<br />
import json<br />
import hashlib<br />
import time<br />
import uuid<br />
<br />
def truncate(source):<br />
if source is None:<br />
return None<br />
if isinstance(source, str):<br />
source = source.decode('utf-8')<br />
size = len(source)<br />
return source if size <= 20 else source[:10] + str(size) + source[-10:]<br />
<br />
def encrypt(sign_str):<br />
hash_algorithm = hashlib.sha256()<br />
hash_algorithm.update(sign_str.encode('utf-8'))<br />
return hash_algorithm.hexdigest()<br />
<br />
def tranlate(source, direction):<br />
<br />
url = "http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
token = YOUR_TOKEN<br />
secret_key = YOUR_SECRET_KEY<br />
current_time = str(int(time.time()))<br />
salt = str(uuid.uuid1())<br />
source_input = source<br />
if isinstance(source, list):<br />
source_input = source[0]<br />
sign_str = token + salt + current_time + secret_key + truncate(source_input)<br />
payload = {<br />
"source" : source,<br />
"trans_type" : direction,<br />
"detect": True,<br />
"salt": salt,<br />
"current_time": current_time,<br />
"sign": encrypt(sign_str),<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
print response.text<br />
<br />
return json.loads(response.text)['target']<br />
<br />
<br />
<br />
<br />
#source = "彩云小译は最高の翻訳サービスです"<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print target<br />
<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
= 关于语种自动识别 =<br />
<br />
即在调用接口时，增加 detect=True 参数。<br />
<br />
当 detect=True 时，trans_type 由之前的 4 种：zh2en、en2zh、zh2ja、ja2zh，增加为 7 种：zh2en、en2zh、zh2ja、ja2zh、auto2zh、auto2en、auto2ja。<br />
<br />
当 trans_type 为 auto2zh 时：会将 en 和 ja 翻译为 zh，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2en 时：会将 zh 翻译为 en，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2ja 时：会将 zh 翻译为 ja，其他语种原样返回。<br />
<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API_2&diff=5488
五分钟学会彩云小译 API 2
2019-11-01T10:11:13Z
<p>XTao: </p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= API 应用 =<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token，并获取到 secret_key<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 接口说明 ===<br />
<br />
* 文本翻译 API 地址<br />
"http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
* 参数说明<br />
{| class="wikitable"<br />
|-<br />
! 字段名 !! 类型 !! 含义 !! 必填 !! 备注<br />
|-<br />
| source || string/list || 源文本 || true || 支持字符串，也支持字符串的 list<br />
|-<br />
| trans_type || string || 翻译方向 || true || 见下方支持的语言<br />
|-<br />
| detect || boolean || 是否自动识别源语种 || false || 具体见下方说明<br />
|-<br />
| salt || string || uuid string || true || 根据 salt 来防重放，所以要求是 uuid<br />
|-<br />
| current_time || string || 当前UTC时间戳(秒) || true || timestamp<br />
|-<br />
| sign || string || 签名 || true || 见下方签名方法<br />
|}<br />
<br />
* 签名方法<br />
** sign=sha256(YOUR_TOKEN+salt+current_time+secret_key+source_input)；<br />
** source_input: 如果 source 是 字符串，且长度<= 20，则就是 source，如果长度> 20, 则取字符串的前10个字符+后10个字符(source[:10]+str(len(source))+source[-10:])； 如果 source 是 list, 则以list的第一个 item 为基础，如果长度 <=20，则为source[0]，否则为 source[0][:10]+str(len(source[0]))+source[0][-10:];<br />
** secret_key: 用户在开放平台获取的 secret_key;<br />
<br />
* header 说明<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + YOUR_TOKEN,<br />
}<br />
<br />
=== python 示例===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，将 YOUR_SECRET_KEY 设置为你的 secret_key, 并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
import requests<br />
import json<br />
import hashlib<br />
import time<br />
import uuid<br />
<br />
def truncate(source):<br />
if source is None:<br />
return None<br />
if isinstance(source, str):<br />
source = source.decode('utf-8')<br />
size = len(source)<br />
return source if size <= 20 else source[:10] + str(size) + source[-10:]<br />
<br />
def encrypt(sign_str):<br />
hash_algorithm = hashlib.sha256()<br />
hash_algorithm.update(sign_str.encode('utf-8'))<br />
return hash_algorithm.hexdigest()<br />
<br />
def tranlate(source, direction):<br />
<br />
url = "http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
token = YOUR_TOKEN<br />
secret_key = YOUR_SECRET_KEY<br />
current_time = str(int(time.time()))<br />
salt = str(uuid.uuid1())<br />
source_input = source<br />
if isinstance(source, list):<br />
source_input = source[0]<br />
sign_str = token + salt + current_time + secret_key + truncate(source_input)<br />
payload = {<br />
"source" : source,<br />
"trans_type" : direction,<br />
"detect": True,<br />
"salt": salt,<br />
"current_time": current_time,<br />
"sign": encrypt(sign_str),<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
print response.text<br />
<br />
return json.loads(response.text)['target']<br />
<br />
<br />
<br />
<br />
#source = "彩云小译は最高の翻訳サービスです"<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print target<br />
<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
= 关于语种自动识别 =<br />
<br />
即在调用接口时，增加 detect=True 参数。<br />
<br />
当 detect=True 时，trans_type 由之前的 4 种：zh2en、en2zh、zh2ja、ja2zh，增加为 7 种：zh2en、en2zh、zh2ja、ja2zh、auto2zh、auto2en、auto2ja。<br />
<br />
当 trans_type 为 auto2zh 时：会将 en 和 ja 翻译为 zh，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2en 时：会将 zh 翻译为 en，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2ja 时：会将 zh 翻译为 ja，其他语种原样返回。<br />
<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API_2&diff=5487
五分钟学会彩云小译 API 2
2019-11-01T10:10:08Z
<p>XTao: </p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= API 应用 =<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token，并获取到 secret_key<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 接口说明 ===<br />
<br />
* 文本翻译 API 地址<br />
"http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
* 参数说明<br />
{| class="wikitable"<br />
|-<br />
! 字段名 !! 类型 !! 含义 !! 必填 !! 备注<br />
|-<br />
| source || string/list || 源文本 || true || 支持字符串，也支持字符串的 list<br />
|-<br />
| trans_type || string || 翻译方向 || true || 见下方支持的语言<br />
|-<br />
| detect || boolean || 是否自动识别源语种 || false || 具体见下方说明<br />
|-<br />
| salt || string || uuid string || true || 根据 salt 来防重放，所以要求是 uuid<br />
|-<br />
| current_time || string || 当前UTC时间戳(秒) || true || timestamp<br />
|-<br />
| sign || string || 签名 || true || 见下方签名方法<br />
|}<br />
<br />
* 签名方法<br />
** sign=sha256(token+salt+current_time+secret_key+source_input)；<br />
** source_input: 如果 source 是 字符串，且长度<= 20，则就是 source，如果长度> 20, 则取字符串的前10个字符+后10个字符(source[:10]+str(len(source))+source[-10:])； 如果 source 是 list, 则以list的第一个 item 为基础，如果长度 <=20，则为source[0]，否则为 source[0][:10]+str(len(source[0]))+source[0][-10:];<br />
** secret_key: 用户在开放平台获取的 secret_key;<br />
<br />
* header 说明<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
=== python 示例===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，将 YOUR_SECRET_KEY 设置为你的 secret_key, 并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
import requests<br />
import json<br />
import hashlib<br />
import time<br />
import uuid<br />
<br />
def truncate(source):<br />
if source is None:<br />
return None<br />
if isinstance(source, str):<br />
source = source.decode('utf-8')<br />
size = len(source)<br />
return source if size <= 20 else source[:10] + str(size) + source[-10:]<br />
<br />
def encrypt(sign_str):<br />
hash_algorithm = hashlib.sha256()<br />
hash_algorithm.update(sign_str.encode('utf-8'))<br />
return hash_algorithm.hexdigest()<br />
<br />
def tranlate(source, direction):<br />
<br />
url = "http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
token = YOUR_TOKEN<br />
secret_key = YOUR_SECRET_KEY<br />
current_time = str(int(time.time()))<br />
salt = str(uuid.uuid1())<br />
source_input = source<br />
if isinstance(source, list):<br />
source_input = source[0]<br />
sign_str = token + salt + current_time + secret_key + truncate(source_input)<br />
payload = {<br />
"source" : source,<br />
"trans_type" : direction,<br />
"detect": True,<br />
"salt": salt,<br />
"current_time": current_time,<br />
"sign": encrypt(sign_str),<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
print response.text<br />
<br />
return json.loads(response.text)['target']<br />
<br />
<br />
<br />
<br />
#source = "彩云小译は最高の翻訳サービスです"<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print target<br />
<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
= 关于语种自动识别 =<br />
<br />
即在调用接口时，增加 detect=True 参数。<br />
<br />
当 detect=True 时，trans_type 由之前的 4 种：zh2en、en2zh、zh2ja、ja2zh，增加为 7 种：zh2en、en2zh、zh2ja、ja2zh、auto2zh、auto2en、auto2ja。<br />
<br />
当 trans_type 为 auto2zh 时：会将 en 和 ja 翻译为 zh，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2en 时：会将 zh 翻译为 en，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2ja 时：会将 zh 翻译为 ja，其他语种原样返回。<br />
<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API_2&diff=5486
五分钟学会彩云小译 API 2
2019-11-01T10:00:45Z
<p>XTao: </p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= API 应用 =<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token，并获取到 secret_key<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 接口说明 ===<br />
<br />
* 文本翻译 API 地址<br />
"http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
* 参数说明<br />
{| class="wikitable"<br />
|-<br />
! 字段名 !! 类型 !! 含义 !! 必填 !! 备注<br />
|-<br />
| source || string/list || 源文本 || true || 支持字符串，也支持字符串的 list<br />
|-<br />
| trans_type || string || 翻译方向 || true || 见下方支持的语言<br />
|-<br />
| detect || boolean || 是否自动识别源语种 || false || 具体见下方说明<br />
|-<br />
| salt || string || uuid string || true || 根据 salt 来防重放，所以要求是 uuid<br />
|-<br />
| current_time || string || 当前UTC时间戳(秒) || true || timestamp<br />
|-<br />
| sign || string || 签名 || true || 见下方签名方法<br />
|}<br />
<br />
* 签名方法<br />
** sign=sha256(token+salt+current_time+secret_key+source_input)；<br />
** source_input: 如果 source 是 字符串，且长度<= 20，则就是 source，如果长度> 20, 则取字符串的前10个字符+后10个字符(source[:10]+str(len(source))+source[-10:])； 如果 source 是 list, 则以list的第一个 item 为基础，如果长度 <=20，则为source[0]，否则为 source[0][:10]+str(len(source[0]))+source[0][-10:];<br />
** secret_key: 用户在开放平台获取的 secret_key;<br />
<br />
* header 说明<br />
<br />
<br />
=== python 示例===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，将 YOUR_SECRET_KEY 设置为你的 secret_key, 并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
import requests<br />
import json<br />
import hashlib<br />
import time<br />
import uuid<br />
<br />
def truncate(source):<br />
if source is None:<br />
return None<br />
if isinstance(source, str):<br />
source = source.decode('utf-8')<br />
size = len(source)<br />
return source if size <= 20 else source[:10] + str(size) + source[-10:]<br />
<br />
def encrypt(sign_str):<br />
hash_algorithm = hashlib.sha256()<br />
hash_algorithm.update(sign_str.encode('utf-8'))<br />
return hash_algorithm.hexdigest()<br />
<br />
def tranlate(source, direction):<br />
<br />
url = "http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
token = YOUR_TOKEN<br />
secret_key = YOUR_SECRET_KEY<br />
current_time = str(int(time.time()))<br />
salt = str(uuid.uuid1())<br />
source_input = source<br />
if isinstance(source, list):<br />
source_input = source[0]<br />
sign_str = token + salt + current_time + secret_key + truncate(source_input)<br />
payload = {<br />
"source" : source,<br />
"trans_type" : direction,<br />
"detect": True,<br />
"salt": salt,<br />
"current_time": current_time,<br />
"sign": encrypt(sign_str),<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
print response.text<br />
<br />
return json.loads(response.text)['target']<br />
<br />
<br />
<br />
<br />
#source = "彩云小译は最高の翻訳サービスです"<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print target<br />
<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
= 关于语种自动识别 =<br />
<br />
即在调用接口时，增加 detect=True 参数。<br />
<br />
当 detect=True 时，trans_type 由之前的 4 种：zh2en、en2zh、zh2ja、ja2zh，增加为 7 种：zh2en、en2zh、zh2ja、ja2zh、auto2zh、auto2en、auto2ja。<br />
<br />
当 trans_type 为 auto2zh 时：会将 en 和 ja 翻译为 zh，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2en 时：会将 zh 翻译为 en，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2ja 时：会将 zh 翻译为 ja，其他语种原样返回。<br />
<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API_2&diff=5485
五分钟学会彩云小译 API 2
2019-11-01T05:09:39Z
<p>XTao: </p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= API 应用 =<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token，并获取到 secret_key<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 接口说明 ===<br />
<br />
* 文本翻译 API 地址<br />
"http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
* 参数说明<br />
{| class="wikitable"<br />
|-<br />
! 字段名 !! 类型 !! 含义 !! 必填 !! 备注<br />
|-<br />
| source || string/list || 源文本 || true || 支持字符串，也支持字符串的 list<br />
|-<br />
| trans_type || string || 翻译方向 || true || 见下方支持的语言<br />
|-<br />
| detect || boolean || 是否自动识别源语种 || false || 具体见下方说明<br />
|-<br />
| salt || string || uuid string || true || 根据 salt 来防重放，所以要求是 uuid<br />
|-<br />
| current_time || string || 当前UTC时间戳(秒) || true || timestamp<br />
|-<br />
| sign || string || 签名 || true || 见下方签名方法<br />
|}<br />
<br />
* 签名方法<br />
** sign=sha256(token+salt+current_time+secret_key+source_input)；<br />
** source_input: 如果 source 是 字符串，且长度<= 20，则就是 source，如果长度> 20, 则取字符串的前10个字符+后10个字符(source[:10]+str(len(source))+source[-10:])； 如果 source 是 list, 则以list的第一个 item 为基础，如果长度 <=20，则为source[0]，否则为 source[0][:10]+str(len(source[0]))+source[0][-10:];<br />
** secret_key: 用户在开放平台获取的 secret_key;<br />
<br />
=== python 示例===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，将 YOUR_SECRET_KEY 设置为你的 secret_key, 并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
import requests<br />
import json<br />
import hashlib<br />
import time<br />
import uuid<br />
<br />
def truncate(source):<br />
if source is None:<br />
return None<br />
if isinstance(source, str):<br />
source = source.decode('utf-8')<br />
size = len(source)<br />
return source if size <= 20 else source[:10] + str(size) + source[-10:]<br />
<br />
def encrypt(sign_str):<br />
hash_algorithm = hashlib.sha256()<br />
hash_algorithm.update(sign_str.encode('utf-8'))<br />
return hash_algorithm.hexdigest()<br />
<br />
def tranlate(source, direction):<br />
<br />
url = "http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
token = YOUR_TOKEN<br />
secret_key = YOUR_SECRET_KEY<br />
current_time = str(int(time.time()))<br />
salt = str(uuid.uuid1())<br />
source_input = source<br />
if isinstance(source, list):<br />
source_input = source[0]<br />
sign_str = token + salt + current_time + secret_key + truncate(source_input)<br />
payload = {<br />
"source" : source,<br />
"trans_type" : direction,<br />
"detect": True,<br />
"salt": salt,<br />
"current_time": current_time,<br />
"sign": encrypt(sign_str),<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
print response.text<br />
<br />
return json.loads(response.text)['target']<br />
<br />
<br />
<br />
<br />
#source = "彩云小译は最高の翻訳サービスです"<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print target<br />
<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
= 关于语种自动识别 =<br />
<br />
即在调用接口时，增加 detect=True 参数。<br />
<br />
当 detect=True 时，trans_type 由之前的 4 种：zh2en、en2zh、zh2ja、ja2zh，增加为 7 种：zh2en、en2zh、zh2ja、ja2zh、auto2zh、auto2en、auto2ja。<br />
<br />
当 trans_type 为 auto2zh 时：会将 en 和 ja 翻译为 zh，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2en 时：会将 zh 翻译为 en，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2ja 时：会将 zh 翻译为 ja，其他语种原样返回。<br />
<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API_2&diff=5484
五分钟学会彩云小译 API 2
2019-11-01T05:08:49Z
<p>XTao: </p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= API 应用 =<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token，并获取到 secret_key<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 接口说明 ===<br />
<br />
* 文本翻译 API 地址<br />
"http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
* 参数说明<br />
{| class="wikitable"<br />
|-<br />
! 字段名 !! 类型 !! 含义 !! 必填 !! 备注<br />
|-<br />
| source || string/list || 源文本 || true || 支持字符串，也支持字符串的 list<br />
|-<br />
| trans_type || string || 翻译方向 || true || 见下方支持的语言<br />
|-<br />
| detect || boolean || 是否自动识别源语种 || false || 具体见下方说明<br />
|-<br />
| salt || string || uuid string || true || 根据 salt 来防重放，所以要求是 uuid<br />
|-<br />
| current_time || string || 当前UTC时间戳(秒) || true || timestamp<br />
|-<br />
| sign || string || 签名 || true || 见下方签名方法<br />
|}<br />
<br />
* 签名方法<br />
** sign=sha256(token+salt+current_time+secret_key+source_input)；<br />
** source_input: 如果 source 是 字符串，且长度<= 20，则就是 source，如果长度> 20, 则取字符串的前10个字符+后10个字符(source[:10]+str(len(source))+source[-10:])； 如果 source 是 list, 则以list的第一个 item 为基础，如果长度 <=20，则为source[0]，否则为 source[0][:10]+str(len(source[0]))+source[0][-10:];<br />
** secret_key: 用户在开放平台获取的 secret_key;<br />
<br />
=== python 示例===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，将 YOUR_SECRET_KEY 设置为你的 secret_key, 并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
import requests<br />
import json<br />
import hashlib<br />
import time<br />
import uuid<br />
<br />
def truncate(source):<br />
if source is None:<br />
return None<br />
if isinstance(source, str):<br />
source = source.decode('utf-8')<br />
size = len(source)<br />
return source if size <= 20 else source[:10] + str(size) + source[-10:]<br />
<br />
def encrypt(sign_str):<br />
hash_algorithm = hashlib.sha256()<br />
hash_algorithm.update(sign_str.encode('utf-8'))<br />
return hash_algorithm.hexdigest()<br />
<br />
def tranlate(source, direction):<br />
<br />
url = "http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
token = YOUR_TOKEN<br />
secret_key = YOUR_SECRET_KEY<br />
current_time = str(int(time.time()))<br />
salt = str(uuid.uuid1())<br />
source_input = source<br />
if isinstance(source, list):<br />
source_input = source[0]<br />
sign_str = token + salt + current_time + secret_key + truncate(source_input)<br />
payload = {<br />
"source" : source,<br />
"trans_type" : direction,<br />
"request_id" : "demo",<br />
"detect": True,<br />
"salt": salt,<br />
"current_time": current_time,<br />
"sign": encrypt(sign_str),<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
print response.text<br />
<br />
return json.loads(response.text)['target']<br />
<br />
<br />
<br />
<br />
#source = "彩云小译は最高の翻訳サービスです"<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print target<br />
<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
= 关于语种自动识别 =<br />
<br />
即在调用接口时，增加 detect=True 参数。<br />
<br />
当 detect=True 时，trans_type 由之前的 4 种：zh2en、en2zh、zh2ja、ja2zh，增加为 7 种：zh2en、en2zh、zh2ja、ja2zh、auto2zh、auto2en、auto2ja。<br />
<br />
当 trans_type 为 auto2zh 时：会将 en 和 ja 翻译为 zh，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2en 时：会将 zh 翻译为 en，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2ja 时：会将 zh 翻译为 ja，其他语种原样返回。<br />
<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API_2&diff=5483
五分钟学会彩云小译 API 2
2019-11-01T05:08:28Z
<p>XTao: /* python 示例 */</p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= API 应用 =<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token，并获取到 secret_key<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 接口说明 ===<br />
<br />
* 文本翻译 API 地址<br />
"http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
* 参数说明<br />
{| class="wikitable"<br />
|-<br />
! 字段名 !! 类型 !! 含义 !! 必填 !! 备注<br />
|-<br />
| source || string/list || 源文本 || true || 支持字符串，也支持字符串的 list<br />
|-<br />
| trans_type || string || 翻译方向 || true || 见下方支持的语言<br />
|-<br />
| detect || boolean || 是否自动识别源语种 || false || 具体见下方说明<br />
|-<br />
| salt || string || uuid string || true || 根据 salt 来防重放，所以要求是 uuid<br />
|-<br />
| current_time || string || 当前UTC时间戳(秒) || true || timestamp<br />
|-<br />
| sign || string || 签名 || true || 见下方签名方法<br />
|}<br />
<br />
* 签名方法<br />
** sign=sha256(token+salt+current_time+secret_key+source_input)；<br />
** source_input: 如果 source 是 字符串，且长度<= 20，则就是 source，如果长度> 20, 则取字符串的前10个字符+后10个字符(source[:10]+str(len(source))+source[-10:])； 如果 source 是 list, 则以list的第一个 item 为基础，如果长度 <=20，则为source[0]，否则为 source[0][:10]+str(len(source[0]))+source[0][-10:];<br />
** secret_key: 用户在开放平台获取的 secret_key;<br />
<br />
=== python 示例===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，将 YOUR_SECRET_KEY 设置为你的 secret_key, 并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
import requests<br />
import json<br />
import hashlib<br />
import time<br />
import uuid<br />
<br />
def truncate(source):<br />
if source is None:<br />
return None<br />
if isinstance(source, str):<br />
source = source.decode('utf-8')<br />
size = len(source)<br />
return source if size <= 20 else source[:10] + str(size) + source[-10:]<br />
<br />
def encrypt(sign_str):<br />
hash_algorithm = hashlib.sha256()<br />
hash_algorithm.update(sign_str.encode('utf-8'))<br />
return hash_algorithm.hexdigest()<br />
<br />
def tranlate(source, direction):<br />
<br />
url = "http://api-staging.interpreter.caiyunai.com/v1/translator"<br />
<br />
token = YOUR_TOKEN<br />
secret_key = YOUR_SECRET_KEY<br />
current_time = str(int(time.time()))<br />
salt = str(uuid.uuid1())<br />
source_input = source<br />
if isinstance(source, list):<br />
source_input = source[0]<br />
sign_str = token + salt + current_time + secret_key + truncate(source_input)<br />
payload = {<br />
"source" : source,<br />
"trans_type" : direction,<br />
"request_id" : "demo",<br />
"detect": True,<br />
"salt": salt,<br />
"current_time": current_time,<br />
"sign": encrypt(sign_str),<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
print response.text<br />
<br />
return json.loads(response.text)['target']<br />
<br />
<br />
<br />
<br />
#source = "彩云小译は最高の翻訳サービスです"<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print target<br />
<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
= 关于语种自动识别 =<br />
<br />
即在调用接口时，增加 detect=True 参数。<br />
<br />
当 detect=True 时，trans_type 由之前的 4 种：zh2en、en2zh、zh2ja、ja2zh，增加为 7 种：zh2en、en2zh、zh2ja、ja2zh、auto2zh、auto2en、auto2ja。<br />
<br />
当 trans_type 为 auto2zh 时：会将 en 和 ja 翻译为 zh，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2en 时：会将 zh 翻译为 en，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2ja 时：会将 zh 翻译为 ja，其他语种原样返回。<br />
<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API_2&diff=5482
五分钟学会彩云小译 API 2
2019-11-01T05:07:30Z
<p>XTao: /* 关于语种自动识别 */</p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= API 应用 =<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token，并获取到 secret_key<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 接口说明 ===<br />
<br />
* 文本翻译 API 地址<br />
"http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
* 参数说明<br />
{| class="wikitable"<br />
|-<br />
! 字段名 !! 类型 !! 含义 !! 必填 !! 备注<br />
|-<br />
| source || string/list || 源文本 || true || 支持字符串，也支持字符串的 list<br />
|-<br />
| trans_type || string || 翻译方向 || true || 见下方支持的语言<br />
|-<br />
| detect || boolean || 是否自动识别源语种 || false || 具体见下方说明<br />
|-<br />
| salt || string || uuid string || true || 根据 salt 来防重放，所以要求是 uuid<br />
|-<br />
| current_time || string || 当前UTC时间戳(秒) || true || timestamp<br />
|-<br />
| sign || string || 签名 || true || 见下方签名方法<br />
|}<br />
<br />
* 签名方法<br />
** sign=sha256(token+salt+current_time+secret_key+source_input)；<br />
** source_input: 如果 source 是 字符串，且长度<= 20，则就是 source，如果长度> 20, 则取字符串的前10个字符+后10个字符(source[:10]+str(len(source))+source[-10:])； 如果 source 是 list, 则以list的第一个 item 为基础，如果长度 <=20，则为source[0]，否则为 source[0][:10]+str(len(source[0]))+source[0][-10:];<br />
** secret_key: 用户在开放平台获取的 secret_key;<br />
<br />
=== python 示例===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，将 YOUR_SECRET_KEY 设置为你的 secret_key, 并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
import requests<br />
import json<br />
import hashlib<br />
import time<br />
import uuid<br />
<br />
def truncate(source):<br />
if source is None:<br />
return None<br />
if isinstance(source, str):<br />
source = source.decode('utf-8')<br />
size = len(source)<br />
return source if size <= 20 else source[:10] + str(size) + source[-10:]<br />
<br />
def encrypt(sign_str):<br />
hash_algorithm = hashlib.sha256()<br />
hash_algorithm.update(sign_str.encode('utf-8'))<br />
return hash_algorithm.hexdigest()<br />
<br />
def tranlate(source, direction):<br />
<br />
url = "http://api-staging.interpreter.caiyunai.com/v1/translator"<br />
<br />
#WARNING, this token is a test token for new developers, and it should be replaced by your token<br />
token = YOUR_TOKEN<br />
secret_key = YOUR_SECRET_KEY<br />
current_time = str(int(time.time()))<br />
salt = str(uuid.uuid1())<br />
source_input = source<br />
if isinstance(source, list):<br />
source_input = source[0]<br />
sign_str = token + salt + current_time + secret_key + truncate(source_input)<br />
payload = {<br />
"source" : source,<br />
"trans_type" : direction,<br />
"request_id" : "demo",<br />
"detect": True,<br />
"salt": salt,<br />
"current_time": current_time,<br />
"sign": encrypt(sign_str),<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
print response.text<br />
<br />
return json.loads(response.text)['target']<br />
<br />
<br />
<br />
<br />
#source = "彩云小译は最高の翻訳サービスです"<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print target<br />
<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
= 关于语种自动识别 =<br />
<br />
即在调用接口时，增加 detect=True 参数。<br />
<br />
当 detect=True 时，trans_type 由之前的 4 种：zh2en、en2zh、zh2ja、ja2zh，增加为 7 种：zh2en、en2zh、zh2ja、ja2zh、auto2zh、auto2en、auto2ja。<br />
<br />
当 trans_type 为 auto2zh 时：会将 en 和 ja 翻译为 zh，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2en 时：会将 zh 翻译为 en，其他语种原样返回；<br />
<br />
当 trans_type 为 auto2ja 时：会将 zh 翻译为 ja，其他语种原样返回。<br />
<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API_2&diff=5481
五分钟学会彩云小译 API 2
2019-11-01T05:06:32Z
<p>XTao: </p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= API 应用 =<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token，并获取到 secret_key<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 接口说明 ===<br />
<br />
* 文本翻译 API 地址<br />
"http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
* 参数说明<br />
{| class="wikitable"<br />
|-<br />
! 字段名 !! 类型 !! 含义 !! 必填 !! 备注<br />
|-<br />
| source || string/list || 源文本 || true || 支持字符串，也支持字符串的 list<br />
|-<br />
| trans_type || string || 翻译方向 || true || 见下方支持的语言<br />
|-<br />
| detect || boolean || 是否自动识别源语种 || false || 具体见下方说明<br />
|-<br />
| salt || string || uuid string || true || 根据 salt 来防重放，所以要求是 uuid<br />
|-<br />
| current_time || string || 当前UTC时间戳(秒) || true || timestamp<br />
|-<br />
| sign || string || 签名 || true || 见下方签名方法<br />
|}<br />
<br />
* 签名方法<br />
** sign=sha256(token+salt+current_time+secret_key+source_input)；<br />
** source_input: 如果 source 是 字符串，且长度<= 20，则就是 source，如果长度> 20, 则取字符串的前10个字符+后10个字符(source[:10]+str(len(source))+source[-10:])； 如果 source 是 list, 则以list的第一个 item 为基础，如果长度 <=20，则为source[0]，否则为 source[0][:10]+str(len(source[0]))+source[0][-10:];<br />
** secret_key: 用户在开放平台获取的 secret_key;<br />
<br />
=== python 示例===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，将 YOUR_SECRET_KEY 设置为你的 secret_key, 并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
import requests<br />
import json<br />
import hashlib<br />
import time<br />
import uuid<br />
<br />
def truncate(source):<br />
if source is None:<br />
return None<br />
if isinstance(source, str):<br />
source = source.decode('utf-8')<br />
size = len(source)<br />
return source if size <= 20 else source[:10] + str(size) + source[-10:]<br />
<br />
def encrypt(sign_str):<br />
hash_algorithm = hashlib.sha256()<br />
hash_algorithm.update(sign_str.encode('utf-8'))<br />
return hash_algorithm.hexdigest()<br />
<br />
def tranlate(source, direction):<br />
<br />
url = "http://api-staging.interpreter.caiyunai.com/v1/translator"<br />
<br />
#WARNING, this token is a test token for new developers, and it should be replaced by your token<br />
token = YOUR_TOKEN<br />
secret_key = YOUR_SECRET_KEY<br />
current_time = str(int(time.time()))<br />
salt = str(uuid.uuid1())<br />
source_input = source<br />
if isinstance(source, list):<br />
source_input = source[0]<br />
sign_str = token + salt + current_time + secret_key + truncate(source_input)<br />
payload = {<br />
"source" : source,<br />
"trans_type" : direction,<br />
"request_id" : "demo",<br />
"detect": True,<br />
"salt": salt,<br />
"current_time": current_time,<br />
"sign": encrypt(sign_str),<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
print response.text<br />
<br />
return json.loads(response.text)['target']<br />
<br />
<br />
<br />
<br />
#source = "彩云小译は最高の翻訳サービスです"<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print target<br />
<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
= 关于语种自动识别 =<br />
<br />
即在调用接口时，增加 detect=True 参数。<br />
当 detect=True 时，trans_type 由之前的 4 种：zh2en、en2zh、zh2ja、ja2zh，增加为 7 种：zh2en、en2zh、zh2ja、ja2zh、auto2zh、auto2en、auto2ja。<br />
当 trans_type 为 auto2zh 时：会将 en 和 ja 翻译为 zh，其他语种原样返回；<br />
当 trans_type 为 auto2en 时：会将 zh 翻译为 en，其他语种原样返回；<br />
当 trans_type 为 auto2ja 时：会将 zh 翻译为 ja，其他语种原样返回。<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API_2&diff=5480
五分钟学会彩云小译 API 2
2019-11-01T05:05:43Z
<p>XTao: </p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= API 应用 =<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token，并获取到 secret_key<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 接口说明 ===<br />
<br />
* 文本翻译 API 地址<br />
"http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
* 参数说明<br />
{| class="wikitable"<br />
|-<br />
! 字段名 !! 类型 !! 含义 !! 必填 !! 备注<br />
|-<br />
| source || string/list || 源文本 || true || 支持字符串，也支持字符串的 list<br />
|-<br />
| trans_type || string || 翻译方向 || true || 见下方支持的语言<br />
|-<br />
| detect || boolean || 是否自动识别源语种 || false || 具体见下方说明<br />
|-<br />
| salt || string || uuid string || true || 根据 salt 来防重放，所以要求是 uuid<br />
|-<br />
| current_time || string || 当前UTC时间戳(秒) || true || timestamp<br />
|-<br />
| sign || string || 签名 || true || 见下方签名方法<br />
|}<br />
<br />
* 签名方法<br />
** sign=sha256(token+salt+current_time+secret_key+source_input)；<br />
** source_input: 如果 source 是 字符串，且长度<= 20，则就是 source，如果长度> 20, 则取字符串的前10个字符+后10个字符(source[:10]+str(len(source))+source[-10:])； 如果 source 是 list, 则以list的第一个 item 为基础，如果长度 <=20，则为source[0]，否则为 source[0][:10]+str(len(source[0]))+source[0][-10:];<br />
** secret_key: 用户在开放平台获取的 secret_key;<br />
<br />
=== python 示例===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，将 YOUR_SECRET_KEY 设置为你的 secret_key, 并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
import requests<br />
import json<br />
import hashlib<br />
import time<br />
import uuid<br />
<br />
def truncate(source):<br />
if source is None:<br />
return None<br />
if isinstance(source, str):<br />
source = source.decode('utf-8')<br />
size = len(source)<br />
return source if size <= 20 else source[:10] + str(size) + source[-10:]<br />
<br />
def encrypt(sign_str):<br />
hash_algorithm = hashlib.sha256()<br />
hash_algorithm.update(sign_str.encode('utf-8'))<br />
return hash_algorithm.hexdigest()<br />
<br />
def tranlate(source, direction):<br />
<br />
url = "http://api-staging.interpreter.caiyunai.com/v1/translator"<br />
<br />
#WARNING, this token is a test token for new developers, and it should be replaced by your token<br />
token = "fyqgjgu0hzfcpwdf45w9"<br />
secret_key = "iHn4uOYi5uWzQS6wRJC2efAp6WW3sgKx"<br />
current_time = str(int(time.time()))<br />
salt = str(uuid.uuid1())<br />
source_input = source<br />
if isinstance(source, list):<br />
source_input = source[0]<br />
sign_str = token + salt + current_time + secret_key + truncate(source_input)<br />
payload = {<br />
"source" : source,<br />
"trans_type" : direction,<br />
"request_id" : "demo",<br />
"detect": True,<br />
"salt": salt,<br />
"current_time": current_time,<br />
"sign": encrypt(sign_str),<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
print response.text<br />
<br />
return json.loads(response.text)['target']<br />
<br />
<br />
<br />
<br />
#source = "彩云小译は最高の翻訳サービスです"<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print target<br />
<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
= 关于语种自动识别 =<br />
<br />
即在调用接口时，增加 detect=True 参数。<br />
当 detect=True 时，trans_type 由之前的 4 种：zh2en、en2zh、zh2ja、ja2zh，增加为 7 种：zh2en、en2zh、zh2ja、ja2zh、auto2zh、auto2en、auto2ja。<br />
当 trans_type 为 auto2zh 时：会将 en 和 ja 翻译为 zh，其他语种原样返回；<br />
当 trans_type 为 auto2en 时：会将 zh 翻译为 en，其他语种原样返回；<br />
当 trans_type 为 auto2ja 时：会将 zh 翻译为 ja，其他语种原样返回。<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API_2&diff=5479
五分钟学会彩云小译 API 2
2019-11-01T05:03:22Z
<p>XTao: </p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= API 应用 =<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token，并获取到 secret_key<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 接口说明 ===<br />
<br />
* 文本翻译 API 地址<br />
"http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
* 参数说明<br />
{| class="wikitable"<br />
|-<br />
! 字段名 !! 类型 !! 含义 !! 必填 !! 备注<br />
|-<br />
! source !! string/list !! 源文本 !! true !! 支持字符串，也支持字符串的 list<br />
|-<br />
! trans_type !! string !! 翻译方向 !! true !! 见下方支持的语言<br />
|-<br />
! detect !! boolean !! 是否自动识别源语种 !! false !! 具体见下方说明<br />
|-<br />
! salt !! string !! uuid string !! true !! 根据 salt 来防重放，所以要求是 uuid<br />
|-<br />
! current_time !! string !! 当前UTC时间戳(秒) !! true !! timestamp<br />
|-<br />
! sign !! string !! 签名 !! true !! 见下方签名方法<br />
|}<br />
<br />
* 签名方法<br />
** sign=sha256(token+salt+current_time+secret_key+source_input)；<br />
** source_input: 如果 source 是 字符串，且长度<= 20，则就是 source，如果长度> 20, 则取字符串的前10个字符+后10个字符(source[:10]+str(len(source))+source[-10:])； 如果 source 是 list, 则以list的第一个 item 为基础，如果长度 <=20，则为source[0]，否则为 source[0][:10]+str(len(source[0]))+source[0][-10:];<br />
** secret_key: 用户在开放平台获取的 secret_key;<br />
<br />
=== python 示例===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，将 YOUR_SECRET_KEY 设置为你的 secret_key, 并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
import requests<br />
import json<br />
import hashlib<br />
import time<br />
import uuid<br />
<br />
def truncate(source):<br />
if source is None:<br />
return None<br />
if isinstance(source, str):<br />
source = source.decode('utf-8')<br />
size = len(source)<br />
return source if size <= 20 else source[:10] + str(size) + source[-10:]<br />
<br />
def encrypt(sign_str):<br />
hash_algorithm = hashlib.sha256()<br />
hash_algorithm.update(sign_str.encode('utf-8'))<br />
return hash_algorithm.hexdigest()<br />
<br />
def tranlate(source, direction):<br />
<br />
url = "http://api-staging.interpreter.caiyunai.com/v1/translator"<br />
<br />
#WARNING, this token is a test token for new developers, and it should be replaced by your token<br />
token = "fyqgjgu0hzfcpwdf45w9"<br />
secret_key = "iHn4uOYi5uWzQS6wRJC2efAp6WW3sgKx"<br />
current_time = str(int(time.time()))<br />
salt = str(uuid.uuid1())<br />
source_input = source<br />
if isinstance(source, list):<br />
source_input = source[0]<br />
sign_str = token + salt + current_time + secret_key + truncate(source_input)<br />
payload = {<br />
"source" : source,<br />
"trans_type" : direction,<br />
"request_id" : "demo",<br />
"detect": True,<br />
"salt": salt,<br />
"current_time": current_time,<br />
"sign": encrypt(sign_str),<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
print response.text<br />
<br />
return json.loads(response.text)['target']<br />
<br />
<br />
<br />
<br />
#source = "彩云小译は最高の翻訳サービスです"<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print target<br />
<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
= 关于语种自动识别 =<br />
<br />
即在调用接口时，增加 detect=True 参数。<br />
当 detect=True 时，trans_type 由之前的 4 种：zh2en、en2zh、zh2ja、ja2zh，增加为 7 种：zh2en、en2zh、zh2ja、ja2zh、auto2zh、auto2en、auto2ja。<br />
当 trans_type 为 auto2zh 时：会将 en 和 ja 翻译为 zh，其他语种原样返回；<br />
当 trans_type 为 auto2en 时：会将 zh 翻译为 en，其他语种原样返回；<br />
当 trans_type 为 auto2ja 时：会将 zh 翻译为 ja，其他语种原样返回。<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API_2&diff=5478
五分钟学会彩云小译 API 2
2019-11-01T04:36:38Z
<p>XTao: /* 申请访问令牌 */</p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= 一分钟介绍=<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token，并获取到 secret_key<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 文本翻译===<br />
<br />
执行下述 BASH 命令创建命令行工具 xiaoyi.sh<br />
<br />
<syntaxhighlight lang="bash"><br />
#!/bin/bash<br />
tee xiaoyi.sh << END<br />
DIRECTION=\$1<br />
SOURCE=\$2<br />
<br />
if test -f \$HOME/.xiaoyi ; then<br />
. \$HOME/.xiaoyi<br />
else<br />
echo "Please input your token: "<br />
read TOKEN<br />
echo "TOKEN=\$TOKEN" > \$HOME/.xiaoyi<br />
fi<br />
<br />
BODY='{"source": ["'\$SOURCE'"], "trans_type": "'\$DIRECTION'", "replaced": true, "media": "text", "request_id": "demo" }'<br />
<br />
export PYTHONIOENCODING=utf8<br />
curl -s -X POST http://api.interpreter.caiyunai.com/v1/translator\<br />
-H 'Content-Type: application/json'\<br />
-H "X-Authorization: token \$TOKEN"\<br />
-d "\$BODY" | python -c "import sys, json; print json.load(sys.stdin)['target']"<br />
END<br />
</syntaxhighlight><br />
<br />
再按照下面的方式执行 xiaoyi.sh 就会得到翻译结果<br />
<br />
<syntaxhighlight lang="bash"><br />
sh xiaoyi.sh en2zh "You know some birds are not meant to be caged, their feathers are just too bright."<br />
</syntaxhighlight><br />
<br />
你知道有些鸟不应该被关在笼子里，它们的羽毛太亮了。<br />
<br />
<syntaxhighlight lang="bash"><br />
sh xiaoyi.sh ja2zh "薄紅の秋の実に"<br />
</syntaxhighlight><br />
<br />
淡红色的秋天的果实<br />
<br />
备注：第一次执行 xiaoyi.sh 时会要求输入访问令牌 Token 。<br />
<br />
=进阶使用=<br />
===python 调用===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
def tranlate(source, direction):<br />
<br />
import requests<br />
import json<br />
<br />
url = "http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
#WARNING, this token is a test token for new developers, and it should be replaced by your token<br />
token = "3975l6lr5pcbvidl6jl2"<br />
<br />
<br />
payload = {<br />
"source" : source, <br />
"trans_type" : direction,<br />
"request_id" : "demo",<br />
"detect": True,<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
<br />
return json.loads(response.text)['target']<br />
<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print(target)<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API_2&diff=5477
五分钟学会彩云小译 API 2
2019-11-01T04:33:43Z
<p>XTao: Created page with "<div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"> <div> [https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec] </div>..."</p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= 一分钟介绍=<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 如果你要测试，可以使用 '''3975l6lr5pcbvidl6jl2''' 作为测试 Token，我们不保证该 Token 的可用性，所以如果要持续使用，还请申请正式 Token。<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token。<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 文本翻译===<br />
<br />
执行下述 BASH 命令创建命令行工具 xiaoyi.sh<br />
<br />
<syntaxhighlight lang="bash"><br />
#!/bin/bash<br />
tee xiaoyi.sh << END<br />
DIRECTION=\$1<br />
SOURCE=\$2<br />
<br />
if test -f \$HOME/.xiaoyi ; then<br />
. \$HOME/.xiaoyi<br />
else<br />
echo "Please input your token: "<br />
read TOKEN<br />
echo "TOKEN=\$TOKEN" > \$HOME/.xiaoyi<br />
fi<br />
<br />
BODY='{"source": ["'\$SOURCE'"], "trans_type": "'\$DIRECTION'", "replaced": true, "media": "text", "request_id": "demo" }'<br />
<br />
export PYTHONIOENCODING=utf8<br />
curl -s -X POST http://api.interpreter.caiyunai.com/v1/translator\<br />
-H 'Content-Type: application/json'\<br />
-H "X-Authorization: token \$TOKEN"\<br />
-d "\$BODY" | python -c "import sys, json; print json.load(sys.stdin)['target']"<br />
END<br />
</syntaxhighlight><br />
<br />
再按照下面的方式执行 xiaoyi.sh 就会得到翻译结果<br />
<br />
<syntaxhighlight lang="bash"><br />
sh xiaoyi.sh en2zh "You know some birds are not meant to be caged, their feathers are just too bright."<br />
</syntaxhighlight><br />
<br />
你知道有些鸟不应该被关在笼子里，它们的羽毛太亮了。<br />
<br />
<syntaxhighlight lang="bash"><br />
sh xiaoyi.sh ja2zh "薄紅の秋の実に"<br />
</syntaxhighlight><br />
<br />
淡红色的秋天的果实<br />
<br />
备注：第一次执行 xiaoyi.sh 时会要求输入访问令牌 Token 。<br />
<br />
=进阶使用=<br />
===python 调用===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
def tranlate(source, direction):<br />
<br />
import requests<br />
import json<br />
<br />
url = "http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
#WARNING, this token is a test token for new developers, and it should be replaced by your token<br />
token = "3975l6lr5pcbvidl6jl2"<br />
<br />
<br />
payload = {<br />
"source" : source, <br />
"trans_type" : direction,<br />
"request_id" : "demo",<br />
"detect": True,<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
<br />
return json.loads(response.text)['target']<br />
<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print(target)<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API&diff=4919
五分钟学会彩云小译 API
2019-09-04T08:48:42Z
<p>XTao: </p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= 一分钟介绍=<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 如果你要测试，可以使用 '''3975l6lr5pcbvidl6jl2''' 作为测试 Token，我们不保证该 Token 的可用性，所以如果要持续使用，还请申请正式 Token。<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token。<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 文本翻译===<br />
<br />
执行下述 BASH 命令创建命令行工具 xiaoyi.sh<br />
<br />
<syntaxhighlight lang="bash"><br />
#!/bin/bash<br />
tee xiaoyi.sh << END<br />
DIRECTION=\$1<br />
SOURCE=\$2<br />
<br />
if test -f \$HOME/.xiaoyi ; then<br />
. \$HOME/.xiaoyi<br />
else<br />
echo "Please input your token: "<br />
read TOKEN<br />
echo "TOKEN=\$TOKEN" > \$HOME/.xiaoyi<br />
fi<br />
<br />
BODY='{"source": ["'\$SOURCE'"], "trans_type": "'\$DIRECTION'", "replaced": true, "media": "text", "request_id": "demo" }'<br />
<br />
export PYTHONIOENCODING=utf8<br />
curl -s -X POST http://api.interpreter.caiyunai.com/v1/translator\<br />
-H 'Content-Type: application/json'\<br />
-H "X-Authorization: token \$TOKEN"\<br />
-d "\$BODY" | python -c "import sys, json; print json.load(sys.stdin)['target']"<br />
END<br />
</syntaxhighlight><br />
<br />
再按照下面的方式执行 xiaoyi.sh 就会得到翻译结果<br />
<br />
<syntaxhighlight lang="bash"><br />
sh xiaoyi.sh en2zh "You know some birds are not meant to be caged, their feathers are just too bright."<br />
</syntaxhighlight><br />
<br />
你知道有些鸟不应该被关在笼子里，它们的羽毛太亮了。<br />
<br />
<syntaxhighlight lang="bash"><br />
sh xiaoyi.sh ja2zh "薄紅の秋の実に"<br />
</syntaxhighlight><br />
<br />
淡红色的秋天的果实<br />
<br />
备注：第一次执行 xiaoyi.sh 时会要求输入访问令牌 Token 。<br />
<br />
=进阶使用=<br />
===python 调用===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
def tranlate(source, direction):<br />
<br />
import requests<br />
import json<br />
<br />
url = "http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
#WARNING, this token is a test token for new developers, and it should be replaced by your token<br />
token = "3975l6lr5pcbvidl6jl2"<br />
<br />
<br />
payload = {<br />
"source" : source, <br />
"trans_type" : direction,<br />
"request_id" : "demo",<br />
"detect": True,<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
<br />
return json.loads(response.text)['target']<br />
<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print(target)<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=Template:%E7%94%9F%E6%B4%BB%E6%8C%87%E6%95%B0&diff=4774
Template:生活指数
2019-08-21T08:17:49Z
<p>XTao: </p>
<hr />
<div><br />
'''1.目前支持的生活指数（life_index）包括：紫外线（ultraviolet）、舒适度（comfort）、洗车（carWashing）、感冒（coldRisk）、（穿衣指数（dressing），不建议继续使用，请使用舒适度）:'''<br />
<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header||紫外线（ultraviolet）实况}} || ||<br />
|-<br />
! level !! desc !! 自然语言描述<br />
|-<br />
| 0 || None || 无（夜间）<br />
|-<br />
| 1 || Weak || 很弱<br />
|-<br />
| 2 || Weak || 很弱<br />
|-<br />
| 3 || Low || 弱<br />
|-<br />
| 4 || Low || 弱<br />
|-<br />
| 5 || Moderate || 中等<br />
|-<br />
| 6 || Moderate || 中等<br />
|-<br />
| 7 || High || 强<br />
|-<br />
| 8 || High || 强<br />
|-<br />
| 9 || Very High || 很强<br />
|-<br />
| 10 || Very High || 很强<br />
|-<br />
| 11 || Extreme || 极强<br />
|-<br />
|}<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header||紫外线（ultraviolet）逐日预报（午间时段，10：00AM~14:00PM）}} || ||<br />
|-<br />
! level !! desc !! 自然语言描述<br />
|-<br />
| 0 || None || 无（夜间）<br />
|-<br />
| 1 || Weak || 最弱<br />
|-<br />
| 2 || Low || 弱<br />
|-<br />
| 3 || Moderate || 中等<br />
|-<br />
| 4 || High || 强<br />
|-<br />
| 5 || Very high || 很强<br />
|}<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header||舒适度（comfort）实况和逐日预报}} || ||<br />
|-<br />
! level !! desc !! 自然语言描述<br />
|-<br />
| 0 || Sticky || 闷热<br />
|-<br />
| 1 || Extremely hot || 酷热<br />
|-<br />
| 2 || Very hot || 很热<br />
|-<br />
| 3 || Hot || 热<br />
|-<br />
| 4 || Warm || 温暖<br />
|-<br />
| 5 || Comfort || 舒适<br />
|-<br />
| 6 || Cool || 凉爽<br />
|-<br />
| 7 || Cold || 冷<br />
|-<br />
| 8 || Very cold || 很冷<br />
|-<br />
| 9 || Freezing || 寒冷<br />
|-<br />
| 10 || Frigid || 极冷<br />
|-<br />
| 11 || Icy ||刺骨的冷<br />
|-<br />
| 12 || Clammy||湿冷<br />
|-<br />
| 13 || Dry cold || 干冷<br />
|-<br />
|}<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header||洗车（carWashing）逐日预报}} || ||<br />
|-<br />
! level !! desc !! 自然语言描述<br />
|-<br />
| 1 || Suitable || 适宜<br />
|-<br />
| 2 || More appropriate || 较适宜<br />
|-<br />
| 3 || Less appropriate || 较不适宜<br />
|-<br />
| 4 || Unfit || 不适应<br />
|}<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header||感冒（coldRisk）逐日预报}} || ||<br />
|-<br />
! level !! desc !! 自然语言描述<br />
|-<br />
| 1 || Less prone || 少发<br />
|-<br />
| 2 || Easily prone || 较易发<br />
|-<br />
| 3 || Prone || 易发<br />
|-<br />
| 4 || Extremely prone || 极易发<br />
|}</div>
XTao
https://open.caiyunapp.com/index.php?title=Template:%E7%94%9F%E6%B4%BB%E6%8C%87%E6%95%B0&diff=4773
Template:生活指数
2019-08-21T08:15:24Z
<p>XTao: </p>
<hr />
<div><br />
'''1.目前支持的生活指数（life_index）包括：紫外线（ultraviolet）、舒适度（comfort）、洗车（carWashing）、感冒（coldRisk）、（穿衣指数（dressing），不建议继续使用，请使用舒适度）:'''<br />
<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header||紫外线（ultraviolet）实况}} ||<br />
|-<br />
! level !! desc !! 自然语言描述<br />
|-<br />
| 0 || None || 无（夜间）<br />
|-<br />
| 1 || Weak || 很弱<br />
|-<br />
| 2 || Weak || 很弱<br />
|-<br />
| 3 || Low || 弱<br />
|-<br />
| 4 || Low || 弱<br />
|-<br />
| 5 || Moderate || 中等<br />
|-<br />
| 6 || Moderate || 中等<br />
|-<br />
| 7 || High || 强<br />
|-<br />
| 8 || High || 强<br />
|-<br />
| 9 || Very High || 很强<br />
|-<br />
| 10 || Very High || 很强<br />
|-<br />
| 11 || Extreme || 极强<br />
|-<br />
|}<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header||紫外线（ultraviolet）逐日预报（午间时段，10：00AM~14:00PM）}} ||<br />
|-<br />
! level !! desc !! 自然语言描述<br />
|-<br />
| 0 || None || 无（夜间）<br />
|-<br />
| 1 || Weak || 最弱<br />
|-<br />
| 2 || Low || 弱<br />
|-<br />
| 3 || Moderate || 中等<br />
|-<br />
| 4 || High || 强<br />
|-<br />
| 5 || Very high || 很强<br />
|}<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header||舒适度（comfort）实况和逐日预报}} || ||<br />
|-<br />
! level !! desc !! 自然语言描述<br />
|-<br />
| 0 || Sticky || 闷热<br />
|-<br />
| 1 || Extremely hot || 酷热<br />
|-<br />
| 2 || Very hot || 很热<br />
|-<br />
| 3 || Hot || 热<br />
|-<br />
| 4 || Warm || 温暖<br />
|-<br />
| 5 || Comfort || 舒适<br />
|-<br />
| 6 || Cool || 凉爽<br />
|-<br />
| 7 || Cold || 冷<br />
|-<br />
| 8 || Very cold || 很冷<br />
|-<br />
| 9 || Freezing || 寒冷<br />
|-<br />
| 10 || Frigid || 极冷<br />
|-<br />
| 11 || Icy ||刺骨的冷<br />
|-<br />
| 12 || Clammy||湿冷<br />
|-<br />
| 13 || Dry cold || 干冷<br />
|-<br />
|}<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header||洗车（carWashing）逐日预报}} ||<br />
|-<br />
! level !! 自然语言描述<br />
|-<br />
| 1 || 适宜<br />
|-<br />
| 2 || 较适宜<br />
|-<br />
| 3 || 较不适宜<br />
|-<br />
| 4 || 不适应<br />
|}<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header||感冒（coldRisk）逐日预报}} ||<br />
|-<br />
! level !! 自然语言描述<br />
|-<br />
| 1 || 少发<br />
|-<br />
| 2 || 较易发<br />
|-<br />
| 3 || 易发<br />
|-<br />
| 4 || 极易发<br />
|}</div>
XTao
https://open.caiyunapp.com/index.php?title=%E4%BA%94%E5%88%86%E9%92%9F%E5%AD%A6%E4%BC%9A%E5%BD%A9%E4%BA%91%E5%B0%8F%E8%AF%91_API&diff=4648
五分钟学会彩云小译 API
2019-08-09T05:29:15Z
<p>XTao: 去除小译邮件申请</p>
<hr />
<div><div style="padding:5px;border: 1px dashed MediumAquamarine;text-align:right;float:right"><br />
<div><br />
[https://app.swaggerhub.com/apis/caiyun/lingo-cloud_api/1.0.1 API spec]<br />
</div><br />
</div><br />
<br />
=能用彩云小译 API 做什么？=<br />
<br />
彩云小译 API 可以用来把'''信息'''翻译到指定的语言，我们可以支持文本、网页、PDF/Word文档、语音、视频等多种形式。<br />
<br />
您可以使用它来构建你的应用程序、网站、工具或任何需要多语言支持的解决方案。例如：彩云小译 API 是维基百科自动翻译的技术提供者，也为钉钉、石墨文档、财新传媒等一线机构和众多开发者提供技术支持。<br />
<br />
===维基百科内容翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.03.18 PM.png|800px]]<br />
===石墨文档翻译===<br />
[[File:Screen Shot 2018-09-06 at 11.22.04 PM.png|800px]]<br />
<br />
= 一分钟介绍=<br />
<br />
下面的一分钟介绍，我们制作一个命令行工具，可以让你翻译简短的一句话。<br />
<br />
=== 申请访问令牌===<br />
<br />
* 如果你要测试，可以使用 '''3975l6lr5pcbvidl6jl2''' 作为测试 Token，我们不保证该 Token 的可用性，所以如果要持续使用，还请申请正式 Token。<br />
<br />
* 请先至[https://dashboard.caiyunapp.com/user/sign_in/ 彩云科技开放平台]注册账号，申请开通小译 Token。<br />
* 请修改邮件标题为: "申请彩云小译 API Token"，同时邮件内容请提供: 姓名，手机号，用途等说明文字。<br />
<br />
* 每月翻译100万字之内都是免费的，如果您每月超过100万字，我们会按照 20元 / 100万字 的费率收费。(字数按照翻译原文字符计算，包含空格和标点)<br />
<br />
=== 文本翻译===<br />
<br />
执行下述 BASH 命令创建命令行工具 xiaoyi.sh<br />
<br />
<syntaxhighlight lang="bash"><br />
#!/bin/bash<br />
tee xiaoyi.sh << END<br />
DIRECTION=\$1<br />
SOURCE=\$2<br />
<br />
if test -f \$HOME/.xiaoyi ; then<br />
. \$HOME/.xiaoyi<br />
else<br />
echo "Please input your token: "<br />
read TOKEN<br />
echo "TOKEN=\$TOKEN" > \$HOME/.xiaoyi<br />
fi<br />
<br />
BODY='{"source": ["'\$SOURCE'"], "trans_type": "'\$DIRECTION'", "replaced": true, "media": "text", "request_id": "demo" }'<br />
<br />
export PYTHONIOENCODING=utf8<br />
curl -s -X POST http://api.interpreter.caiyunai.com/v1/translator\<br />
-H 'Content-Type: application/json'\<br />
-H "X-Authorization: token \$TOKEN"\<br />
-d "\$BODY" | python -c "import sys, json; print json.load(sys.stdin)['target']"<br />
END<br />
</syntaxhighlight><br />
<br />
再按照下面的方式执行 xiaoyi.sh 就会得到翻译结果<br />
<br />
<syntaxhighlight lang="bash"><br />
sh xiaoyi.sh en2zh "You know some birds are not meant to be caged, their feathers are just too bright."<br />
</syntaxhighlight><br />
<br />
你知道有些鸟不应该被关在笼子里，它们的羽毛太亮了。<br />
<br />
<syntaxhighlight lang="bash"><br />
sh xiaoyi.sh ja2zh "薄紅の秋の実に"<br />
</syntaxhighlight><br />
<br />
淡红色的秋天的果实<br />
<br />
备注：第一次执行 xiaoyi.sh 时会要求输入访问令牌 Token 。<br />
<br />
=进阶使用=<br />
===python 调用===<br />
<br />
请把 YOUR_TOKEN 设置为你的 token，并发请求的速度会是逐个请求的数倍，如有可能，请将长度类似的 20-40 个句子打包请求，下面是实例代码。<br />
<br />
<source lang="python"><br />
def tranlate(source, direction):<br />
<br />
import requests<br />
import json<br />
<br />
url = "http://api.interpreter.caiyunai.com/v1/translator"<br />
<br />
#WARNING, this token is a test token for new developers, and it should be replaced by your token<br />
token = "3975l6lr5pcbvidl6jl2"<br />
<br />
<br />
payload = {<br />
"source" : source, <br />
"trans_type" : direction,<br />
"request_id" : "demo",<br />
"detect": True,<br />
}<br />
<br />
headers = {<br />
'content-type': "application/json",<br />
'x-authorization': "token " + token,<br />
}<br />
<br />
response = requests.request("POST", url, data=json.dumps(payload), headers=headers)<br />
<br />
return json.loads(response.text)['target']<br />
<br />
source = ["Lingocloud is the best translation service.","彩云小译は最高の翻訳サービスです"]<br />
target = tranlate(source, "auto2zh")<br />
<br />
print(target)<br />
<br />
</source><br />
<br />
输出为：<br />
<source lang="javascript"><br />
['小译翻译是最好的翻译服务。', '彩云小译是最好的翻译服务']<br />
<br />
</source><br />
<br />
= 支持的语言 =<br />
<br />
目前支持的语言和翻译方向如下表所示<br />
<br />
{| class="wikitable"<br />
! {{diagonal split header|From|To}}<br />
! 中文 zh !! 英语 en !! 日文 ja<br />
|-<br />
! 中文 zh<br />
| - || zh2en || zh2ja<br />
|-<br />
! 英语 en<br />
| en2zh || - || -<br />
|-<br />
! 日文 ja<br />
| ja2zh || - || -<br />
|}<br />
<br />
使用 auto2xx 可以自动识别源语言的语种。2019年底将支持到15种以上语言，200种以上语言方向。<br />
<br />
=想要更多？=<br />
* 去应用商店下载彩云小译App！<br />
* 访问 http://fanyi.caiyunapp.com ，体验在线版本。<br />
* 想要更多功能或者反馈使用体验，请写信给 [mailto:api@caiyunapp.com api@caiyunapp.com] 联系！<br />
* QQ交流反馈群：<br />
https://open.caiyunapp.com/images/thumb/1/11/Beary861921651.jpg/437px-Beary861921651.jpg<br />
[[en:LingoCloud API in 5 minutes]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E5%A4%A9%E7%BA%A7%E9%A2%84%E6%8A%A5%E6%8E%A5%E5%8F%A3/v2.2&diff=3708
天级预报接口/v2.2
2019-05-20T10:16:08Z
<p>XTao: </p>
<hr />
<div>{{彩云天气 API 版本状态}}<br />
<br />
=='''授权与认证'''==<br />
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。<br />
<br />
把您的 token 拼到 API 请求的 URL 中，如<br />
<br />
<code><br />
<nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</nowiki><br />
</code><br />
<br />
其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！<br />
<br />
=='''请求样例'''==<br />
<br />
=== '''示例1如下''' ===<br />
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</nowiki></code><br />
<br />
</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.jsonp?callback=MYCALLBACK</nowiki></blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote><br />
<br />
=== '''示例2如下''' ===<br />
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json?lang=en_US&dailysteps=360</nowiki></code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI） 、英制（imperial）</blockquote><blockquote>'''定制返回逐日预报总日数 dailysteps'''：默认为5日</blockquote><blockquote>'''时区偏移秒数 tzshift：'''默认为东八区，tzshift=28800；例如：印度东5.5区，tzshift=3600*5.5==19800，v2.3之后版本，返回时区信息，使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区，它们有非整齐的偏移量；考虑了欧美夏令时。</blockquote><br />
==返回结构和说明==<br />
<syntaxhighlight lang="javascript"><br />
{ status:ok, // 返回状态<br />
api_version:v2.2, // 版本号<br />
api_status:active, // 版本号状态<br />
lang:en_US, // 语言<br />
unit:metric, // 单位制<br />
result:{<br />
primary:0,<br />
daily:{<br />
status:ok, // 逐日预报模块返回状态<br />
temperature:[{date:2018-11-20,max:23.0,avg:20.37,min:20.0},{date:2018-11-21,max:26.0,avg:22.97,min:20.33}], // 温度，最大值，平均值，最小值<br />
pres:[{date:2018-11-20,max:100519.86,avg:100238.05,min:100119.53},{date:2018-11-21,max:100470.46,avg:100214.34,min:99940.79}], // 气压，最大值，平均值，最小值<br />
humidity:[{date:2018-11-20,max:0.86,avg:0.84,min:0.76},{date:2018-11-21,max:0.87,avg:0.79,min:0.68}], // 相对湿度，最大值，平均值，最小值<br />
wind:[{ date:2018-11-20,<br />
max:{direction:70.43,speed:24.17}, // 风速，最大值，平均值，最小值<br />
avg:{direction:101.11,speed:21.81},<br />
min:{direction:148.08,speed:14.8}},<br />
{ date:2018-11-21,<br />
max:{direction:19.36,speed:29.25},<br />
avg:{direction:24.59,speed:14.73},<br />
min:{direction:254.91,speed:2.53}}],<br />
precipitation:[{date:2018-11-20,max:0.0699,avg:0.0,min:0.0},{date:2018-11-21,max:0.2583,avg:0.0581,min:0.0}], // 本地降水强度，最大值，平均值，最小值(单位见表格)<br />
<br />
cloudrate:[{date:2018-11-20,max:0.91,avg:0.62,min:0.18},{date:2018-11-21,max:1.0,avg:0.45,min:0.0}], // 云量，最大值，平均值，最小值<br />
dswrf:[{date:2018-11-20,max:344.1,avg:84.0,min:0.0},{date:2018-11-21,max:601.5,avg:197.7,min:0.0}], // 短波辐射，最大值，平均值，最小值<br />
visibility:[{date:2018-11-20,max:24.1,avg:22.9,min:14.2},{date:2018-11-21,max:24.1,avg:20.4,min:13.7}], // 能见度，最大值，平均值，最小值<br />
<br />
skycon:[{date:2018-11-20,value:PARTLY_CLOUDY_DAY},{date:2018-11-21,value:PARTLY_CLOUDY_DAY}], // 全天，主要天气现象<br />
skycon_08h_20h:[{date:2018-11-20,value:PARTLY_CLOUDY_DAY},{date:2018-11-21,value:PARTLY_CLOUDY_DAY}] // 白天，主要天气现象<br />
skycon_20h_32h:[{date:2018-11-20,value:PARTLY_CLOUDY_NIGHT},{date:2018-11-21,value:RAIN}], // 夜晚，主要天气现象<br />
<br />
ultraviolet:[{index:3,desc:Moderat,datetime:2018-11-20},{index:3,desc:Moderat,datetime:2018-11-21}], // 午间，紫外线指数和自然语言描述<br />
comfort:[{index:4,desc:Warm,datetime:2018-11-20},{index:4,desc:Warm,datetime:2018-11-21}], // 全天，舒适度指数和自然语言描述<br />
carWashing:[{index:3,desc:Less appropriate,datetime:2018-11-20},{index:3,desc:Less appropriate,datetime:2018-11-21}], // 全天，洗车指数和自然语言描述<br />
coldRisk:[{index:3,desc:Prone,datetime:2018-11-20},{index:3,desc:Prone,datetime:2018-11-21}], // 全天，感冒指数和自然语言描述<br />
dressing:[{index:5,desc:Cool,datetime:2018-11-20},{index:3,desc:Hot,datetime:2018-11-21}], // 全天，冷暖指数和自然语言描述（淘汰...）<br />
<br />
pm25:[{date:2018-11-20,max:20,avg:15.62,min:8},{date:2018-11-21,max:28,avg:22.29,min:12}], // PM2.5，最大值，平均值，最小值<br />
aqi:[{date:2018-11-20,max:42,avg:24.08,min:14},{date:2018-11-21,max:40,avg:31.75,min:17}], // AQI(国标)，最大值，平均值，最小值<br />
<br />
astro:[{date:2018-11-20,<br />
sunset:{time:17:04},<br />
sunrise:{time:06:13}},<br />
{date:2018-11-21,<br />
sunset:{time:17:04}, // 日出时间(北京时间，tzshift不作用在这个变量)<br />
sunrise:{time:06:14}}], // 日出时间(返回北京时间，tzshift不作用在这个变量)<br />
}<br />
},<br />
location:[25.1552,<br />
121.6544], // 经纬度<br />
server_time:1542698313, // 服务器本次返回的utc时间戳<br />
tzshift:14400, // 时区的偏移秒数，如东八区就是 28800 秒<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
=='''变量说明'''==<br />
<blockquote>逐日预报，没有逐日预报的自然语言描述字段</blockquote><br />
{| class="wikitable"<br />
! 名称<br />
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释<br />
|-<br />
! 温度<br />
| $.result.daily.temperature[max,min,avg] || 温度 || 逐日预报 || 全球 || 地表2米气温<br />
|-<br />
! 气压<br />
| $.result.daily.pres[max,min,avg] || 气压(Pa) || 逐日预报 || 全球 || 地面气压<br />
|-<br />
! 相对湿度<br />
| $.result.daily.humidity[max,min,avg] || 相对湿度(%) || 逐日预报 || 全球 || 地表2米湿度<br />
|-<br />
! 风速<br />
| $.result.daily.wind.speed[max,min,avg] || 风速 || 逐日预报 || 全球 || 地表10米风速<br />
|-<br />
! 本地降水强度<br />
| $.result.daily.precipitation[max,min,avg] || 降水量(mm/h) || 逐日预报 || 全球 || 本地降水量<br />
|-<br />
! 云量<br />
| $.result.daily.cloudrate[max,min,avg] || 云量(0.0-1.0) || 逐日预报 || 全球 || 全天总云量<br />
|-<br />
! 短波辐射<br />
| $.result.daily.dswrf[max,min,avg]|| 向下短波辐射通量(W/M2) || 逐日预报 || 全球 || 地表向下短波辐射通量<br />
|-<br />
! 能见度<br />
| $.result.daily.visibility[max,min,avg] || 能见度 || 逐日预报 || 全球 || 地表水平能见度<br />
|-<br />
!<br />
!<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
! 全天主要天气现象<br />
| $.result.daily.skycon.value || 天气状况 || 逐日预报 || 全球 || 全天主要天气现象<br />
|-<br />
! 白天主要天气现象<br />
| $.result.daily.skycon_08h_20h.value|| 天气状况 || 逐日预报 || 全球 || 白天主要天气现象<br />
|-<br />
! 夜晚主要天气现象<br />
| $.result.daily.skycon_20h_32h.value|| 天气状况 || 逐日预报 || 全球 || 夜晚主要天气现象<br />
|-<br />
! 紫外线指数<br />
| $.result.daily.ultraviolet.desc|| 紫外线指数自然语言 || 逐日预报 || 全球 || 紫外线指数及其描述<br />
|-<br />
! 舒适度指数<br />
| $.result.daily.comfort.desc|| 舒适度指数自然语言 || 逐日预报 || 全球 || 舒适度指数及其描述<br />
|-<br />
! 洗车指数<br />
| $.result.daily.carWashing.desc|| 洗车指数自然语言 || 逐日预报 || 全球 || 洗车指数及其描述<br />
|-<br />
! 感冒指数<br />
| $.result.daily.coldRisk.desc|| 感冒指数自然语言 || 逐日预报 || 全球 || 感冒指数及其描述<br />
|-<br />
! 穿衣指数<br />
| $.result.daily.dressing.desc|| 冷热指数自然语言 || 逐日预报 || 全球 || 穿衣指数（dressing），不建议继续使用，请使用舒适度<br />
|-<br />
!<br />
!<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
! PM25浓度<br />
| $.result.daily.pm25[max,min,avg] || PM25浓度(μg/m3) || 逐日预报 || 大陆、港澳台、暂无印度 || PM25浓度<br />
|-<br />
! AQI<br />
| $.result.daily.aqi[max,min,avg] || 国标AQI || 逐日预报 || 大陆、港澳台、暂无印度 || 国标AQI<br />
|-<br />
!<br />
!<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
! 日出日落<br />
| $.result.astro.aqi[sunrise,sunset] || 国标AQI || 逐日预报 || 大陆、港澳台、暂无印度 || 日出日落(当地时区的时刻，tzshift不作用在这个变量)<br />
|}<br />
{{天气现象}}<br />
<br />
=='''生活指数'''==<br />
{{生活指数}}<br />
<br />
==支持的单位制==<br />
{{Template:彩云天气 API/支持的单位制}}<br />
<br />
[[Category:API 产品]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E5%B0%8F%E6%97%B6%E7%BA%A7%E9%A2%84%E6%8A%A5%E6%8E%A5%E5%8F%A3/v2.2&diff=3707
小时级预报接口/v2.2
2019-05-20T10:15:34Z
<p>XTao: </p>
<hr />
<div>{{彩云天气 API 版本状态}}<br />
<br />
=='''授权与认证'''==<br />
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。<br />
<br />
把您的 token 拼到 API 请求的 URL 中，如<br />
<br />
<code><br />
<nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</nowiki><br />
</code><br />
<br />
其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！<br />
<br />
=='''请求样例'''==<br />
<br />
=== '''示例1如下''' ===<br />
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</nowiki></code><br />
<br />
</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.jsonp?callback=MYCALLBACK</nowiki></blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote><br />
<br />
=== '''示例2如下''' ===<br />
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly?lang=en_US&hourlysteps=2</nowiki></code></blockquote><blockquote>'''语言选项 lang：'''简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI） 、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''用户提供所需时区偏移秒，考虑欧美夏令时，默认东八（tzshift=28800）；例如，用户希望取得印度（东5.5区）习惯定义下的逐日天气，加参数&tzshift=19800（=3600*5.5），然后daily的计算都会做相应处理。</blockquote><blockquote>'''定制返回的起始时间戳 begin'''：默认为当前utc时间戳，可以用来返回两日内的历史数据</blockquote><blockquote>'''定制返回逐小时预报总小时数 hourlysteps'''：默认为48小时（包括当前时刻）</blockquote><blockquote>'''定制返回逐日预报总天数 dailysteps'''：默认为5天（包括今天）</blockquote><br />
==返回结构和说明==<br />
<syntaxhighlight lang="javascript"><br />
<br />
{ status:ok,<br />
api_version:v2.2, // 版本号<br />
api_status:active, // 版本号状态<br />
lang:en_US, // 语言<br />
unit:metric, // 单位制<br />
result:{<br />
hourly:{<br />
status:ok, // 逐小时预报模块返回状态<br />
temperature:[{value:23.0,datetime:2018-11-20 10:00},{value:22.0,datetime:2018-11-20 11:00}]}, // 温度<br />
pres:[{value:100279.8643200001,datetime:2018-11-20 10:00},{value:100249.1918336001,datetime:2018-11-20 11:00}], // 气压<br />
humidity:[{value:0.77,datetime:2018-11-20 10:00},{value:0.77,datetime:2018-11-20 11:00}], // 相对湿度<br />
wind:[ { direction:95.62, // 风向，单位是度。正北方向为0度，顺时针增加到360度。<br />
speed:22.85,datetime:2018-11-20 10:00}, // 风速，米制下是公里每小时<br />
{ direction:97.97,<br />
speed:23.27,datetime:2018-11-20 11:00}],<br />
precipitation:[{value:0.0,datetime:2018-11-20 10:00},{value:0.0,datetime:2018-11-20 11:00}], // 本地降水强度(单位见表格)<br />
cloudrate:[{value:0.77,datetime:2018-11-20 10:00},{value:0.46,datetime:2018-11-20 11:00}], // 云量<br />
dswrf:[{value:344.09456384,datetime:2018-11-20 10:00},{value:325.9617024,datetime:2018-11-20 11:00}], // 短波辐射<br />
visibility:[{value:23.24,datetime:2018-11-20 10:00},{value:23.0,datetime:2018-11-20 11:00}], // 能见度<br />
<br />
skycon:[{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 10:00},{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 11:00}], // 主要天气现象<br />
description:cloudy, clear weather after 7 tomorrow morning, increasing cloudiness, // 逐小时天气预报，自然语言描述<br />
forecast_keypoint:cloudy, clear weather after 7 tomorrow morning, increasing cloudiness,primary:0， // 逐小时和逐分钟天气预报，综合自然语言描述<br />
<br />
pm25:[{value:8,datetime:2018-11-20 10:00},{value:9,datetime:2018-11-20 11:00}], // PM2.5<br />
aqi:[{value:33,datetime:2018-11-20 10:00},{value:13,datetime:2018-11-20 11:00}] // AQI(国标)<br />
},<br />
location:[25.1552,<br />
121.6544] // 经纬度<br />
server_time:1542695724, // 服务器本次返回的utc时间戳<br />
tzshift:14400, // 时区的偏移秒数，如东八区就是 28800 秒<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
=='''变量说明'''==<br />
<blockquote>逐小时预报，没有生活指数变量</blockquote><br />
{| class="wikitable"<br />
! 名称<br />
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释<br />
|-<br />
! 温度<br />
| $.result.hourly.temperature.value || 温度 || 逐小时预报 || 全球 || 地表2米气温<br />
|-<br />
! 气压<br />
| $.result.hourly.pres.value || 气压(Pa) || 逐小时预报 || 全球 || 地面气压<br />
|-<br />
! 相对湿度<br />
| $.result.hourly.humidity.value || 相对湿度(%) || 逐小时预报 || 全球 || 地表2米湿度<br />
|-<br />
! 风向<br />
| $.result.hourly.wind.direction.value || 风向 || 逐小时预报 || 全球 || 地表10米风向<br />
|-<br />
! 风速<br />
| $.result.hourly.wind.speed.value || 风速 || 逐小时预报 || 全球 || 地表10米风速<br />
|-<br />
! 本地降水强度<br />
| $.result.hourly.precipitation.value || 降水量(mm/h) || 逐小时预报 || 全球 || 本地降水量<br />
|-<br />
! 云量<br />
| $.result.hourly.cloudrate.value || 云量(0.0-1.0) || 逐小时预报 || 全球 || 全天总云量<br />
|-<br />
! 短波辐射<br />
| $.result.hourly.dswrf.value|| 向下短波辐射通量(W/M2) || 逐小时预报 || 全球 || 地表向下短波辐射通量<br />
|-<br />
! 能见度<br />
| $.result.hourly.visibility.value || 能见度 || 逐小时预报 || 全球 || 地表水平能见度<br />
|-<br />
!<br />
!<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
! 主要天气现象<br />
| $.result.hourly.skycon.value || 天气状况 || 逐小时预报 || 全球 || 天气状况<br />
|-<br />
! 逐小时预报自然语言描述<br />
| $.result.hourly.description || 舒适度指数自然语言 || 逐小时预报 || 全球 || 舒适度指数及其描述<br />
|-<br />
! 综合预报自然语言描述<br />
| $.result.hourly.forecast_keypoint || 紫外线指数自然语言 || 逐小时预报 || 全球 || 逐小时和逐分钟天气预报，综合自然语言描述<br />
|-<br />
!<br />
!<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
! PM25浓度<br />
| $.result.hourly.pm25.value || PM25浓度(μg/m3) || 逐小时预报 || 大陆、港澳台、暂无印度 || PM25浓度<br />
|-<br />
! AQI<br />
| $.result.hourly.aqi.value || 国标AQI || 逐小时预报 || 大陆、港澳台、暂无印度 || 国标AQI<br />
|}<br />
{{天气现象}}<br />
<br />
==支持的单位制==<br />
<br />
{{Template:彩云天气 API/支持的单位制}}<br />
<br />
[[Category:API 产品]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E5%88%86%E9%92%9F%E7%BA%A7%E9%99%8D%E9%9B%A8%E9%A2%84%E6%8A%A5%E6%8E%A5%E5%8F%A3/v2.5&diff=3706
分钟级降雨预报接口/v2.5
2019-05-20T10:14:57Z
<p>XTao: </p>
<hr />
<div>{{彩云天气 API 版本状态}}<br />
<br />
=='''授权与认证'''==<br />
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。<br />
<br />
把您的 token 拼到 API 请求的 URL 中，如<br />
<br />
<code><br />
<nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</nowiki><br />
</code><br />
<br />
其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！<br />
<br />
=='''请求样例'''==<br />
<br />
=== '''示例1如下''' ===<br />
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.json</nowiki></code><br />
<br />
</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/minutely.jsonp?callback=MYCALLBACK</nowiki></blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote><br />
<br />
=== '''示例2如下''' ===<br />
<blockquote><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/118.7087,26.9582/minutely?lang=en_US</nowiki></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI） 、英制（imperial）</blockquote><blockquote>'''时区偏移秒数：tzshift：'''默认为东八区，tzshift=28800；例如：印度东5.5区，tzshift=3600*5.5==19800，v2.3之后版本，返回时区信息，使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区，它们有非整齐的偏移量；考虑了欧美夏令时。</blockquote><blockquote><br />
<br />
==返回结构和说明==<br />
<br />
<syntaxhighlight lang="javascript"><br />
<br />
{ status:ok,<br />
api_version:v2.2, // 版本号<br />
api_status:active, // 版本号状态<br />
lang:zh_CN, // 语言<br />
unit:metric, // 单位制<br />
result:{ forecast_keypoint:Cloudy here but it's raining SE 41 km away, // 逐小时和逐分钟天气预报，综合自然语言描述<br />
minutely:{status:ok, // 逐日预报模块返回状态<br />
description:Cloudy here but it's raining SE 41 km away, // 逐小时天气预报，自然语言描述<br />
precipitation_2h:[0.0507,0.0348,0.0211,0.0104,0.0033,0.0,0.0,0.0,0.0,0.0,0.001,0.0016,0.0018,0.0016,0.001,0.0,0.0,0.0,0.0,0.0027,0.0096,0.0208,<br />
0.0369,0.0559,0.0755,0.0934,0.1072,0.1146,0.1139,0.1068,0.0958,0.0831,0.0712,0.0625,0.0587,0.0588,0.061,0.0635,0.0646,0.0625,<br />
0.056,0.0461,0.034,0.0214,0.0096,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0052,0.0114,0.0188,0.0279,0.0388,0.0521,0.0676,0.084,0.0996,<br />
0.1128,0.1218,0.125,0.1213,0.1121,0.0995,0.0857,0.0726,0.0625,0.0568,0.0549,0.0557,0.058,0.0606,0.0625,0.0627,0.0615,0.0593,<br />
0.0567,0.0541,0.0521,0.0509,0.0502,0.0494,0.0481,0.0457,0.0417,0.0357,0.0283,0.0202,0.0123,0.0053,0.0,0.0,0.0,0.0,0.0,0.0,<br />
0.0,0.0008,0.0011,0.001,0.0007,0.0003,0.0,0.0,0.0,0.0,0.0001,0.0002,0.0,0.0,0.0,0.0001,0.0018,0.0051,0.0104,0.0181,0.0276], // 未来2小时，逐分钟，雷达降水强度预报<br />
precipitation:[0.0507,0.0348,0.0211,0.0104,0.0033,0.0,0.0,0.0,0.0,0.0,0.001,0.0016,0.0018,0.0016,0.001,0.0,0.0,0.0,0.0,0.0027,0.0096,0.0208,<br />
0.0369,0.0559,0.0755,0.0934,0.1072,0.1146,0.1139,0.1068,0.0958,0.0831,0.0712,0.0625,0.0587,0.0588,0.061,0.0635,0.0646,0.0625,<br />
0.056,0.0461,0.034,0.0214,0.0096,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0052,0.0114,0.0188,0.0279,0.0388,0.0521,0.0676,0.084]， // 未来1小时，逐分钟，雷达降水强度预报<br />
<br />
probability:[0.658591032,0.7041746378,0.5904211998,0.7576189041], // 未来2小时，逐半小时，雷达降水概率预报<br />
probability_4h:[0.7041746378,0.7576189041,0.764185369,0.6725049615], // 未来4小时，逐一小时，雷达降水概率预报<br />
datasource:radar},<br />
primary:0},<br />
location:[27.8943,<br />
118.1484], // 经纬度<br />
server_time:1542700934, // 服务器本次返回的utc时间戳<br />
tzshift:28800 // 时区的偏移秒数，如东八区就是 28800 秒<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
=='''变量说明'''==<br />
<blockquote>逐日预报，没有逐日预报的自然语言描述字段</blockquote><br />
{| class="wikitable"<br />
! 名称<br />
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释<br />
|-<br />
! 短临2h降水强度<br />
| $.result.minutely.precipitation_2h[：] || 雷达降水强度 || 逐日预报 || 全球 || 本地未来2小时逐分钟，短临降水强度预报<br />
|-<br />
! 短临4h降水强度<br />
| $.result.minutely.probability_4h[：] || 雷达降水强度 || 逐日预报 || 全球 || 本地未来2小时逐30钟，短临降水强度预报<br />
|}<br />
<br />
==支持的单位制==<br />
<br />
{{Template:彩云天气 API/支持的单位制}}<br />
<br />
[[Category:API 产品]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E5%AE%9E%E5%86%B5%E5%A4%A9%E6%B0%94%E6%8E%A5%E5%8F%A3/v2.2&diff=3705
实况天气接口/v2.2
2019-05-20T10:13:36Z
<p>XTao: </p>
<hr />
<div>{{彩云天气 API 版本状态}}<br />
<br />
=='''授权与认证'''==<br />
<br />
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。<br />
<br />
把您的 token 拼到 API 请求的 URL 中，如 <br />
<br />
<code><br />
<nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</nowiki><br />
</code><br />
<br />
其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！<br />
<br />
=='''请求样例'''==<br />
<br />
===== 示例1如下 =====<br />
<blockquote><code> <nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json</nowiki> </code></blockquote><blockquote><code> <nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.jsonp?callback=MYCALLBACK</nowiki></code></blockquote><blockquote>'''token ：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote><br />
<br />
==== 示例2如下 ====<br />
<blockquote><code> <nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/realtime.json?lang=en_US</nowiki> </code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI） 、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''默认为东八区，tzshift=28800；例如：印度东5.5区，tzshift=3600*5.5==19800，使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区，它们有非整齐的偏移量；考虑了欧美夏令时。</blockquote><br />
<br />
=='''返回结构和说明'''==<br />
<syntaxhighlight lang="yaml"><br />
<br />
status: ok<br />
api_version: v2.2 # 版本号<br />
api_status: active # 版本号状态<br />
lang: zh_CN # 语言<br />
unit: metric # 单位制<br />
location: [25.1552 121.6544] # 经纬度<br />
server_time: 1443418222 # 服务器本次返回的utc时间戳<br />
tzshift: 28800 # 时区的偏移秒数，如东八区就是 28800 秒<br />
result:<br />
status: ok # 实况模块返回状态<br />
temperature: 28.0 # 温度<br />
pres: 100991.3 # 气压<br />
humidity: 0.92 # 相对湿度<br />
wind:<br />
direction: 25.33 # 风向，单位是度。正北方向为0度，顺时针增加到360度。<br />
speed: 83.3 # 风速，米制下是公里每小时<br />
precipitation:<br />
nearest:<br />
status: ok<br />
distance: 0.77 # 最近的降水带距离<br />
intensity: 0.3125 # 最近的降水带降水强度（单位为雷达降水强度）<br />
local:<br />
status: ok<br />
intensity: 0.2812 # 本地降水强度（单位为雷达降水强度）<br />
datasource: radar # 本地降水观测的数据源（radar，GFS）<br />
cloudrate: 0.51 # 云量<br />
dswrf: 8.3 # 向下短波辐射通量<br />
visibility: 8.3 # 能见度<br />
skycon: RAIN # 主要天气现象<br />
comfort: # 舒适度指数及其自然语言描述<br />
index: 7 <br />
desc: 冷 <br />
ultraviolet: # 紫外线指数及其自然语言描述<br />
index: 0 <br />
desc: 无 <br />
pm25: 18 # pm25，质量浓度值<br />
pm10: 46 # pm10，质量浓度值<br />
o3: 47 # 臭氧，质量浓度值<br />
no2: 14 # 二氧化氮，质量浓度值<br />
so2: 1 # 二氧化硫，质量浓度值<br />
co: 0.3 # 一氧化碳，质量浓度值<br />
aqi: 46 # AQI（国标）<br />
<br />
</syntaxhighlight><br />
<br />
=='''变量说明'''==<br />
<br />
{| class="wikitable"<br />
! 名称<br />
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释<br />
|-<br />
! 温度<br />
| $.result.temperature || 温度 || 实况 || 全球 || 地表2米气温<br />
|-<br />
! 气压<br />
| $.result.pres || 气压(Pa) || 实况 || 全球 || 地面气压<br />
|-<br />
! 相对湿度<br />
| $.result.humidity || 相对湿度(%) || 实况 || 全球 || 地表2米湿度<br />
|-<br />
! 风向<br />
| $.result.wind.direction || 风向 || 实况 || 全球 || 地表10米风向<br />
|-<br />
! 风速<br />
| $.result.wind.speed || 风速 || 实况 || 全球 || 地表10米风速<br />
|-<br />
! 最近降水距离<br />
| $.result.precipitation.nearest.distance || 距离 || 实况 || 全球 || 最近降水带与本地的距离<br />
|-<br />
! 最近降水强度<br />
| $.result.precipitation.nearest.intensity || 降水强度 || 实况 || 全球 || 最近降水处的降水强度<br />
|-<br />
! 本地降水强度<br />
| $.result.precipitation.local.intensity || 雷达降水强度 || 实况 || 全球 || 最近降水处的降水强度<br />
|-<br />
! 云量<br />
| $.result.cloudrate || 云量(0.0-1.0) || 实况 || 全球 || 全天总云量<br />
|-<br />
! 短波辐射<br />
| $.result.dswrf|| 向下短波辐射通量(W/M2) || 实况 || 全球 || 地表向下短波辐射通量<br />
|-<br />
! 能见度<br />
| $.result.visibility || 能见度 || 实况 || 全球 || 地表水平能见度<br />
|-<br />
!<br />
!<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
! 天气状况<br />
| $.result.skycon || 天气状况 || 实况 || 全球 || 天气状况<br />
|-<br />
! 舒适度指数<br />
| $.result.comfort.index || 舒适度指数自然语言 || 实况 || 全球 || 舒适度指数及其描述<br />
|-<br />
! 紫外线指数<br />
| $.result.ultraviolet.index || 紫外线指数自然语言 || 实况 || 全球 || 紫外线指数及其描述<br />
|-<br />
!<br />
!<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
! PM25浓度<br />
| $.result.pm25 || PM25浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || PM25浓度<br />
|-<br />
! PM10浓度<br />
| $.result.pm10 || PM10浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || PM10浓度<br />
|-<br />
! 臭氧浓度<br />
| $.result.o3 || 臭氧浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 臭氧浓度<br />
|-<br />
! 二氧化氮浓度<br />
| $.result.no2 || 二氧化氮浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 二氧化氮浓度<br />
|-<br />
! 二氧化硫浓度<br />
| $.result.so2 || 二氧化硫浓度(μg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 二氧化硫浓度<br />
|-<br />
! 一氧化碳浓度<br />
| $.result.co || 一氧化碳浓度(mg/m3) || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 一氧化碳浓度<br />
|-<br />
! AQI<br />
| $.result.aqi || 国标AQI || 实况 || 大陆、港澳台、印度、日本，美国、阿拉斯加、夏威夷、加拿大 || 国标AQI<br />
|}<br />
{{天气现象}}<br />
<br />
=='''生活指数'''==<br />
{{生活指数}}<br />
<br />
=='''支持的单位制'''==<br />
<br />
{{Template:彩云天气 API/支持的单位制}}<br />
<br />
[[Category:API 产品]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E9%80%9A%E7%94%A8%E9%A2%84%E6%8A%A5%E6%8E%A5%E5%8F%A3/v2.2&diff=3704
通用预报接口/v2.2
2019-05-20T10:12:20Z
<p>XTao: </p>
<hr />
<div>{{彩云天气 API 版本状态}}<br />
<br />
=='''授权与认证'''==<br />
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。<br />
<br />
把您的 token 拼到 API 请求的 URL 中，如<br />
<br />
<code><br />
<nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</nowiki><br />
</code><br />
<br />
其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！<br />
<br />
=='''请求样例'''==<br />
<br />
=== '''示例1如下''' ===<br />
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.json</nowiki></code><br />
<br />
</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/weather.jsonp?callback=MYCALLBACK</nowiki></blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote><br />
<br />
=== '''示例2如下''' ===<br />
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/weather?lang=en_US</nowiki></code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI） 、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''用户提供所需时区偏移秒，考虑欧美夏令时，默认东八（tzshift=28800）；例如，用户希望取得印度（东5.5区）习惯定义下的逐日天气，加参数&tzshift=19800（=3600*5.5），然后daily的计算都会做相应处理。</blockquote><blockquote>'''定制返回的起始时间戳 begin'''：默认为当前utc时间戳，可以用来返回两日内的历史数据</blockquote><blockquote>'''定制返回逐小时预报总小时数 hourlysteps'''：默认为48小时（包括当前时刻）</blockquote><blockquote>'''定制返回逐日预报总天数 dailysteps'''：默认为5天（包括今天）</blockquote><blockquote>'''返回周围预警: alert='''true (注意小写)</blockquote><br />
<br />
=='''返回结构和说明'''==<br />
<blockquote>'''realtime'''分字段含义，请移步：[http://open.caiyunapp.com/%E5%AE%9E%E5%86%B5%E5%A4%A9%E6%B0%94%E6%8E%A5%E5%8F%A3/v2.2 实况接口/v2.2]</blockquote><blockquote>'''minutely'''分字段含义，请移步：[http://open.caiyunapp.com/%E7%9F%AD%E4%B8%B4%E9%99%8D%E6%B0%B4%E9%A2%84%E6%8A%A5%E6%8E%A5%E5%8F%A3/v2.2 逐分钟降水短临预报接口/v2.2]</blockquote><blockquote>'''hourly'''分字段含义，请移步：[[逐小时预报接口/v2.2]]</blockquote><blockquote>'''daily'''分字段含义，请移步：[[逐日预报接口/v2.2]]</blockquote><blockquote>'''alert'''分字段含义，如下：</blockquote><syntaxhighlight lang="javascript"><br />
<br />
{ status:ok,<br />
api_version:v2.2,<br />
api_status:active,<br />
unit:metric,<br />
lang:en_US,<br />
result:{<br />
forecast_keypoint:cloudy, clear weather after 23 this midnight,<br />
primary:0,<br />
realtime:{status:ok, ###请参考：实况接口/v2.2<br />
temperature:-1.21,<br />
pres:56320.24,<br />
humidity:0.09,<br />
wind:{direction:284.91,speed:30.12}},<br />
precipitation:{local:{status:ok,intensity:0.0,datasource:gfs}},<br />
cloudrate:0.3,<br />
dswrf:677.9,<br />
visibility:24.1,<br />
<br />
skycon:PARTLY_CLOUDY_DAY,<br />
ultraviolet:{index:5.0,desc:Moderat},<br />
comfort:{index:11,desc:Icy wind cold},<br />
<br />
pm25:3,<br />
pm10:10.0,<br />
o3:97.0,<br />
no2:2.0,<br />
so2:7.0,<br />
co:0.4,<br />
aqi:10<br />
},<br />
minutely:{status:ok, ###请参考：逐分钟降水短临预报接口/v2.2<br />
precipitation_2h:[0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,<br />
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,<br />
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,<br />
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,<br />
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0],<br />
precipitation:[0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,<br />
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,<br />
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0],<br />
datasource:gfs,<br />
description:No snow in the next hour<br />
},<br />
hourly:{status:ok, ###请参考：逐小时预报接口/v2.2<br />
description:cloudy, clear weather after 23 this midnight,<br />
temperature:[{value:-1.21,datetime:2018-11-20 16:00},{value:-0.51,datetime:2018-11-20 17:00}]},<br />
pres:[{value:56320.2411405722,datetime:2018-11-20 16:00},{value:56309.4272949293,datetime:2018-11-20 17:00}],<br />
humidity:[{value:0.09,datetime:2018-11-20 16:00},{value:0.11,datetime:2018-11-20 17:00}],<br />
wind:[{direction:284.91,speed:30.12,datetime:2018-11-20 16:00},{direction:288.24,speed:32.91,datetime:2018-11-20 17:00}],<br />
precipitation:[{value:0.0,datetime:2018-11-20 16:00},{value:0.0,datetime:2018-11-20 17:00}],<br />
cloudrate:[{value:0.3,datetime:2018-11-20 16:00},{value:0.3,datetime:2018-11-20 17:00}],<br />
dswrf:[{value:677.9121814107,datetime:2018-11-20 16:00},{value:596.25984,datetime:2018-11-20 17:00}],<br />
visibility:[{value:24.1,datetime:2018-11-20 16:00},{value:24.1,datetime:2018-11-20 17:00}],<br />
<br />
skycon:[{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 16:00},{value:WIND,datetime:2018-11-20 17:00}],<br />
pm25:[{value:3,datetime:2018-11-20 16:00},{value:0,datetime:2018-11-20 17:00}],<br />
aqi:[{value:10,datetime:2018-11-20 16:00},{value:0,datetime:2018-11-20 17:00}],<br />
},<br />
daily:{status:ok, ###请参考：逐日预报接口/v2.2<br />
temperature:[{date:2018-11-20,max:1.19,avg:-4.35,min:-16.0},{date:2018-11-21,max:2.0,avg:-7.32,min:-18.0}],<br />
pres:[{date:2018-11-20,max:56600.24,avg:56422.06,min:56309.43},{date:2018-11-21,max:56833.63,avg:56653.05,min:56553.63}],<br />
humidity:[{date:2018-11-20,max:0.23,avg:0.14,min:0.09},{date:2018-11-21,max:0.15,avg:0.11,min:0.06}],<br />
wind:[{date:2018-11-20,max:{direction:290.25,speed:35.9},avg:{direction:278.27,speed:19.65},min:{direction:230.17,speed:4.77}},<br />
{date:2018-11-21,max:{direction:276.13,speed:43.0},avg:{direction:262.47,speed:24.54},min:{direction:216.1,speed:12.48}}],<br />
precipitation:[{date:2018-11-20,max:0.0,avg:0.0,min:0.0},{date:2018-11-21,max:0.0,avg:0.0,min:0.0}],<br />
<br />
dswrf:[{date:2018-11-20,max:743.7,avg:321.5,min:0.0},{date:2018-11-21,max:748.3,avg:202.3,min:0.0}],<br />
cloudrate:[{date:2018-11-20,max:0.76,avg:0.49,min:0.0},{date:2018-11-21,max:0.15,avg:0.02,min:0.0}],<br />
visibility:[{date:2018-11-20,max:24.1,avg:24.1,min:24.1},{date:2018-11-21,max:24.1,avg:24.1,min:24.1}],<br />
<br />
skycon:[{date:2018-11-20,value:PARTLY_CLOUDY_DAY},{date:2018-11-21,value:CLEAR_DAY}],<br />
skycon_08h_20h:[{date:2018-11-20,value:CLEAR_DAY},{date:2018-11-21,value:CLEAR_DAY}]},<br />
skycon_20h_32h:[{date:2018-11-20,value:PARTLY_CLOUDY_NIGHT},{date:2018-11-21,value:CLEAR_NIGHT}],<br />
ultraviolet:[{index:5,desc:Very high,datetime:2018-11-20},{index:5,desc:Very high,datetime:2018-11-21}],<br />
comfort:[{index:13,desc:Dry cold,datetime:2018-11-20},{index:13,desc:Dry cold,datetime:2018-11-21}],<br />
carWashing:[{index:1,desc:Suitable,datetime:2018-11-20},{index:1,desc:Suitable,datetime:2018-11-21}],<br />
coldRisk:[{index:4,desc:Extremely prone,datetime:2018-11-20},{index:4,desc:Extremely prone,datetime:2018-11-21}],<br />
dressing:[{index:8,desc:Extremely cold,datetime:2018-11-20},{index:8,desc:Extremely cold,datetime:2018-11-21}],<br />
<br />
pm25:[{date:2018-11-20,max:3,avg:1.12,min:0},{date:2018-11-21,max:1,avg:0.58,min:0}],<br />
aqi:[{date:2018-11-20,max:10,avg:1.25,min:0},{date:2018-11-21,max:0,avg:0.0,min:0}],<br />
<br />
astro:[{date:2018-11-20,sunset:{time:19:07},sunrise:{time:08:40}},{date:2018-11-21,sunset:{time:19:07},sunrise:{time:08:41}}],<br />
},<br />
alert:{alert:{status:"ok"<br />
content:{<br />
0:{ request_status: "ok",<br />
source: "国家预警信息发布中心",<br />
<br />
county: "无",<br />
province: "江苏省",<br />
regionId: "unknown"<br />
city: "南京市",<br />
code: "1303", ##预警类型code<br />
adcode: "320100",<br />
<br />
alertId: "32010041600000_20181130104521",<br />
status: "预警中",<br />
title: "南京市气象台发布霾橙色预警[Ⅱ级/严重]",<br />
description: "南京市气象台2018年11月30日10时41分升级霾黄色预警信号为霾橙色预警信号。目前我市已经出现中度霾，预计未来24小时内霾将持续，请注意防范。"<br />
<br />
location: "江苏省南京市",<br />
latlon: {<br />
0: 32.060255,<br />
1: 118.796877<br />
}<br />
pubtimestamp: 1543545921,<br />
}<br />
}<br />
}<br />
},<br />
location:[31.658613,<br />
87.815109]<br />
server_time:1542702509,<br />
tzshift:28800,<br />
}<br />
<br />
</syntaxhighlight>{{预警类型}}{{天气现象}}<br />
<br />
=='''生活指数'''==<br />
{{生活指数}}<br />
<br />
=='''支持的单位制'''==<br />
<br />
{{Template:彩云天气 API/支持的单位制}}<br />
<br />
[[Category:API 产品]]</div>
XTao
https://open.caiyunapp.com/index.php?title=Template:%E5%A4%A9%E6%B0%94%E7%8E%B0%E8%B1%A1v2.5&diff=3630
Template:天气现象v2.5
2019-05-14T03:19:35Z
<p>XTao: </p>
<hr />
<div>=='''天气现象 skycon v2.5'''==<br />
<br />
主要天气现象的优先级：冰雹 > 雷阵雨 > 降雪 > 降雨 > 雾 > 沙尘 > 浮尘 > 雾霾 > 大风 > 阴 > 多云 > 晴<br />
<br />
{| class="wikitable"<br />
! 天气现象<br />
! 代码<br />
! 备注<br />
|-<br />
|晴（白天）<br />
|CLEAR_DAY<br />
|cloudrate < 0.2<br />
|-<br />
|晴（夜间）<br />
|CLEAR_NIGHT<br />
|cloudrate < 0.2<br />
|-<br />
|多云（白天）<br />
|PARTLY_CLOUDY_DAY<br />
|0.8 >= cloudrate > 0.2<br />
|-<br />
|多云（夜间）<br />
|PARTLY_CLOUDY_NIGHT<br />
|0.8 >= cloudrate > 0.2<br />
|-<br />
|阴<br />
|CLOUDY<br />
|cloudrate > 0.8<br />
|-<br />
|轻度雾霾<br />
|LIGHT_HAZE<br />
|PM2.5 100~150<br />
|-<br />
|中度雾霾<br />
|MODERATE_HAZE<br />
|PM2.5 150~200<br />
|-<br />
|重度雾霾<br />
|HEAVY_HAZE<br />
|PM2.5 > 200<br />
|-<br />
|小雨<br />
|LIGHT_RAIN<br />
|-<br />
|中雨<br />
|MODERATE_RAIN<br />
|-<br />
|大雨<br />
|HEAVY_RAIN<br />
|-<br />
|暴雨<br />
|STORM_RAIN<br />
|-<br />
|雾<br />
|FOG<br />
|能见度低，湿度高，风速低，温度低<br />
|-<br />
|小雪<br />
|LIGHT_SNOW<br />
|-<br />
|中雪<br />
|MODERATE_SNOW<br />
|-<br />
|大雪<br />
|HEAVY_SNOW<br />
|-<br />
|暴雪<br />
|STORM_SNOW<br />
|-<br />
|浮尘<br />
|DUST<br />
|aqi > 150，pm10 > 150，湿度 < 30%，风速 < 6 m/s<br />
|-<br />
|沙尘<br />
|SAND<br />
|aqi > 150，pm10 > 150，湿度 < 30%，风速 > 6 m/s<br />
|-<br />
|大风<br />
|WIND<br />
|-<br />
|雷阵雨<br />
|THUNDER_SHOWER<br />
|闪电+降水<br />
|-<br />
|冰雹<br />
|HAIL<br />
|闪电+降水+其他<br />
|-<br />
|雨夹雪<br />
|SLEET<br />
|}<br />
<br />
<br />
降水（RAIN，SNOW）强度 [单位：intensity]等级：<br />
<br />
（小雨 < 0.25 < 中雨 < 0.35 < 大雨 < 0.48 < 暴雨） <br />
<br />
<br />
雾霾类(HAZE）天气现象（skycon）分三个等级：<br />
<br />
{| class="wikitable"<br />
|-<br />
|轻度雾霾<br />
|中度雾霾<br />
|重度雾霾<br />
|-<br />
|AQI > 100<br />
|AQI > 150<br />
|AQI > 200<br />
|}<br />
<br />
空气污染的自然语言描述air_quality: description字段，根据AQI有六个等级划分：<br />
<br />
{| class="wikitable"<br />
|-<br />
|缺数据 missing<br />
|优 good<br />
|良 satisfactory <br />
|轻度污染 moderate <br />
|中度污染 unhealthy<br />
|重度污染 very poor<br />
|严重污染 hazardous<br />
|-<br />
|无测站国家和位置<br />
|0~50<br />
|51~100<br />
|101~150<br />
|151~200<br />
|201~300<br />
|>300<br />
|}</div>
XTao
https://open.caiyunapp.com/index.php?title=%E5%BD%A9%E4%BA%91%E5%A4%A9%E6%B0%94_API&diff=3430
彩云天气 API
2019-04-16T05:34:02Z
<p>XTao: /* 参考文档 */</p>
<hr />
<div>彩云天气 API是彩云开发者和企业合作伙伴获得彩云天气数据的主要渠道。<br />
<br />
==区域栅格数据接口==<br />
* [[中国区域降水实况栅格图API|雷达区域实况拼图接口]]<br />
* [[雷达单站实况和预报图接口]]<br />
* [[雾霾区域实况图接口]]<br />
<br />
==全球点数据接口==<br />
<br />
包含了如下几个时间尺度接口：<br />
<br />
* [[实况天气接口]]<br />
* [[分钟级降雨预报接口]]<br />
* [[小时级预报接口]]<br />
* [[天级预报接口]]<br />
* [[通用预报接口|通用点数据接口]]<br />
<br />
==全球点数据接口的版本==<br />
<br />
* [[彩云天气 API 的版本策略|全球点数据接口的版本策略]]<br />
* 当前版本：v2.2<br />
* 当前版本：[[彩云天气 API/v2.3|v2.3]]<br />
* 测试版本：[[彩云天气 API/v2.4|v2.4]]<br />
* 开发版本：[[彩云天气 API/v2.5|v2.5]]<br />
<br />
== 其他数据接口 ==<br />
* [[空气污染实况接口|空气污染站点实况接口]]<br />
* [[空气污染实况城市排名接口|空气污染城市实况排名接口]]<br />
* [[短临降水和气象预警推送接口]]<br />
* [[台风实况路径和预报接口]]<br />
* [[闪电实况接口]]<br />
* [[闪电实况接口|卫星实况接口]]<br />
<br />
== 参考文档 ==<br />
国内行政区域编码<br />
* [[File:adcode-20190416.csv.zip|国内行政区域编码]]<br />
* 20190416 更新<br />
<br />
国内城市经纬度对照表<br />
* [[File:cityidloc-20180625.csv.zip|经纬度对照表]]<br />
* 该文档为全国县级以上城市（共计2588个）的经纬度对照表。给出城市名，查询对应的经纬度。<br />
* 请用文本编辑器打开，excel打开会乱码。python程序可以使用csv库解析。<br />
* 此文件不推荐使用，请使用 "国内行政区域编码" 获取国内城市对应的数据。<br />
<br />
国际城市经纬度对照表<br />
* [[File: globalcities.csv.zip]]<br />
* 该文档为全球主要城市的经纬度对照表。给出城市名，查询对应的经纬度。<br />
* 请用文本编辑器打开，excel打开会乱码。python程序可以使用csv库解析。<br />
<br />
==反馈渠道==<br />
<br />
* [https://trello.com/b/RRa3flng/ 新特性自助申请]<br />
* [https://trello.com/b/z62UnLlw/ 现存BUG自助反馈]<br />
* [[彩云天气常见问题]]<br />
* [[联系我们]]<br />
<br />
[[Category:API 产品]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E5%BD%A9%E4%BA%91%E5%A4%A9%E6%B0%94_API&diff=3429
彩云天气 API
2019-04-16T05:33:30Z
<p>XTao: /* 参考文档 */</p>
<hr />
<div>彩云天气 API是彩云开发者和企业合作伙伴获得彩云天气数据的主要渠道。<br />
<br />
==区域栅格数据接口==<br />
* [[中国区域降水实况栅格图API|雷达区域实况拼图接口]]<br />
* [[雷达单站实况和预报图接口]]<br />
* [[雾霾区域实况图接口]]<br />
<br />
==全球点数据接口==<br />
<br />
包含了如下几个时间尺度接口：<br />
<br />
* [[实况天气接口]]<br />
* [[分钟级降雨预报接口]]<br />
* [[小时级预报接口]]<br />
* [[天级预报接口]]<br />
* [[通用预报接口|通用点数据接口]]<br />
<br />
==全球点数据接口的版本==<br />
<br />
* [[彩云天气 API 的版本策略|全球点数据接口的版本策略]]<br />
* 当前版本：v2.2<br />
* 当前版本：[[彩云天气 API/v2.3|v2.3]]<br />
* 测试版本：[[彩云天气 API/v2.4|v2.4]]<br />
* 开发版本：[[彩云天气 API/v2.5|v2.5]]<br />
<br />
== 其他数据接口 ==<br />
* [[空气污染实况接口|空气污染站点实况接口]]<br />
* [[空气污染实况城市排名接口|空气污染城市实况排名接口]]<br />
* [[短临降水和气象预警推送接口]]<br />
* [[台风实况路径和预报接口]]<br />
* [[闪电实况接口]]<br />
* [[闪电实况接口|卫星实况接口]]<br />
<br />
== 参考文档 ==<br />
国内行政区域编码<br />
* [[File:adcode-20190416.csv.zip|国内行政区域编码]]<br />
* 20190416 更新<br />
<br />
<br />
国内城市经纬度对照表<br />
* [[File:cityidloc-20180625.csv.zip|经纬度对照表]]<br />
* 该文档为全国县级以上城市（共计2588个）的经纬度对照表。给出城市名，查询对应的经纬度。<br />
* 请用文本编辑器打开，excel打开会乱码。python程序可以使用csv库解析。<br />
* 此文件不推荐使用，请使用 "国内行政区域编码" 获取国内城市对应的数据。<br />
<br />
国际城市经纬度对照表<br />
* [[File: globalcities.csv.zip]]<br />
* 该文档为全球主要城市的经纬度对照表。给出城市名，查询对应的经纬度。<br />
* 请用文本编辑器打开，excel打开会乱码。python程序可以使用csv库解析。<br />
<br />
==反馈渠道==<br />
<br />
* [https://trello.com/b/RRa3flng/ 新特性自助申请]<br />
* [https://trello.com/b/z62UnLlw/ 现存BUG自助反馈]<br />
* [[彩云天气常见问题]]<br />
* [[联系我们]]<br />
<br />
[[Category:API 产品]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E5%BD%A9%E4%BA%91%E5%A4%A9%E6%B0%94_API&diff=3428
彩云天气 API
2019-04-16T05:32:53Z
<p>XTao: /* 参考文档 */</p>
<hr />
<div>彩云天气 API是彩云开发者和企业合作伙伴获得彩云天气数据的主要渠道。<br />
<br />
==区域栅格数据接口==<br />
* [[中国区域降水实况栅格图API|雷达区域实况拼图接口]]<br />
* [[雷达单站实况和预报图接口]]<br />
* [[雾霾区域实况图接口]]<br />
<br />
==全球点数据接口==<br />
<br />
包含了如下几个时间尺度接口：<br />
<br />
* [[实况天气接口]]<br />
* [[分钟级降雨预报接口]]<br />
* [[小时级预报接口]]<br />
* [[天级预报接口]]<br />
* [[通用预报接口|通用点数据接口]]<br />
<br />
==全球点数据接口的版本==<br />
<br />
* [[彩云天气 API 的版本策略|全球点数据接口的版本策略]]<br />
* 当前版本：v2.2<br />
* 当前版本：[[彩云天气 API/v2.3|v2.3]]<br />
* 测试版本：[[彩云天气 API/v2.4|v2.4]]<br />
* 开发版本：[[彩云天气 API/v2.5|v2.5]]<br />
<br />
== 其他数据接口 ==<br />
* [[空气污染实况接口|空气污染站点实况接口]]<br />
* [[空气污染实况城市排名接口|空气污染城市实况排名接口]]<br />
* [[短临降水和气象预警推送接口]]<br />
* [[台风实况路径和预报接口]]<br />
* [[闪电实况接口]]<br />
* [[闪电实况接口|卫星实况接口]]<br />
<br />
== 参考文档 ==<br />
国内行政区域编码<br />
* [[File:adcode-20190416.csv.zip|国内行政区域编码]]<br />
<br />
<br />
国内城市经纬度对照表<br />
* [[File:cityidloc-20180625.csv.zip|经纬度对照表]]<br />
* 该文档为全国县级以上城市（共计2588个）的经纬度对照表。给出城市名，查询对应的经纬度。<br />
* 请用文本编辑器打开，excel打开会乱码。python程序可以使用csv库解析。<br />
* 此文件已被废弃，请使用 "国内行政区域编码" 获取国内城市对应的数据。<br />
<br />
国际城市经纬度对照表<br />
* [[File: globalcities.csv.zip]]<br />
* 该文档为全球主要城市的经纬度对照表。给出城市名，查询对应的经纬度。<br />
* 请用文本编辑器打开，excel打开会乱码。python程序可以使用csv库解析。<br />
<br />
==反馈渠道==<br />
<br />
* [https://trello.com/b/RRa3flng/ 新特性自助申请]<br />
* [https://trello.com/b/z62UnLlw/ 现存BUG自助反馈]<br />
* [[彩云天气常见问题]]<br />
* [[联系我们]]<br />
<br />
[[Category:API 产品]]</div>
XTao
https://open.caiyunapp.com/index.php?title=File:Adcode-20190416.csv.zip&diff=3427
File:Adcode-20190416.csv.zip
2019-04-16T05:31:09Z
<p>XTao: 行政区域编码 (20190416 更新)</p>
<hr />
<div>行政区域编码 (20190416 更新)</div>
XTao
https://open.caiyunapp.com/index.php?title=%E5%B0%8F%E6%97%B6%E7%BA%A7%E9%A2%84%E6%8A%A5%E6%8E%A5%E5%8F%A3/v2.2&diff=2658
小时级预报接口/v2.2
2019-01-21T02:42:49Z
<p>XTao: 删除 fields 参数</p>
<hr />
<div>{{彩云天气 API 版本状态}}<br />
<br />
=='''授权与认证'''==<br />
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。<br />
<br />
把您的 token 拼到 API 请求的 URL 中，如<br />
<br />
<code><br />
<nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</nowiki><br />
</code><br />
<br />
其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！<br />
<br />
=='''请求样例'''==<br />
<br />
=== '''示例1如下''' ===<br />
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</nowiki></code><br />
<br />
</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.jsonp?callback=MYCALLBACK</nowiki></blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote><br />
<br />
=== '''示例2如下''' ===<br />
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly?lang=en_US&hourlysteps=2</nowiki></code></blockquote><blockquote>'''语言选项 lang：'''简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI） 、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''默认为东八区，tzshift=28800；例如：印度东5.5区，tzshift=3600*5.5==19800，v2.3之后版本，返回时区信息，使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区，它们有非整齐的偏移量</blockquote><blockquote>'''定制返回逐小时预报总小时数 hourlysteps'''：默认为120小时</blockquote><br />
==返回结构和说明==<br />
<syntaxhighlight lang="javascript"><br />
<br />
{ status:ok,<br />
api_version:v2.2, // 版本号<br />
api_status:active, // 版本号状态<br />
lang:en_US, // 语言<br />
unit:metric, // 单位制<br />
result:{<br />
hourly:{<br />
status:ok, // 逐小时预报模块返回状态<br />
temperature:[{value:23.0,datetime:2018-11-20 10:00},{value:22.0,datetime:2018-11-20 11:00}]}, // 温度<br />
pres:[{value:100279.8643200001,datetime:2018-11-20 10:00},{value:100249.1918336001,datetime:2018-11-20 11:00}], // 气压<br />
humidity:[{value:0.77,datetime:2018-11-20 10:00},{value:0.77,datetime:2018-11-20 11:00}], // 相对湿度<br />
wind:[ { direction:95.62, // 风向，单位是度。正北方向为0度，顺时针增加到360度。<br />
speed:22.85,datetime:2018-11-20 10:00}, // 风速，米制下是公里每小时<br />
{ direction:97.97,<br />
speed:23.27,datetime:2018-11-20 11:00}],<br />
precipitation:[{value:0.0,datetime:2018-11-20 10:00},{value:0.0,datetime:2018-11-20 11:00}], // 本地降水强度(单位见表格)<br />
cloudrate:[{value:0.77,datetime:2018-11-20 10:00},{value:0.46,datetime:2018-11-20 11:00}], // 云量<br />
dswrf:[{value:344.09456384,datetime:2018-11-20 10:00},{value:325.9617024,datetime:2018-11-20 11:00}], // 短波辐射<br />
visibility:[{value:23.24,datetime:2018-11-20 10:00},{value:23.0,datetime:2018-11-20 11:00}], // 能见度<br />
<br />
skycon:[{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 10:00},{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 11:00}], // 主要天气现象<br />
description:cloudy, clear weather after 7 tomorrow morning, increasing cloudiness, // 逐小时天气预报，自然语言描述<br />
forecast_keypoint:cloudy, clear weather after 7 tomorrow morning, increasing cloudiness,primary:0， // 逐小时和逐分钟天气预报，综合自然语言描述<br />
<br />
pm25:[{value:8,datetime:2018-11-20 10:00},{value:9,datetime:2018-11-20 11:00}], // PM2.5<br />
aqi:[{value:33,datetime:2018-11-20 10:00},{value:13,datetime:2018-11-20 11:00}] // AQI(国标)<br />
},<br />
location:[25.1552,<br />
121.6544] // 经纬度<br />
placename:Unnamed Road, Wanli District, New Taipei City, Taiwan 207, // 经纬度处地址<br />
server_time:1542695724, // 服务器本次返回的utc时间戳<br />
tzshift:14400, // 时区的偏移秒数，如东八区就是 28800 秒<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
=='''变量说明'''==<br />
<blockquote>逐小时预报，没有生活指数变量</blockquote><br />
{| class="wikitable"<br />
! 名称<br />
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释<br />
|-<br />
! 温度<br />
| $.result.hourly.temperature.value || 温度 || 逐小时预报 || 全球 || 地表2米气温<br />
|-<br />
! 气压<br />
| $.result.hourly.pres.value || 气压(Pa) || 逐小时预报 || 全球 || 地面气压<br />
|-<br />
! 相对湿度<br />
| $.result.hourly.humidity.value || 相对湿度(%) || 逐小时预报 || 全球 || 地表2米湿度<br />
|-<br />
! 风向<br />
| $.result.hourly.wind.direction.value || 风向 || 逐小时预报 || 全球 || 地表10米风向<br />
|-<br />
! 风速<br />
| $.result.hourly.wind.speed.value || 风速 || 逐小时预报 || 全球 || 地表10米风速<br />
|-<br />
! 本地降水强度<br />
| $.result.hourly.precipitation.value || 降水量(mm/h) || 逐小时预报 || 全球 || 本地降水量<br />
|-<br />
! 云量<br />
| $.result.hourly.cloudrate.value || 云量(0.0-1.0) || 逐小时预报 || 全球 || 全天总云量<br />
|-<br />
! 短波辐射<br />
| $.result.hourly.dswrf.value|| 向下短波辐射通量(W/M2) || 逐小时预报 || 全球 || 地表向下短波辐射通量<br />
|-<br />
! 能见度<br />
| $.result.hourly.visibility.value || 能见度 || 逐小时预报 || 全球 || 地表水平能见度<br />
|-<br />
!<br />
!<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
! 主要天气现象<br />
| $.result.hourly.skycon.value || 天气状况 || 逐小时预报 || 全球 || 天气状况<br />
|-<br />
! 逐小时预报自然语言描述<br />
| $.result.hourly.description || 舒适度指数自然语言 || 逐小时预报 || 全球 || 舒适度指数及其描述<br />
|-<br />
! 综合预报自然语言描述<br />
| $.result.hourly.forecast_keypoint || 紫外线指数自然语言 || 逐小时预报 || 全球 || 逐小时和逐分钟天气预报，综合自然语言描述<br />
|-<br />
!<br />
!<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
! PM25浓度<br />
| $.result.hourly.pm25.value || PM25浓度(μg/m3) || 逐小时预报 || 大陆、港澳台、暂无印度 || PM25浓度<br />
|-<br />
! AQI<br />
| $.result.hourly.aqi.value || 国标AQI || 逐小时预报 || 大陆、港澳台、暂无印度 || 国标AQI<br />
|}<br />
{{天气现象}}<br />
<br />
==支持的单位制==<br />
<br />
{{Template:彩云天气 API/支持的单位制}}<br />
<br />
[[Category:API 产品]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E5%B0%8F%E6%97%B6%E7%BA%A7%E9%A2%84%E6%8A%A5%E6%8E%A5%E5%8F%A3/v2.2&diff=2424
小时级预报接口/v2.2
2019-01-12T07:37:15Z
<p>XTao: 修正默认降水量描述</p>
<hr />
<div>{{彩云天气 API 版本状态}}<br />
<br />
=='''授权与认证'''==<br />
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。<br />
<br />
把您的 token 拼到 API 请求的 URL 中，如<br />
<br />
<code><br />
<nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</nowiki><br />
</code><br />
<br />
其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！<br />
<br />
=='''请求样例'''==<br />
<br />
=== '''示例1如下''' ===<br />
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.json</nowiki></code><br />
<br />
</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly.jsonp?callback=MYCALLBACK</nowiki></blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote><br />
<br />
=== '''示例2如下''' ===<br />
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/hourly?lang=en_US&hourlysteps=2</nowiki></code></blockquote><blockquote>'''语言选项 lang：'''简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI） 、英制（imperial）</blockquote><blockquote>'''时区偏移秒数 tzshift：'''默认为东八区，tzshift=28800；例如：印度东5.5区，tzshift=3600*5.5==19800，v2.3之后版本，返回时区信息，使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区，它们有非整齐的偏移量</blockquote><blockquote>'''定制返回逐小时预报总小时数 hourlysteps'''：默认为120小时</blockquote><blockquote>'''定制返回变量列表 fields：'''tmp,vis 默认返回所有变量，【'ast', 'rad', 'prc', 'tmp', 'wnd', 'hmd', 'cld', 'aqi', 'pm25', 'pm25w', 'sky', 'skyh', 'lfi', 'alr', 'pres', 'vis', 'dswrf'】</blockquote><br />
==返回结构和说明==<br />
<syntaxhighlight lang="javascript"><br />
<br />
{ status:ok,<br />
api_version:v2.2, // 版本号<br />
api_status:active, // 版本号状态<br />
lang:en_US, // 语言<br />
unit:metric, // 单位制<br />
result:{<br />
hourly:{<br />
status:ok, // 逐小时预报模块返回状态<br />
temperature:[{value:23.0,datetime:2018-11-20 10:00},{value:22.0,datetime:2018-11-20 11:00}]}, // 温度<br />
pres:[{value:100279.8643200001,datetime:2018-11-20 10:00},{value:100249.1918336001,datetime:2018-11-20 11:00}], // 气压<br />
humidity:[{value:0.77,datetime:2018-11-20 10:00},{value:0.77,datetime:2018-11-20 11:00}], // 相对湿度<br />
wind:[ { direction:95.62, // 风向，单位是度。正北方向为0度，顺时针增加到360度。<br />
speed:22.85,datetime:2018-11-20 10:00}, // 风速，米制下是公里每小时<br />
{ direction:97.97,<br />
speed:23.27,datetime:2018-11-20 11:00}],<br />
precipitation:[{value:0.0,datetime:2018-11-20 10:00},{value:0.0,datetime:2018-11-20 11:00}], // 本地降水强度(单位见表格)<br />
cloudrate:[{value:0.77,datetime:2018-11-20 10:00},{value:0.46,datetime:2018-11-20 11:00}], // 云量<br />
dswrf:[{value:344.09456384,datetime:2018-11-20 10:00},{value:325.9617024,datetime:2018-11-20 11:00}], // 短波辐射<br />
visibility:[{value:23.24,datetime:2018-11-20 10:00},{value:23.0,datetime:2018-11-20 11:00}], // 能见度<br />
<br />
skycon:[{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 10:00},{value:PARTLY_CLOUDY_DAY,datetime:2018-11-20 11:00}], // 主要天气现象<br />
description:cloudy, clear weather after 7 tomorrow morning, increasing cloudiness, // 逐小时天气预报，自然语言描述<br />
forecast_keypoint:cloudy, clear weather after 7 tomorrow morning, increasing cloudiness,primary:0， // 逐小时和逐分钟天气预报，综合自然语言描述<br />
<br />
pm25:[{value:8,datetime:2018-11-20 10:00},{value:9,datetime:2018-11-20 11:00}], // PM2.5<br />
aqi:[{value:33,datetime:2018-11-20 10:00},{value:13,datetime:2018-11-20 11:00}] // AQI(国标)<br />
},<br />
location:[25.1552,<br />
121.6544] // 经纬度<br />
placename:Unnamed Road, Wanli District, New Taipei City, Taiwan 207, // 经纬度处地址<br />
server_time:1542695724, // 服务器本次返回的utc时间戳<br />
tzshift:14400, // 时区的偏移秒数，如东八区就是 28800 秒<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
=='''变量说明'''==<br />
<blockquote>逐小时预报，没有生活指数变量</blockquote><br />
{| class="wikitable"<br />
! 名称<br />
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释<br />
|-<br />
! 温度<br />
| $.result.hourly.temperature.value || 温度 || 逐小时预报 || 全球 || 地表2米气温<br />
|-<br />
! 气压<br />
| $.result.hourly.pres.value || 气压(Pa) || 逐小时预报 || 全球 || 地面气压<br />
|-<br />
! 相对湿度<br />
| $.result.hourly.humidity.value || 相对湿度(%) || 逐小时预报 || 全球 || 地表2米湿度<br />
|-<br />
! 风向<br />
| $.result.hourly.wind.direction.value || 风向 || 逐小时预报 || 全球 || 地表10米风向<br />
|-<br />
! 风速<br />
| $.result.hourly.wind.speed.value || 风速 || 逐小时预报 || 全球 || 地表10米风速<br />
|-<br />
! 本地降水强度<br />
| $.result.hourly.precipitation.value || 降水量(mm/h) || 逐小时预报 || 全球 || 本地降水量<br />
|-<br />
! 云量<br />
| $.result.hourly.cloudrate.value || 云量(0.0-1.0) || 逐小时预报 || 全球 || 全天总云量<br />
|-<br />
! 短波辐射<br />
| $.result.hourly.dswrf.value|| 向下短波辐射通量(W/M2) || 逐小时预报 || 全球 || 地表向下短波辐射通量<br />
|-<br />
! 能见度<br />
| $.result.hourly.visibility.value || 能见度 || 逐小时预报 || 全球 || 地表水平能见度<br />
|-<br />
!<br />
!<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
! 主要天气现象<br />
| $.result.hourly.skycon.value || 天气状况 || 逐小时预报 || 全球 || 天气状况<br />
|-<br />
! 逐小时预报自然语言描述<br />
| $.result.hourly.description || 舒适度指数自然语言 || 逐小时预报 || 全球 || 舒适度指数及其描述<br />
|-<br />
! 综合预报自然语言描述<br />
| $.result.hourly.forecast_keypoint || 紫外线指数自然语言 || 逐小时预报 || 全球 || 逐小时和逐分钟天气预报，综合自然语言描述<br />
|-<br />
!<br />
!<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
! PM25浓度<br />
| $.result.hourly.pm25.value || PM25浓度(μg/m3) || 逐小时预报 || 大陆、港澳台、暂无印度 || PM25浓度<br />
|-<br />
! AQI<br />
| $.result.hourly.aqi.value || 国标AQI || 逐小时预报 || 大陆、港澳台、暂无印度 || 国标AQI<br />
|}<br />
{{天气现象}}<br />
<br />
==支持的单位制==<br />
<br />
{{Template:彩云天气 API/支持的单位制}}<br />
<br />
[[Category:API 产品]]</div>
XTao
https://open.caiyunapp.com/index.php?title=%E5%A4%A9%E7%BA%A7%E9%A2%84%E6%8A%A5%E6%8E%A5%E5%8F%A3/v2.2&diff=2423
天级预报接口/v2.2
2019-01-12T07:36:08Z
<p>XTao: 修正默认降水量描述</p>
<hr />
<div>{{彩云天气 API 版本状态}}<br />
<br />
=='''授权与认证'''==<br />
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。<br />
<br />
把您的 token 拼到 API 请求的 URL 中，如<br />
<br />
<code><br />
<nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</nowiki><br />
</code><br />
<br />
其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！<br />
<br />
=='''请求样例'''==<br />
<br />
=== '''示例1如下''' ===<br />
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json</nowiki></code><br />
<br />
</blockquote><blockquote><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.jsonp?callback=MYCALLBACK</nowiki></blockquote><blockquote>'''token：'''这里是测试 token ，即 <code>TAkhjf8d1nlSlspN</code></blockquote><blockquote>'''经纬度：'''经度在前，纬度在后，中间用半角逗号隔开，这里是 <code>121.6544,25.1552</code></blockquote><blockquote>'''返回格式：'''json 或者 jsonp，jsonp 需提供回调函数名</blockquote><br />
<br />
=== '''示例2如下''' ===<br />
<blockquote><code><nowiki>https://api.caiyunapp.com/v2/TAkhjf8d1nlSlspN/121.6544,25.1552/daily.json?lang=en_US&dailysteps=360</nowiki></code></blockquote><blockquote>'''语言选项 lang：'''默认为简体中文（zh_CN）、繁体中文（zh_TW）、美式英语（en_US）、英式英语（en_GB）</blockquote><blockquote>'''单位制选项 unit：'''默认为公制（metric）、科学单位体系（SI） 、英制（imperial）</blockquote><blockquote>'''定制返回逐日预报总日数 dailysteps'''：默认为5日</blockquote><blockquote>'''时区偏移秒数 tzshift：'''默认为东八区，tzshift=28800；例如：印度东5.5区，tzshift=3600*5.5==19800，v2.3之后版本，返回时区信息，使用秒是为了支持像尼泊尔这样的差 5 小时 45 分钟的地区，它们有非整齐的偏移量</blockquote><br />
==返回结构和说明==<br />
<syntaxhighlight lang="javascript"><br />
{ status:ok, // 返回状态<br />
api_version:v2.2, // 版本号<br />
api_status:active, // 版本号状态<br />
lang:en_US, // 语言<br />
unit:metric, // 单位制<br />
result:{<br />
primary:0,<br />
daily:{<br />
status:ok, // 逐日预报模块返回状态<br />
temperature:[{date:2018-11-20,max:23.0,avg:20.37,min:20.0},{date:2018-11-21,max:26.0,avg:22.97,min:20.33}], // 温度，最大值，平均值，最小值<br />
pres:[{date:2018-11-20,max:100519.86,avg:100238.05,min:100119.53},{date:2018-11-21,max:100470.46,avg:100214.34,min:99940.79}], // 气压，最大值，平均值，最小值<br />
humidity:[{date:2018-11-20,max:0.86,avg:0.84,min:0.76},{date:2018-11-21,max:0.87,avg:0.79,min:0.68}], // 相对湿度，最大值，平均值，最小值<br />
wind:[{ date:2018-11-20,<br />
max:{direction:70.43,speed:24.17}, // 风速，最大值，平均值，最小值<br />
avg:{direction:101.11,speed:21.81},<br />
min:{direction:148.08,speed:14.8}},<br />
{ date:2018-11-21,<br />
max:{direction:19.36,speed:29.25},<br />
avg:{direction:24.59,speed:14.73},<br />
min:{direction:254.91,speed:2.53}}],<br />
precipitation:[{date:2018-11-20,max:0.0699,avg:0.0,min:0.0},{date:2018-11-21,max:0.2583,avg:0.0581,min:0.0}], // 本地降水强度，最大值，平均值，最小值(单位见表格)<br />
<br />
cloudrate:[{date:2018-11-20,max:0.91,avg:0.62,min:0.18},{date:2018-11-21,max:1.0,avg:0.45,min:0.0}], // 云量，最大值，平均值，最小值<br />
dswrf:[{date:2018-11-20,max:344.1,avg:84.0,min:0.0},{date:2018-11-21,max:601.5,avg:197.7,min:0.0}], // 短波辐射，最大值，平均值，最小值<br />
visibility:[{date:2018-11-20,max:24.1,avg:22.9,min:14.2},{date:2018-11-21,max:24.1,avg:20.4,min:13.7}], // 能见度，最大值，平均值，最小值<br />
<br />
skycon:[{date:2018-11-20,value:PARTLY_CLOUDY_DAY},{date:2018-11-21,value:PARTLY_CLOUDY_DAY}], // 全天，主要天气现象<br />
skycon_08h_20h:[{date:2018-11-20,value:PARTLY_CLOUDY_DAY},{date:2018-11-21,value:PARTLY_CLOUDY_DAY}] // 白天，主要天气现象<br />
skycon_20h_32h:[{date:2018-11-20,value:PARTLY_CLOUDY_NIGHT},{date:2018-11-21,value:RAIN}], // 夜晚，主要天气现象<br />
<br />
ultraviolet:[{index:3,desc:Moderat,datetime:2018-11-20},{index:3,desc:Moderat,datetime:2018-11-21}], // 午间，紫外线指数和自然语言描述<br />
comfort:[{index:4,desc:Warm,datetime:2018-11-20},{index:4,desc:Warm,datetime:2018-11-21}], // 全天，舒适度指数和自然语言描述<br />
carWashing:[{index:3,desc:Less appropriate,datetime:2018-11-20},{index:3,desc:Less appropriate,datetime:2018-11-21}], // 全天，洗车指数和自然语言描述<br />
coldRisk:[{index:3,desc:Prone,datetime:2018-11-20},{index:3,desc:Prone,datetime:2018-11-21}], // 全天，感冒指数和自然语言描述<br />
dressing:[{index:5,desc:Cool,datetime:2018-11-20},{index:3,desc:Hot,datetime:2018-11-21}], // 全天，冷暖指数和自然语言描述（淘汰...）<br />
<br />
pm25:[{date:2018-11-20,max:20,avg:15.62,min:8},{date:2018-11-21,max:28,avg:22.29,min:12}], // PM2.5，最大值，平均值，最小值<br />
aqi:[{date:2018-11-20,max:42,avg:24.08,min:14},{date:2018-11-21,max:40,avg:31.75,min:17}], // AQI(国标)，最大值，平均值，最小值<br />
<br />
astro:[{date:2018-11-20,<br />
sunset:{time:17:04},<br />
sunrise:{time:06:13}},<br />
{date:2018-11-21,<br />
sunset:{time:17:04}, // 日出时间(北京时间，tzshift不作用在这个变量)<br />
sunrise:{time:06:14}}], // 日出时间(返回北京时间，tzshift不作用在这个变量)<br />
}<br />
},<br />
location:[25.1552,<br />
121.6544], // 经纬度<br />
placename:Unnamed Road, Wanli District, New Taipei City, Taiwan 207, // 经纬度处地址<br />
server_time:1542698313, // 服务器本次返回的utc时间戳<br />
tzshift:14400, // 时区的偏移秒数，如东八区就是 28800 秒<br />
}<br />
<br />
</syntaxhighlight><br />
<br />
=='''变量说明'''==<br />
<blockquote>逐日预报，没有逐日预报的自然语言描述字段</blockquote><br />
{| class="wikitable"<br />
! 名称<br />
! 健值路径（jsonpath） !! 量 !! 时间粒度 !! 地理范围 !! 注释<br />
|-<br />
! 温度<br />
| $.result.daily.temperature[max,min,avg] || 温度 || 逐日预报 || 全球 || 地表2米气温<br />
|-<br />
! 气压<br />
| $.result.daily.pres[max,min,avg] || 气压(Pa) || 逐日预报 || 全球 || 地面气压<br />
|-<br />
! 相对湿度<br />
| $.result.daily.humidity[max,min,avg] || 相对湿度(%) || 逐日预报 || 全球 || 地表2米湿度<br />
|-<br />
! 风速<br />
| $.result.daily.wind.speed[max,min,avg] || 风速 || 逐日预报 || 全球 || 地表10米风速<br />
|-<br />
! 本地降水强度<br />
| $.result.daily.precipitation[max,min,avg] || 降水量(mm/h) || 逐日预报 || 全球 || 本地降水量<br />
|-<br />
! 云量<br />
| $.result.daily.cloudrate[max,min,avg] || 云量(0.0-1.0) || 逐日预报 || 全球 || 全天总云量<br />
|-<br />
! 短波辐射<br />
| $.result.daily.dswrf[max,min,avg]|| 向下短波辐射通量(W/M2) || 逐日预报 || 全球 || 地表向下短波辐射通量<br />
|-<br />
! 能见度<br />
| $.result.daily.visibility[max,min,avg] || 能见度 || 逐日预报 || 全球 || 地表水平能见度<br />
|-<br />
!<br />
!<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
! 全天主要天气现象<br />
| $.result.daily.skycon.value || 天气状况 || 逐日预报 || 全球 || 全天主要天气现象<br />
|-<br />
! 白天主要天气现象<br />
| $.result.daily.skycon_08h_20h.value|| 天气状况 || 逐日预报 || 全球 || 白天主要天气现象<br />
|-<br />
! 夜晚主要天气现象<br />
| $.result.daily.skycon_20h_32h.value|| 天气状况 || 逐日预报 || 全球 || 夜晚主要天气现象<br />
|-<br />
! 紫外线指数<br />
| $.result.daily.ultraviolet.desc|| 紫外线指数自然语言 || 逐日预报 || 全球 || 紫外线指数及其描述<br />
|-<br />
! 舒适度指数<br />
| $.result.daily.comfort.desc|| 舒适度指数自然语言 || 逐日预报 || 全球 || 舒适度指数及其描述<br />
|-<br />
! 洗车指数<br />
| $.result.daily.carWashing.desc|| 洗车指数自然语言 || 逐日预报 || 全球 || 洗车指数及其描述<br />
|-<br />
! 感冒指数<br />
| $.result.daily.coldRisk.desc|| 感冒指数自然语言 || 逐日预报 || 全球 || 感冒指数及其描述<br />
|-<br />
! 穿衣指数<br />
| $.result.daily.dressing.desc|| 冷热指数自然语言 || 逐日预报 || 全球 || 穿衣指数（dressing），不建议继续使用，请使用舒适度<br />
|-<br />
!<br />
!<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
! PM25浓度<br />
| $.result.daily.pm25[max,min,avg] || PM25浓度(μg/m3) || 逐日预报 || 大陆、港澳台、暂无印度 || PM25浓度<br />
|-<br />
! AQI<br />
| $.result.daily.aqi[max,min,avg] || 国标AQI || 逐日预报 || 大陆、港澳台、暂无印度 || 国标AQI<br />
|-<br />
!<br />
!<br />
!<br />
!<br />
!<br />
!<br />
|-<br />
! 日出日落<br />
| $.result.astro.aqi[sunrise,sunset] || 国标AQI || 逐日预报 || 大陆、港澳台、暂无印度 || 日出日落(当地时区的时刻，tzshift不作用在这个变量)<br />
|}<br />
{{天气现象}}<br />
<br />
=='''生活指数'''==<br />
{{生活指数}}<br />
<br />
==支持的单位制==<br />
{{Template:彩云天气 API/支持的单位制}}<br />
<br />
[[Category:API 产品]]</div>
XTao