海迅社API接口文档(V2.0)

更新

(1)更新时间:2019年02月15日。更新内容:创建API接口文档。

(2)更新时间:2019年06月28日。更新内容:资源字段、订单接口。删除微信、微博接口。

目录

签名(signature)生成规则

海外推广资源

软文发布资源

自媒体资源

资源状态查询

创建订单

查询订单

更新订单

签名(signature)生成规则

例:请求参数为 a=2  c=1  b=3

(1)对请求参数(不包括 signature)按照参数名ASCII码表升序排序。排序后为:a=2  b=3  c=1

(2)将排序好的参数生成字符串。格式为:a=2&b=3&c=1

(3)将key(海讯社提供)参数拼接至字符串末尾。格式为:a=2&b=3&c=1&key=xxxx

(4)对字符串进行MD5算法。生成MD5值(即signature):8b3f0a9b04415a542568089ffee2560f

海外推广资源

注:请定时更新, 确保资源同步。资源状态可根据资源状态接口查询。

接口地址:https://haixunpr.org/api/getAbroad

请求方式:POST

请求参数:

参数名 必填 描述
token Y 海讯社提供token
timestamp Y 时间戳,时间戳为10位
signature Y 签名,请参考签名生成规则
page Y 页数
limit Y 每页条数

返回参数(json格式):

参数名 描述
code 100成功 101失败
message 描述信息
count 总数量
data 返回数据(参考data字段说明)

data字段说明:

参数名 类型 描述
sourceid String 资源id
type Integer 类别(4:翻译 5:数字营销 6:海外发稿)
classify String 媒体分类
region String 区域
name String 媒体名称
costprice Double 价格
entrancelink String 入口链接
caseurl String 案例地址
searchcoll String 搜索收录
linktype Integer 链接类型( 2:可带网址 0:不可带网址)
publishtime Integer 发稿速度(1:一小时内 2:二小时内 12:半天 24:当天 48:隔天 49:2天以上 )
newsresource Integer 新闻源(1:百度新闻源 0:非百度新闻源)
weekendpublish Integer 周末可发(1:可发 0:不可发)
portalmedia String 综合门户
industry Integer 特别行业(1:p2p 2:微商 3:留学 4:健康 5:加盟 6:白名单来源)
searchcollint Integer 收录情况(0:不包收录 1:包收录)
pcweight Integer 电脑权重(0:无权重 1:权重1 2:权重2……)
wapweight Integer 移动权重(0:无权重 1:权重1 2:权重2……)
remark String 备注
recommend Integer 推荐(1:是 0:否)
flag Integer 状态(1:上架 0:下架)
deleted Integer 删除(1:正常 0:已删除)
软文发布资源

注:请定时更新, 确保资源同步。资源状态可根据资源状态接口查询。

接口地址:https://haixunpr.org/api/getChinese

请求方式:POST

请求参数:

参数名 必填 描述
token Y 海讯社提供token
timestamp Y 时间戳,时间戳为10位
signature Y 签名,请参考签名生成规则
page Y 页数
limit Y 每页条数

返回参数(json格式):

参数名 描述
code 100成功 101失败
message 描述信息
count 总数量
data 返回数据(参考data字段说明)

data字段说明:

参数名 类型 描述
sourceid String 资源id
type Integer 类别 1:地方媒体 3:中文汇总
classify String 媒体分类
region String 区域
name String 媒体名称
costprice Double 价格
entrancelink String 入口链接
caseurl String 案例地址
searchcoll String 搜索收录
linktype Integer 链接类型 2:可带网址 0:不可带网址
publishtime Integer 发稿速度 1:一小时内 2:二小时内 12:半天 24:当天 48:隔天 49:2天以上
newsresource Integer 新闻源 1:百度新闻源 0:非百度新闻源
weekendpublish Integer 周末可发 1:可发 0:不可发
portalmedia String 综合门户
industry Integer 特别行业 1:p2p 2:微商 3:留学 4:健康 5:加盟 6:白名单来源
searchcollint Integer 收录情况 0.不包收录 1.包收录
pcweight Integer 电脑权重 0:无权重 1:权重1 2:权重2……
wapweight Integer 移动权重 0:无权重 1:权重1 2:权重2……
remark String 备注
recommend Integer 推荐 1:是 0:否
flag Integer 状态 1:上架 0:下架
deleted Integer 删除 1:正常 0:已删除
自媒体资源

注:请定时更新, 确保资源同步。资源状态可根据资源状态接口查询。

接口地址:https://haixunpr.org/api/getSelf

请求方式:POST

请求参数:

参数名 必填 描述
token Y 海讯社提供token
timestamp Y 时间戳,时间戳为10位
signature Y 签名,请参考签名生成规则
page Y 页数
limit Y 每页条数

返回参数(json格式):

参数名 描述
code 100成功 101失败
message 描述信息
count 总数量
data 返回数据(参考data字段说明)

data字段说明:

参数名 类型 描述
sourceid String 资源id
type Integer 类别 2:自媒体
classify String 媒体分类
region String 区域
name String 媒体名称
costprice Double 价格
entrancelink String 入口链接
caseurl String 案例地址
authint Integer 账号认证 1:已认证 0:未认证
industrystr String 行业分类
fans Integer 粉丝数 1(0-1000) 5(1001-5000) 10(5001-1万) 50(1万-5万) 100(5万-10万) 1000(10万-100万) 1001(100万以上)
readnumber Integer 阅读数 1(0-1000) 5(1001-5000) 10(5001-1万) 50(1万-5万) 100(5万-10万) 101(10万)
weekendpublish Integer 周末可发 1:可发 0:不可发
isvideo Integer 可发视频 1:可发 0:不可发
remark String 备注
logo String 媒体Logo
firstcheck String 一手认证
recommend Integer 推荐 1:是 0:否
flag Integer 状态 1:上架 0:下架
deleted Integer 删除 1:正常 0:已删除
资源状态查询

注:更新资源后,可用此接口定时查询资源状态,确保资源状态正确。

接口地址:https://haixunpr.org/api/resourceState

请求方式:POST

请求参数:

参数名 必填 描述
token Y 海讯社提供token
timestamp Y 时间戳,时间戳为10位
signature Y 签名,请参考签名生成规则
sourceid Y 海迅资源id

返回参数(json格式):

参数名 描述
code 100成功 101失败(未查询到资源,可作下架或删除处理)
message 描述信息
flag 状态 1:上架 0:下架
deleted 删除 1:正常 0:已删除
创建订单

接口地址:https://haixunpr.org/api/createOrder

请求方式:POST

请求参数:

参数名 必填 描述
token Y 海讯社提供token
timestamp Y 时间戳,时间戳为10位
signature Y 签名,请参考签名生成规则
title Y 标题(需单独使用urlencode)
content Y 内容(传预览地址即可)
sourceid Y 资源id

返回参数(json格式):

参数名 描述
code 100成功 101失败
message 描述信息
orderQuery 订单号(创建成功后的订单,返回的订单号请存入您系统的订单,用于后续查询和更新)
查询订单

接口地址:https://haixunpr.org/api/queryOrder

请求方式:POST

请求参数:

参数名 必填 描述
token Y 海讯社提供token
timestamp Y 时间戳,时间戳为10位
signature Y 签名,请参考签名生成规则
orderQuery Y 订单号(海讯社创建订单返回订单号)

返回参数(json格式):

参数名 描述
code 100成功 101失败
message 描述信息
status 订单状态 0:派单中 1:发布中 2:媒体拒稿 21:退回修改 3:发布成功,等待用户确认(发布24小时后自动审核通过) 4:用户反馈意见处理中 5:用户确认通过
postUrl 订单发布成功后的文章地址(当订单状态为3或5时,返回该值)
更新订单

接口地址:https://haixunpr.org/api/updateOrder

请求方式:POST

请求参数:

参数名 必填 描述
token Y 海讯社提供token
timestamp Y 时间戳,时间戳为10位
signature Y 签名,请参考签名生成规则
orderQuery Y 订单号(海讯社创建订单返回订单号)
status Y 类型:Integer。订单状态为3(等待用户确认)时接受订单更新,其余状态不接受。只接受这两个值4(用户反馈修改意见)或5(用户确认通过)
remark N 备注(需单独使用urlencode,当status填写为4时,最好填写该值,以便媒体便于纠错)

返回参数(json格式):

参数名 描述
code 100成功 101失败
message 描述信息