• 1.注册登录

    使用商家后台帐号,登录开发者中心(open.dangdang.com),点击“登录”,进入登录页面。

    如果已有当当网账号,可以直接登录,如果尚未注册当当网账号,需要先注册成为当当网用户。

    登录成功后,点击首页的“加入开放平台”,进入设置个人信息页面,填写联系人姓名、联系人手机、公司名称等信息。(备注:服务类型保存后将无法修改,如果您是应用开发者,请选择“在线应用”,如果您是模板设计师,请选择“店铺模板”)

    2.创建应用

    在应用管理页面,点击“创建应用”,进入应用信息填写页面。

    按照应用对应的信息,填写所属分类、应用名称、应用图标和应用简介信息。点击“提交”按钮,则应用创建成功。

    3.授权设置

    在获取证书页面,选择应用的授权方式。(备注:包括persistentToken、token、code和自定义四种方式,授权方式说明请访http://open.dangdang.com/index.php?c=documentCenter&f=show&page_id=88进行查看)

    在获取证书页面,输入应用的“回调地址”信息。(备注:根据应用属性输入相应的回调地址信息,也可以选择默认回调地址,授权后会在当前页面获取授权码)

    商家拿到页面授权码后应在ISV指导下把授权码填写回ISV软件(一般的ERP软件多采取回填授权码的方式)中,即可完成授权。(备注:使用persistentToken此授权方式获得的授权码的有效期与商家在当当平台上购买此软件的有效期一致,推荐使用此种方式授权)

    4.调试应用

    在获取证书页面,输入“试用店铺”的店铺编号。(备注:最多可以输入两个店铺,用英文逗号隔开,填写后的店铺可以直接使用OAuth的方式获取授权码,不需要购买)

    在获取证书页面,点击“复制授权地址”,并将该地址发送给商家。

    商家访问授权页面,登录后完成对应用的授权操作,并获取授权码。(备注:只有“试用店铺”中填写的商家,才能在试用阶段完成授权)

    商家将该授权码反馈给服务商之后,凭借此授权码,服务商的应用就可以按照请求规则调用当当对外开放的API,从而进行应用测试了。

    5.网上签约

    顺利完成应用调试,并想申请在当当卖家服务市场上架售卖应用的服务商,需要进行网上签约。(备注:已经签署纸质协议的服务商,可以跳过此步骤)

    点击右上方的“设置个人信息”,进入基本资料页面。

    在开发者基本资料页面点击“下一步”,进入开发者详细资料页面。

    在开发者详细资料页面,填写公司基本信息(名称、电话、开户行、开户行账号、账户名、总经理、总经理电话、总经理手机、邮箱、邮寄地址)、产品负责人资料(项目跟进人、技术负责人、客服负责人、市场负责人和售后负责人)、其他资料(企业文化、当前用户数和成功案例)等信息,点击“下一步”,进入开发者网签协议页面。

    在开发者网签协议页面,填写乙方公司名称、联系地址、联系人、联系电话和电子邮件信息,并上传营业执照、组织机构代码证、税务登记证和开户许可证等证件的照片,点击“提交”按钮,则完成协议的审核申请操作,由当当网的相关工作人员继续对协议进行审核。(备注:审核通过后,服务商需要“下载”协议副本,盖章后通过线下邮寄方式寄给当当网)

    6.设

    点击导航菜单中的“定价管理”,进入价格编辑页面。

    在应用列表中,点击某个应用对应的“设置定价”按钮,可以对该应用的价格进行编辑。其中,应用价格按照有效期可以设置四个维度,分别为1个月、1季度、半年和1年,每类有效期的价格都必须是大于等于0的数字,且不能超过两位小数。同时,还可以设置应用是否支持试用,试用的有效期包含7天和30天两种。

    7.发布应用

    点击导航菜单中的“应用发布”,进入应用详细信息编辑页面。

    在应用列表中,点击某个应用对应的“填写应用信息”按钮,可以对该应用的应用详情、使用教程、成功案例、客服电话、客服邮箱、客服QQ、服务商公告、测试地址(下载链接)等详细信息进行编辑。填写后点击“提交发布”按钮,则该应用被发布到当当网开放平台的运营后台进行审核。(备注:应用审核通过前,可以继续修改应用的分类、名称、图标、简介、价格和应用详细信息,应用通过审核后,则无法修改相应信息)

    8.审核上架(由当当运营人员操作)

    当当网的运营人员进入开放平台后台,确认应用的详细信息准确无误后,就可以完成对应用的审核上架操作,应用上架后就可以在当当的卖家服务市场(fuwu.dangdang.com)进行售卖。

    9.通知商家

    对于通过旧版API调用方式为当当商家提供服务的软件服务商来说,在应用审核通过并上架后,需要通知已有的商家客户到当当卖家服务市场(fuwu.dangdang.com)购买应用并完成授权操作,并告知客户在切换后如何继续使用该应用。

    在线订购类应用的商家购买流程请参照《商家购买应用说明-在线购买应用》


  • 1.注册登录

    登录开发者中心(open.dangdang.com),点击“登录”,进入登录页面。

    如果已有当当网账号,可以直接登录,如果尚未注册当当网账号,需要先注册成为当当网用户。

    登录成功后,点击首页的“加入开放平台”,进入设置个人信息页面,填写联系人姓名、联系人手机、公司名称等信息。(备注:服务类型保存后将无法修改,如果您是应用开发者,请选择“在线应用”,如果您是模板设计师,请选择“店铺模板”) 

    2.创建应用

    在应用管理页面,点击“创建应用”,进入应用信息填写页面。


    按照应用对应的信息,填写所属分类、应用名称、应用图标和应用简介信息。点击“提交”按钮,则应用创建成功。


    3.授权设置

    在获取证书页面,选择应用的授权方式。(备注:包括persistentToken、token、code和自定义四种方式,授权方式说明请访问http://open.dangdang.com/index.php?c=documentCenter&f=show&page_id=88进行查看) 


    在获取证书页面,输入应用的“回调地址”信息。(备注:根据应用属性输入相应的回调地址信息,也可以选择默认回调地址,授权后会在当前页面获取授权码)

    商家拿到页面授权码后应在ISV指导下把授权码填写回ISV软件(一般的ERP软件多采取回填授权码的方式)中,即可完成授权。(备注:使用persistentToken授权方式获得的授权码,其有效期与商家在当当平台上购买此软件的有效期一致,推荐使用此种方式授权)

    4.设置价格(不会在前台显示)

    点击导航菜单中的“定价管理”,进入价格编辑页面。


    在应用列表中,点击某个应用对应的“设置定价”按钮,可以对该应用的价格进行编辑。其中,应用价格按照有效期可以设置四个维度,分别为1个月、1季度、半年和1年,每类有效期的价格都必须是大于等于0的数字,且不能超过两位小数。同时,还可以设置应用是否支持试用,试用的有效期包含7天和30天两种。


    应用价格和试用都不会作为功能选项在前台显示,ISV可以根据自身应用情况,输入一个参考价格即可。

    5.发布应用

    点击导航菜单中的“应用发布”,进入应用详细信息编辑页面。


    在应用列表中,点击某个应用对应的“填写应用信息”按钮,可以对该应用的应用详情、使用教程、成功案例、客服电话、客服邮箱、客服QQ、服务商公告、测试地址(下载链接)等详细信息进行编辑。填写后点击“提交发布”按钮,则该应用被发布到当当网开放平台的运营后台进行审核。(备注:应用审核通过前,可以继续修改应用的分类、名称、图标、简介、价格和应用详细信息,应用通过审核后,则无法修改相应信息)


    6.审核上架(由当当运营人员操作)

    当当网的运营人员进入开放平台后台,确认应用的详细信息准确无误后,就可以完成对应用的审核上架操作,应用上架后就可以在当当的卖家服务市场(fuwu.dangdang.com)进行售卖。 

    7.处理申请

    商家提交申请后,在开发者中心的“价格面议”菜单中会显示相应的申请信息,点击“查看详情”按钮,可以查看商家提交的具体内容。线下完成交易后,点击“确认交易”按钮,则生成相应的订购关系,此时商家就可以在商家后台(shopadm.dangdang.com或shopadm4.dangdang.com)登录授权系统对应用进行授权了。(Token的有效期为一年) 

    8.开始服务

    根据ISV自身提供应用的类型,需要告知其客户(购买应用的商家)授权后如何使用该应用。

    (1)回调地址填写内容为“默认回调地址”

    当应用的回调地址为http://oauth.dangdang.com/default.jsp(默认回调地址)时,商家授权之后会在当前页面获取Token。


    (2)回调地址填写内容为应用链接地址

    当应用的回调地址为ISV填写的应用链接时,商家授权之后会在url中携带Token参数直接跳转到相应页面。


    价格面议类应用的商家购买流程请参照《商家购买应用说明-价格面议申请》



  • 旧接口 新接口

    http://api.dangdang.com/v2/addItems.php

    dangdang.item.add

    http://api.dangdang.com/v2/updateItemsDetail.php

    dangdang.item.detail.update

    http://api.dangdang.com/v2/deleteItems.php

    dangdang.items.delete

    http://api.dangdang.com/v2/searchItems.php

    dangdang.items.list.get

    http://api.dangdang.com/v2/getItemDetail.php

    dangdang.item.get

    http://api.dangdang.com/v2/updateItemStock.php

    dangdang.item.stock.update

    http://api.dangdang.com/v2/updateItemsInfo.php

    dangdang.item.price.update

    http://api.dangdang.com/v2/updateMultiItemsStock.php

    dangdang.items.stock.update

    http://api.dangdang.com/v2/updateMultiItemsInfo.php

    dangdang.items.price.update

    http://api.dangdang.com/v2/getItemID.php

    dangdang.item.itemid.get

    http://api.dangdang.com/v2/getOuterItemID.php

    dangdang.item.customid.get

    http://api.dangdang.com/v2/setItemsBestPartners.php

    dangdang.items.bestpartners.set

    http://api.dangdang.com/v2/getBestPartners.php

    dangdang.item.bestpartners.get

    http://api.dangdang.com/v2/setItemsPublicColumns.php

    dangdang.items.publiccolumns.set

    http://api.dangdang.com/v2/getItemPublicColumns.php

    dangdang.item.publiccolumns.get

    http://api.dangdang.com/v2/updateMultiItemsStatus.php

    dangdang.items.status.update

    http://api.dangdang.com/v2/updateMultiItemsExtendedAttributes.php

    dangdang.items.spec.update

    http://api.dangdang.com/v2/updateMultiItemsExtendedDescriptions.php

    dangdang.items.extradesctab.update

    http://api.dangdang.com/v2/updateMultiItemsCODInfo.php

    dangdang.items.codinfo.update

    http://api.dangdang.com/v2/updateMultiItemsPostage.php

    dangdang.items.postage.update

    http://api.dangdang.com/v2/searchOrders.php

    dangdang.orders.list.get

    http://api.dangdang.com/v2/getOrderDetail.php

    dangdang.order.details.get

    http://api.dangdang.com/v2/cancelOrder.php

    dangdang.order.cancel

    http://api.dangdang.com/v2/getOrderID.php

    dangdang.order.orderid.get

    http://api.dangdang.com/v2/getOuterOrderID.php

    dangdang.order.customid.get

    http://api.dangdang.com/v2/sendGoods.php

    dangdang.order.goods.send

    http://api.dangdang.com/v2/getMultiOrderCourierReceiptDetails.php

    dangdang.order.receipt.details.get

    http://api.dangdang.com/v2/returnGoods.php

    dangdang.order.return

    http://api.dangdang.com/v2/exchangeGoods.php

    dangdang.order.goods.exchange

    http://api.dangdang.com/v2/searchReturnExchangeOrders.php

    dangdang.orders.exchange.return.list.get

    http://api.dangdang.com/v2/updateReturnExchangeOrdersApprStatus.php

    dangdang.orders.exchange.return.apply.approve

    http://api.dangdang.com/v2/setItemsPics.php

    dangdang.items.pics.set

    http://api.dangdang.com/v2/getItemsErrorPics.php

    dangdang.items.errorpics.get

    http://api.dangdang.com/v2/searchQA.php

    dangdang.qa.list.get

    http://api.dangdang.com/v2/answerQA.php

    dangdang.qa.answer

    http://api.dangdang.com/v2/getDDCategory.php

    dangdang.shop.ddcategory.get

    http://api.dangdang.com/v2/getSpecialAttributeClass.php

    dangdang.shop.ddsaleprops.get

    http://api.dangdang.com/v2/getDDBrand.php

    dangdang.shop.ddbrand.get

    http://api.dangdang.com/v2/getShopCategory.php

    dangdang.shop.category.get

    http://api.dangdang.com/v2/getExtendedAttributeClass.php

    dangdang.shop.spec.get

    http://api.dangdang.com/v2/getDDCategoryNew.php

    dangdang.shop.ddcategorynew.get

    http://shopapi.idc3/coupon_list.php

    dangdang.shop.coupons.list

    http://shopapi.idc3/coupon_bind.php

    dangdang.shop.coupon.send

    http://api.dangdang.com/v2/searchPromotions.php

    dangdang.promotions.list.get

    http://api.dangdang.com/v2/getPromotion.php

    dangdang.promotion.get

    http://api.dangdang.com/v2/updateItemType.php

    dangdang.promotion.itemtype.update

    http://api.dangdang.com/v2/updateMultiPromosEndDate.php

    dangdang.promotions.enddate.update

    http://api.dangdang.com/v2/addMultiOffPricePromos.php

    dangdang.promotions.offprice.add

    http://api.dangdang.com/v2/updateMultiOffPricePromos.php

    dangdang.promotions.offprice.update

    http://api.dangdang.com/v2/updateMultiOrdersDistriStatus.php

    dangdang.orders.distristatus.update