alipay.marketing.tool.fengdie.space.create(创建云凤蝶空间) 在线调试(沙箱环境)

根据空间名称创建云凤蝶空间

公共参数

请求地址

环境HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do

公共请求参数

参数 类型 是否必填最大长度描述示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 alipay.marketing.tool.fengdie.space.create
format String 40 仅支持JSON JSON
charset String 10 请求使用的编码格式,如utf-8,gbk,gb2312等 utf-8
sign_type String 10 商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2 RSA2
sign String 344 商户请求参数的签名串,详见签名 详见示例
timestamp String 19 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" 2014-07-24 03:07:50
version String 3 调用的接口版本,固定为:1.0 1.0
app_auth_token String 40 详见应用授权概述
biz_content String 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

请求参数

参数 类型 是否必填 最大长度 描述 示例值
title String 必选 100 欲创建的空间名称。应注意云凤蝶中每个空间有唯一的空间名称,尽量使用自己平台的前缀。另外空间名称只允许是中英文字符数字下划线组成的字符串。 测试空间

响应参数

参数 类型 是否必填 最大长度 描述 示例值
data FengdieSpaceDetailModel 必填 创建成功后返回空间的基本信息,包含空间 ID、标题、创建时间与可用域名列表
space_id String 必填 50 空间 ID SP1477294880210000
title String 必填 100 空间标题 测试空间名
gmt_create String 必填 25 空间创建时间 2017-10-10 10:10:10
domains FengdieSpaceDomains[] 必填 1000 空间可用域名列表,云凤蝶站点发布后链接可用采用的域名
domain String 必填 100 发布的域名,在云凤蝶上创建的站点发布时采用的 url 域名 https://fengdie.alipay-eco.com
status String 必填 20 当前域名状态,是否可用,值为 OPEN 或 DISCARDED OPEN
is_default String 必填 10 是否是当前云凤蝶空间的默认发布域名,Y 则表示该空间下的站点默认以此域名生成站点url Y

请求示例

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayMarketingToolFengdieSpaceCreateRequest request = new AlipayMarketingToolFengdieSpaceCreateRequest();
request.setBizContent("{" +
"\"title\":\"测试空间\"" +
"  }");
AlipayMarketingToolFengdieSpaceCreateResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

{
    "alipay_marketing_tool_fengdie_space_create_response": {
        "code": "10000",
        "msg": "Success",
        "data": {
            "space_id": "SP1477294880210000",
            "title": "测试空间名",
            "gmt_create": "2017-10-10 10:10:10",
            "domains": [
                {
                    "domain": "https://fengdie.alipay-eco.com",
                    "status": "OPEN",
                    "is_default": "Y"
                }
            ]
        }
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

异常示例

{
    "alipay_marketing_tool_fengdie_space_create_response": {
        "code": "20000",
        "msg": "Service Currently Unavailable",
        "sub_code": "isp.unknow-error",
        "sub_msg": "系统繁忙"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

业务错误码

公共错误码

错误码错误描述解决方案
SPACE_NAME_HAS_EXIST 空间名已存在 更改空间名称,可考虑增加专用前缀
SYSTEM_ERROR 系统繁忙 重新调用,或者间隔一段时间后再次调用
INVOKE_PERMISSION_ERROR 调用权限错误 检查调用账号是否为云凤蝶企业VIP用户
INVALID_PARAMETER 参数有误 请传必传字段 title,或检查参数是否有不合法符号
BIZ_ERROR 业务异常 重新调用,或者间隔一段时间后再次调用
onlineServer