• 目标用户:使用由自身开发人员所开发的当当店铺管理系统的所有当当网商家用户。(备注:此处所描述的当当店铺管理系统为需要调用当当网开放API的软件系统,使用第三方软件服务商产品的商家用户不在目标用户范围内,需要联系第三方软件服务商与当当网开放平台进行对接)

    切换政策:当当网的API调用方式将在2013年12月31日进行调整,所有的API需要通过授权才能正常调用。自2014年1月1日起,当当网将停止对旧版API的服务支撑。

    问题讨论:QQ群-280629265,当当网商家接入服务群。(备注:需要商家用户的技术人员加入讨论群,加入讨论群后请在群备注上写名“店铺ID+店铺名称”,会由当当运营人员进行问题解答)

  • 2.1身份判断(判断是否需要接入)

    首先商家要清楚自身是否需要接入当当API接口。

    ⊙ 如果商家在当当所有的运营操作都直接使用当当商家后台(shopadm.dangdang.com或shopadm4.dangdang.com)的,不需要接入此接口

    ⊙ 如果商家购买了其它ISV(软件服务商)的系统支持自身运营的,需要通知该ISV接入当当开放平台接口。(备注:ISV接入当当网开放平台接口的操作流程,请参照服务商应用接入流程

    ⊙ 如果商家自身有软件研发能力或使用自身开发的系统的,需要接入当当开放平台接口。(备注:请继续参照本文档2.2章节,进行接口判断)

    2.2接口判断(判断现使用的是否为开放平台新接口)

    如果您确定满足本文档2.1章节中的第三点身份描述,确实有接入当当网开放平台新接口的需求,并属于已经接入当当老商家接口的用户,需要做新老接口切换的工作。

    如果您现在对接的接口是以api.dangdang.com为域名的,说明您接入的是当当老接口,需要做迁移改造。请按照本文档2.3章节的流程完成注册和改造工作。

    2.3注册登录(需要做接口切换工作的商家用户)

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

    通过当当网的商家账号,登录系统。

    登录成功后,点击首页的“加入开放平台”,进入设置个人信息页面,填写联系人姓名、联系人手机、联系人邮箱、所在地和详细地址信息。

    2.4创建应用

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

    按照应用对应的信息,填写所属分类、应用名称和应用简介信息。点击“提交”按钮,则应用创建成功。(备注:建议应用分类选择订单管理-ERP,后续我们会根据应用类别设置不同的接口调用权限)

    2.5授权设置

    在获取证书页面,输入“授权店铺”的店铺编号。(备注:店铺编号必须为当前登录商家账号的下属店铺,否则无法完成授权)

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

    访问授权页面,登录后完成对应用的授权操作,并获取授权码。(备注:如果在授权店铺中添加多个店铺编号,需要分别访问授权页面进行授权)

     

    2.6调用API

    授权成功后,凭借所获取的授权码,就可以按照当当开放平台定义的调用规则调用相应的API了。(备注:欲查看接口调用的详细说明,请参照http://open.dangdang.com/index.php?c=documentCenter&f=show&page_id=89

     

     


  • 旧接口 新接口

    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