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

文檔控 安全機(jī) AppCode& 獲取 刷新 使用 數(shù)據(jù)簽 API接口細(xì) 所有接口列 數(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會(huì)給接口調(diào)用方提供一個(gè)appCode和一個(gè)appSecret。用于識(shí)別、獲appCode和appSecret是一對(duì)“帳號(hào)”和“”。由POS生成并添加到系統(tǒng)中，然后提供給接口調(diào)用者使用。POS系統(tǒng)管理員可以管理這些code和secret。appCode過期后，只能人工appCode和appSecret。appCode可以添加ip過濾白，由接口調(diào)用者申請(qǐng)，POS手動(dòng)添加。此接口通過200狀態(tài)碼返回正確結(jié)果，通過4XX返回錯(cuò)誤的結(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以 名，計(jì)算方法（上述java）需要用到系統(tǒng)（UDDS）時(shí)間戳。流程如下：timestamp，sign，token設(shè)置到httpAPIAPI序號(hào)接口名稱回調(diào)URL(含版本號(hào)1Get2Get34Online5POS√6Update7POSUpdate√8Get9GetProductOrderPOSOrder√POSOrder√GetOrderGetOrderOrderOrderPaymentGetGetVerifyLockReleaseBatchDealerAccountTeamTeamDownLineMethodContent。Method說明了調(diào)用接口所需要的HttpMethod。Content說明了提交數(shù)據(jù)時(shí)所需的格式。 GET方式請(qǐng)求，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有可能是一個(gè)對(duì)象({…})，也有可能是數(shù)組([…])，請(qǐng)參照具體的接口說明。code不為0（發(fā)生錯(cuò)誤）時(shí)，data沒有意義。接口通過HttpCode200status.code來表達(dá)正確還是錯(cuò)誤。通過HttpCode4xx返回安全錯(cuò)誤。Http0UnhandledRequiredHeaderisAcessRequiredFieldisParameterAppTokenisInvalidorAccessIpisAccessSignisAccessErrorAboutErrorAboutErrorAboutErrorAboutErrorAbout GetRetrievedistributors’listbymarket,registrationdateandupdateRequestDataSample√registrationdate2016-01-registrationdate2016-01-member’supdatedate2016-01-member’supdatedate2016-01-第NDataDataNotEmptySample5√ 激 無 暫 終 5√ 個(gè) 公√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√ 激 無 暫 終 自動(dòng)終 √√DistributorParentDistributorMemberfullnameinEnglish(lastMembernameinMemberlastnameinMembernameinMemberlastnamein5√ 個(gè) 公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√ 個(gè) 公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√√√N(yùn)umberofproduct1Y/N,經(jīng)銷商App及發(fā)布狀態(tài)均為的時(shí)候商品才可以在APP經(jīng)銷商App1Y/N,經(jīng)銷商App及發(fā)布狀態(tài)均為的時(shí)候商品才可以在APP1√BackorderallowedorPricesYYProductY DIS經(jīng)銷商價(jià)格STU員工價(jià)格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會(huì) 標(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