無限極項目-共享10客戶化開發(fā)d-app interface

文檔控 安全機 AppCode& 獲取 刷新 使用 數(shù)據(jù)簽 API接口細 所有接口列 數(shù)據(jù)交互格 參數(shù)格 返回格 關(guān)于日 接口明 Get Get Distributor Online POSRegistration Update POSDistributorUpdate GetProduct GetProduct Order POSOrderCreate POSOrderUpdate GetOrder GetOrder Order OrderPayment Get Get Lock Release BatchOrder Dealer Account Team Team DownLine POS2.0會給接口調(diào)用方提供一個appCode和一個appSecret。用于識別、獲appCode和appSecret是一對“帳號”和“”。由POS生成并添加到系統(tǒng)中，然后提供給接口調(diào)用者使用。POS系統(tǒng)管理員可以管理這些code和secret。appCode過期后，只能人工appCode和appSecret。appCode可以添加ip過濾白，由接口調(diào)用者申請，POS手動添加。此接口通過200狀態(tài)碼返回正確結(jié)果，通過4XX返回錯誤的結(jié)果。{{}Http0UnhandledRequiredHeaderisget/refreshAppTokenisInvalidorrefreshIpisanyAppCodeisget/refreshAppCodeisget/refreshAppSecretisnotgetFormRequestData√√DataDataAccesstimestamp,whenthetokenwillReturnedJSON{{}Form-RequestData√currenttokenyou√DataDataAccessToken,thevaluepassedNewtimestamp,whenthetokenwillReturnedJSON{{}token:e8c2dff3-7363-4111-8858-token:e8c2dff3-7363-4111-8858-publicStringgetSign(Stringuri,StringappSecret,longtimestamp,List<ComparableNameValuePair>queryParameters,StringpostBody)StringBuildercontent=newStringBuilder();if(postBody!=null)//DigestUtilscomefromcommons-codec-return}uriurl中/api以 名，計算方法（上述java）需要用到系統(tǒng)（UDDS）時間戳。流程如下：timestamp，sign，token設(shè)置到httpAPIAPI序號接口名稱回調(diào)URL(含版本號1Get2Get34Online5POS√6Update7POSUpdate√8Get9GetProductOrderPOSOrder√POSOrder√GetOrderGetOrderOrderOrderPaymentGetGetVerifyLockReleaseBatchDealerAccountTeamTeamDownLineMethodContent。Method說明了調(diào)用接口所需要的HttpMethod。Content說明了提交數(shù)據(jù)時所需的格式。 GET方式請求，QueryString傳參。GET…/api/v1/xx?a=1&b=2 POST…/api/v1/yyy章節(jié)2中的所有接口均遵循以上規(guī)則。在業(yè)務(wù)接互過程中，數(shù)據(jù)格式與過程有所不同Datastatusofthisthevaluethathaserror(maybe"success",orerrorsuccess:0,faield:10000,10001JSONExample{{}}JSONExample{{}}注意：data有可能是一個對象({…})，也有可能是數(shù)組([…])，請參照具體的接口說明。code不為0（發(fā)生錯誤）時，data沒有意義。接口通過HttpCode200status.code來表達正確還是錯誤。通過HttpCode4xx返回安全錯誤。Http0UnhandledRequiredHeaderisAcessRequiredFieldisParameterAppTokenisInvalidorAccessIpisAccessSignisAccessErrorAboutErrorAboutErrorAboutErrorAboutErrorAbout GetRetrievedistributors’listbymarket,registrationdateandupdateRequestDataSample√registrationdate2016-01-registrationdate2016-01-member’supdatedate2016-01-member’supdatedate2016-01-第NDataDataNotEmptySample5√ 激 無 暫 終 5√ 個 公√ParentdistributorMemberfullnamein(+lastMembernameinMemberlastnameinMembernameinMemberlastnamein√MemberID1Gender,Male–M,Female–MLanguage,eg:5MarketCode,eg:86,852,ReturnedJSON{{"data":{"status":"market":"cn","sponsorId":"10101", NameEng":"Jim","lastNameEng":"Green","memberType":"IDV","birthday":"2000-12-"gender":"language":"en_GB","mobileAreaCode":86,"mobileNumber": "Address": }"status":"value":"code":0,}}GetAbletogetadistributor’sinformationbydistributorRequestDataSample√DistributorDataDataNotorSample5√ 激 無 暫 終 自動終 √√DistributorParentDistributorMemberfullnameinEnglish(lastMembernameinMemberlastnameinMembernameinMemberlastnamein5√ 個 公5 PPTalIDBirthday(yyyy-MM-1990-12-1Gender,Male-M,Female-CompanyCompanyID5alAddress-alAddress-ContactAddress-DetailalAddress-DetailalAddress-ZipContactAddress-ContactAddress-ContactAddress-DetailContactAddress-DetailContactAddress-Zip5AreaCode,eg:86,852, 5AreaCode,eg:86,852,BankBankBank panyIdnumberofbankReturned{{{"market":"hk","sponsorId":null,"fullName":"JimGreen", Name":"Jim","lastName":"memberType":"IDV","idNumber":null,"gender":"M","companyNames":null,"language":"en_GB","nationality":null,"perState":null,"perProvince":null,"perCity":null,"perRegion":null,"perAddress":null,"perZipCode":null,"curState":null,"curProvince":null,"curCity":null,"curRegion":null,"cyrAddress":null,"phoneNumber":null,"companyPhoneNumber":null,"mobileAreaCode":86,"phoneNumber":null,"companyPhoneNumber":null,"mobileAreaCode":86,"mobileNumber": Address":" "bankNumber":null,"bankCode":null,"bankAccount":null,"bankAccountIdNumber":null,"bonusPaymentMethod":"BANK""status":"value":"code":0,}}APItoverifydistributorbyusernameandRequest√Distributor’s√√DataData2Result,1:success-1Returned{{"data":"result":1,"status":"value":"code":0,}}OnlineAPItoregistrationasnewRequestDataSample√Unique√ParentDistributor√Membernamein√Memberlastnamein√Membernamein√Memberlastnamein5√DIS分銷VIPSUP5√ 個 公5√ PPT√alID√Birthday(yyyy-MM-1990-12-1√Male-M,Female-CompanyCompanyIDCompany5ELE小學(xué)JUNH初中SEC中專JUNC大專UNI學(xué)MASDOCOTRS5MALA馬來 BUMI土著OTRS其他COMP5alAddress-alAddress-alAddress-DetailalAddress-alAddress-Zip√ContactAddress-√ContactAddress-√ContactAddress-DetailContactAddress-DetailContactAddress-Zip5AreaCode,eg:86,852,√ 5AreaCode,eg:86,852,√BankBankBank panyIdnumberthebankSpouseNameSpouseName5SpouseIDSpouseSpouse1990-12-BeneficiaryNameBeneficiaryName5BeneficiaryIDBeneficiaryBeneficiary1990-12-RelationshipwithDataDataNotEmptyorSample√Unique√Distributor2-Returned{{{ "distributorNumber":"result":1,"status":"value":"code":0,}}POSRegistrationNewusercreatedinPOSthennotifydistributorappbyusingcallbackAPIthatprovidedbyInfiniteRequestDataSample√√Distributor1√A-AddU-UpdateD-DataReturned{{"status":"value":"code":0,}}UpdateAPItoupdatememberinformation,emptyvaluewillbenotRequestDataSampleUnique√DistributorParentDistributor√Membernamein√Memberlastnamein√Membernamein√Memberlastnamein5√0:distributor,1:5√0: 50:alID,alIDBirthday(yyyy-mm-1990-12-1Gender,Male-M,Female-CompanyCompanyIDzh- ,555alAddress-alAddress-alAddress-DetailalAddress-DetailalAddress-ZipContactAddress-ContactAddress-ContactAddress-DetailContactAddress-DetailContactAddress-Zip5AreaCode,eg:86,852, 5AreaCode,eg:86,852,BankBankBank panyIdnumberofbankSpouseNameSpouseNameSpouseSpouseBeneficiaryNameBeneficiaryName5BeneficiaryIDBeneficiaryBeneficiaryRelationshipwithDataReturned{{"status":"value":"code":0,}}POSupdatedistributorwillreflecttodistributorappbyusingcallbackAPIthatprovidedbyInfinituRequestDataSample√√DistributorDataReturned{{"status":"value":"code":0,}}GetProductAPItocollectProductCategoriesRequestDataSample√√sale√Sale√companyDataDataNotNullOrSampleParent√Category√Category1LeafFlag:Flag‘Y’canbeassignedReturned{{"data":{"parentCateCode":"cateCode":"0132","categoryName":"CategoryName1","categories":[{"parentCateCode":"cateCode":"0131","categoryName":"CategoryName2"{"parentCateCode":"cateCode":"0131","categoryName":"CategoryName2"}]{"parentCateCode":"cateCode":"categoryName":"categoryName":"CategoryName}"status":"value":"code":0,}}GetProductAPItocollectProductsinformation,supportRequestDataSample√√sale√Sale√companyFilterbycategoryFilterbyproductCode,abletofiltermultipleproductscodebycommaDataDataNotnullorSample√Category√Product√Product√√√Numberofproduct1Y/N,經(jīng)銷商App及發(fā)布狀態(tài)均為的時候商品才可以在APP經(jīng)銷商App1Y/N,經(jīng)銷商App及發(fā)布狀態(tài)均為的時候商品才可以在APP1√BackorderallowedorPricesYYProductY DIS經(jīng)銷商價格STU員工價格3Returned{{"data":{"cateCode":"productCode":"15169","productName":"ProductName1","pv":1000,"inventory":12,"orderedQty":"prices":[{"price":"type":{"price":"type":}]{"cateCode":"productCode":"15167","productName":"ProductName2","pv":1000,"inventory":12,"orderedQty":"prices":[{"type":0{"price":"type":}]}"status":"value":"code":0,}}OrderAPIforOrderRequestData√Uniquesale√Sale√company√√Distributor7√Order√DeliveryAddress-√DeliveryAddress-√DeliveryAddress-√DeliveryAddress-√DeliveryAddress-Zip√√Receiver5ReceiverContactArea√BillingAddress-√BillingAddress-√BillingAddress-√BillingAddress-√BillingAddress-Zip5√ 自 3√ShipFee,POSeithercalculateitselfshipemptyvalueorusethefrom√TotalAmountfordefaultisSales Web Auto5√SalesPoint Birthday Distributor Distributor Store WeChat QiClub WebPurchaseris1√5Y待付 5(Fore-Shop]√Orderedproductsproducts√Product√√√√UsedCoupon,oneachCouponsCouponsCouponDataDataNotnullSample√Order√1:success,-Returned{{{"result":1"status":"value":"code":0,}POSOrderCreateNewordercreatedinPOSthennotifydistributorRequestDataSample√√Order√DataReturned{{"data":"status":"value":"code":0,}}POSOrderUpdateOrderupdatedinPOSthennotifydistributorappbyusingcallbackAPIthatprovidedbyInfiniteRequestDataSample√√Order√DistributorDataReturned{{"data":"status":"value":"code":0,}}GetOrderAPItocollectordersinRequestDatadSamplesale√Sale√company√FilterbyDistributorFilterbyOrderCreateFilterbyOrderCreateFilterbyOrderUpdateFilterbyOrderUpdate5FilterbyOrder 5Filterby 每頁記錄條第NDataDataor√Market√ √Order5√Order Status√Distributor√OrderCreateDate3√√Total√ShipOrderedProductProducttyofproducthastyofproducthastyofproductUnitSummaryofthesaleUnitReturned{{"data":{"orderNumber":"orderStatus": Status":"distributorNumber":"createTime":"2015-10-13 "currency":"amount":"postage":"products":{"productCode":"1234","productName":"ProductName2","ty":1,"price":"pv":}]}"status":"value":"code":0,}}GetOrderAPItogetorderdetailinformationbyorderRequestDatadSample√√Sales√OrderDataDataNotorSample√Order5√Order Status√Distributor√OrderCreated√DeliveryAddress√DeliveryAddress-√DeliveryAddressDetail√DeliveryAddressDetail√DeliveryAddress-√BillingAddress-√BillingAddress-√BillingAddressDetails√BillingAddressDetail√BillingAddress-eReceiver5Ship3√√Totalship√ShipCoupon]OrderedProductProducttyofproducttyofproducttyofproductUnitSummaryofthesaleUnit]UsedCouponsCouponsCouponReturned{{"data":"orderNumber":"orderStatus":"distributorNumber":"91234567","state":null,"city":null,"region":null,"address":null,"zipCode":null,"phone":null,"mailing":"1","amount":50, Fee":0,"products":[{"productCode":"productName":"productName":"ProductName2", ty":1,"price":"pv":"coupons":{"couponCode":}]}]"status":"value":"code":0,}}APItocancelorderbeforepaymentRequestDataSamplesale√√company√√OrderDataDataSample√Order21:success,-Returned{{"data":{"orderNumber":"result":1,}"status":"value":"code":0,}}APItoupdateorderwhenpaymentRequestDataSample√√OrderAuthorizationcodeifthepaymentAuthorizationdateifthepaymentLast4digitofthe√Paymentresult,1:-1:DataDataSample√Order√Paymentresult,1:-1:{"data":{"data":{"orderNumber":"result":1,}"status":"value":"code":0,}}GetAPItocollectavailabledeliveryaddressfromRequestDatasale√Sale√company√√addresstranslation, ,en_GBDataDatacountryCountryStateStatecitycityReturned{{"data":{"country":"中國"states":[{"state": "cities":[{"city":"廣州",}]}]}"status":"status":"value":"code":0,}}GetAPItocollectavailablecouponforthedistributor,thecouponabletousecrossRequestDatasales√Sales√multicouponcodes,joinwithcommaDataCouponCouponCurrency:CNY,HKD MEM會 標(biāo)準(zhǔn)券 生日 紅包 終 激amount,positiveIntegerAmountyyyy-MM-yyyy-MM-ONE positiveinteger 含 Returned{{{“couponCode”:“ “amount”:123.12,“currency”:}],"status":"value":"code":0,}}APItoverifytheinputcoupons,andautocalculatethediscountRequestData√√Currencyofcurrent√coupons√CouponDataNotorSamplecoupons√Order√Discount√0:invalid,1:InvalidReturned{{“currency”:“HKD”,"coupons":{“couponCode”:“ “amount”:12.12,“status”:“remark”:“coupon}]"status":"value":"code":0,}}}LockAPItolocktheusedcouponstoavoidPOSadmindeletetheRequestData√√coupons√CouponEmptyReturned{{"data":"status":"value":"code":0,}}APItoreleasethelockedcouponstoreleasethecouponforPOSadminRequestData√√coupons√CouponEmptyReturned{{"status":"value":"code":0,}}BatchOrderAPIforbatchorderRequestData√Uniquesales√√√√Distributor7√yyyy-MM-√√√√√√√5√√√√√√√55√ 自 5√ √5√ IPTCiPointSRVCService1√5Y待付 ship5√Orderedproducts√Product√√√√Coupon√DataDataUniqueOrderResult,1:success,-1:ErrorReturned{{"data":{"appNo":"orderNo":"result":1,}"status":"value":"code":0,}}selectOMKINFO.DEALER_NO, fromOMK.OMK_DEALER_INFOOMKINFOWHEREOMKINFO.DEALER_NO=?URLData√DealerDataSALE_Da Returned{{"data":"isActive":"dealerType":"typeInactiveDate":"2017-01-01T00:00:00 "phoneNumber":"95142655","distributorID":"sponsorID":"regionCode":"HKG","fullName":"ChanManYi","lastUpdateDate":"2013-05-07T15:55:19 "registrationDate":"2013-05-07T00:00:00 "areaCode":null"status":"value":"code":0,}}AccountOMK_POST_DESC.POST_DESCasposition,FROM(SELECT as asA.DEALER_POST_CODEasFROMOMK.OMK_DEALER_INFOA,OMK.V_GDS_GSALARY_TRIAL_BALANCEBWHEREA.DEALER_NO=B.DEALER_NOANDA.DEALER_NO=?)oriLEFTJOINOMK.OMK_POST_DESCONori.positionCode=OMK_POST_DESC.POST_CODEANDOMK_POST_DESC.LANGUAGE_CODE=?URLData√DealerRequestData√LanguageDataReturned{{"data":"position