หมวดหมู่

โฮมเพจ » บริการและการสนับสนุน » เปิดบริการ API

ApiOpenStep.jpg

Common Calling Convention

   1. จุดสิ้นสุด API:
       http://www.sunsky-api.com
       ตัวอย่าง API URL: http://www.sunsky-api.com/openapi/category!getChildren.do
   2. พารามิเตอร์ทั่วไป:
       key: คีย์ api ที่คุณได้รับจาก SUNSKY Open API Platform.
       ลายเซ็น: ลายเซ็นสำหรับพารามิเตอร์จะถูกสร้างขึ้นด้วยค่าพารามิเตอร์และ ความลับ ที่คุณได้รับจาก SUNSKY Open API Platform.
   ข้อควรระวัง: พารามิเตอร์ควรเรียงลำดับตามชื่อก่อนสร้างลายเซ็น
   3. รูปแบบผลลัพธ์
       ค่าที่ส่งคืนได้รับการจัดรูปแบบใน JSON
       (a) ตัวอย่างผลสำเร็จ:
           { result: "success", data: [{"id":1032,"code":"003","gmtCreated":"01/31/2013 00:00","name":"N Style Phone","parentId":408,"status":1}] }
       (b) ตัวอย่างผลล้มเหลว:
           { result: "error", messages: [  "The record you visiting does NOT exist." ] }
   4. ควบคุมความถี่การเรียก
       SUNSKY จะจำกัดความถี่ของการเรียก API ในกรณีที่เรียกใช้เซิร์ฟเวอร์จำนวนมาก
       โปรดดูรายละเอียดเพื่อรับข้อมูลการควบคุมความถี่: http://www.sunsky-api.com/admin/apiAccessControl!list.do
   ข้อควรระวัง: พารามิเตอร์และค่าที่ส่งคืนต้องเป็นตัวพิมพ์เล็กและใหญ่

Interface 1: รับหมวดหมู่ย่อยที่ระบุไว้ในพารามิเตอร์

    (a) URL: /openapi/category!getChildren.do
    (b) พารามิเตอร์: 
          หากคุณไม่ส่งผ่านพารามิเตอร์ใด ๆ API นี้จะเรียกคืนหมวดหมู่ทั้งหมด
          คุณสามารถระบุพารามิเตอร์ดังต่อไปนี้เพื่อกรองหมวดหมู่ที่คุณต้องการเรียกใช้:
          * parentId: ID ของหมวดหมู่ที่คุณต้องการรับหมวดหมู่ย่อยโดยตรงหรือไม่บังคับ
          * gmtModifiedStart: gmtModifiedStart: เมื่อต้องการเรียกหมวดหมู่ที่เคยมีการเปลี่ยนแปลงตั้งแต่ 'gmtModifiedStart' ในรูปแบบของ MM / dd / yyyy HH: mm: ss (เช่น 10/31/2013 01:23:20) หรือไม่ก็ได้
    (c) ผลลัพธ์:
           สรุป:
           * ถ้าคุณไม่ผ่านพารามิเตอร์ parentId อาร์เรย์ของทุกหมวดหมู่จะถูกส่งกลับ 
           * ถ้าคุณระบุ '0' สำหรับ parentId ระบบจะแสดงอาร์เรย์ของหมวดหมู่ระดับบนสุด
           * ถ้าคุณระบุหมายเลขอื่นสำหรับ parentId ระบบจะแสดงอาร์เรย์ของหมวดหมู่ย่อยโดยตรง
           * ถ้าคุณระบุวันที่สำหรับ gmtModifiedStart แล้วอาร์เรย์ของหมวดหมู่ที่เคยมีการเปลี่ยนแปลงตั้งแต่ 'gmtModifiedStart' จะถูกส่งกลับ
           ทุ่ง:
           * id: รหัสเฉพาะของหมวดหมู่
           * code: รหัสของหมวดหมู่ หมวดหมู่ย่อยจะถูกจัดเรียงตามรหัส
           * name: ชื่อเต็มของหมวดหมู่
           * shortName: ชื่อย่อของหมวดหมู่อาจว่างเปล่า
           * hsCode: รหัส HS สำหรับผลิตภัณฑ์ในหมวดหมู่อาจว่างเปล่า หาก HS Code ว่างเปล่าโปรดตรวจสอบ HS Code ของหมวดหมู่หลัก
           * status: สถานะของหมวดหมู่ ดูภาคผนวก A
           * parentId: ID ของหมวดหมู่หลัก
           * gmtModified: เวลาในการเปลี่ยนแปลงในรูปแบบของ MM / dd / yyyy HH: mm: ss (เช่น 10/31/2013 01:23:20)
      คำแนะนำ: จะได้รับหมวดหมู่ที่มีการเปลี่ยนแปลงได้อย่างไร?
            (1) ก่อนที่จะเรียก getChildren API ให้โหลด T0 ที่บันทึกไว้ก่อนหน้านี้จาก db/file;
(2) เรียก getChildren API ด้วย gmtModifiedStart = T0 มันจะคืนค่าหมวดหมู่ที่เคยเปลี่ยนไปตั้งแต่ T0 (3) ปรับปรุงฐานข้อมูลท้องถิ่นของคุณด้วยข้อมูลหมวดหมู่ที่ส่งคืนโดย getChildren API (4) อัปเดต T0 ให้เป็น max gmtModified ระหว่าง catetories ที่ส่งกลับโดย getChildren API จากนั้น ให้บันทึก T0 เป็น db/file; (5) Increase the page number and repeat step 2~4 until the getChildren API returns no data;

Interface 2: ค้นหาผลิตภัณฑ์

    (a) URL: /openapi/product!search.do 
    (b) พารามิเตอร์: 
           * categoryId: ID ของหมวดหมู่ที่คุณต้องการค้นหาผลิตภัณฑ์ภายใน (รวมถึงหมวดหมู่ย่อย) หรือไม่ก็ได้
           * pageSize: ขนาดอาร์เรย์ของผลิตภัณฑ์ที่ส่งคืนค่าตั้งต้นเป็น 40, สูงสุดคือ 100
           * page: หมายเลขหน้าเริ่มต้นตั้งเป็น 1
           * gmtModifiedStart: เมื่อต้องการเรียกใช้ผลิตภัณฑ์ที่เคยมีการเปลี่ยนแปลงตั้งแต่ 'gmtModifiedStart' ในรูปแบบของ MM / dd / yyyy HH: mm: ss (เช่น 10/31/2013 01:22:31) ไม่บังคับ
           * status: สถานะของผลิตภัณฑ์ที่คุณต้องการเรียกดู ดูภาคผนวก B ไม่จำเป็น
           * brandName: ชื่อแบรนด์ของผลิตภัณฑ์ที่คุณต้องการเรียกเช่น iPartsBuy, Xiaomi, Huawei, Meizu, ไม่จำเป็น
    (c) ผลลัพธ์:
            สรุป: 
           * API นี้คืนผลิตภัณฑ์ที่ตรงกับเงื่อนไขที่คุณระบุ
           ทุ่ง:
           * total: หมายเลขผลิตภัณฑ์ทั้งหมดตรงกับเงื่อนไขที่คุณระบุ
           * pageCount: จำนวนหน้าทั้งหมดที่คำนวณโดย Total และ pageSize
           * result: อาร์เรย์ประกอบด้วยบันทึกผลิตภัณฑ์ โปรดดูที่ส่วนติดต่อ 'openapi / product! detail.do' เพื่อดูรายละเอียด
      คำแนะนำ: วิธีรับผลิตภัณฑ์ที่มีการเปลี่ยนแปลง 
            (1) ก่อนที่จะเรียก API การค้นหาให้โหลดเวลาที่บันทึกไว้ก่อนหน้าT0 จาก db/file;
(2) เรียก API การค้นหาด้วย gmtModifiedStart = T0 มันจะกลับผลิตภัณฑ์ที่เคยมีการเปลี่ยนแปลงตั้งแต่ T0
(3) ปรับปรุงฐานข้อมูลท้องถิ่นของคุณด้วยข้อมูลผลิตภัณฑ์ที่ส่งกลับโดย API การค้นหา
(4) อัปเดต T0 ให้เป็น max gmtModified ระหว่างผลิตภัณฑ์ที่ส่งกลับโดย API การค้นหาจากนั้นให้บันทึก T0 เป็น db/file;
(5) เพิ่มจำนวนหน้าและทำซ้ำขั้น 2 ~ 4 ครั้งจนกว่า API การค้นหาจะไม่ส่งข้อมูลใด ๆ

Interface 3: ดูรายละเอียดของผลิตภัณฑ์ที่ระบุ

    (a) URL: /openapi/product!detail.do 
    (b) พารามิเตอร์: 
           * itemNo: รายการ # ของผลิตภัณฑ์ที่คุณต้องการได้รับรายละเอียด     
    (c) ผลลัพธ์:
           สรุป: 
           * API นี้ส่งคืนข้อมูลทั้งหมดของผลิตภัณฑ์ที่ระบุ
           ทุ่ง:
           * id: รหัสเฉพาะของผลิตภัณฑ์
           * categoryId: รหัสหมวดหมู่ของผลิตภัณฑ์
           * itemNo: รายการ # ของผลิตภัณฑ์
           * groupItemNo: รายการฐาน # ของผลิตภัณฑ์ หากผลิตภัณฑ์ไม่ใช่แบบหลายรายการรายการในกลุ่ม # จะเหมือนกับรายการ #;
           * name: ชื่อผลิตภัณฑ์
           * barcode: บาร์โค้ดของผลิตภัณฑ์
           * description: คำอธิบายรายละเอียดของผลิตภัณฑ์
           * leadTime: คำอธิบายเวลาจัดส่ง ได้แก่ "การจัดส่งวันเดียวกันในใบสั่งซื้อก่อน 6PM (GMT + 8)", "1 ~ 3 วัน", "2 ~ 5 วัน";
           * gmtListed: เวลาที่มีการระบุผลิตภัณฑ์ในรูปแบบของ MM / dd / yyyy HH: mm: ss (เช่น 10/31/2013 01:23:20) ผลิตภัณฑ์ที่มีรายชื่ออยู่ในช่วง 90 วันที่ผ่านมาเป็นสินค้าใหม่
           * gmtModified: เวลาในการเปลี่ยนแปลงในรูปแบบของ MM / dd / yyyy HH: mm: ss (เช่น 10/31/2013 01:23:20)
           * warehouse: คลังสินค้าสำหรับจัดส่งสินค้า CN, HK หรือ RU;
           * stock: ถ้าคลังสินค้าเป็นคลังสินค้านอกประเทศ (NOT CN) ฟิลด์นี้จะให้ปริมาณสต็อคปัจจุบัน
           * moq: ปริมาณการสั่งซื้อขั้นต่ำคือ 1
           * brandName: หากผลิตภัณฑ์มีตราสินค้าจะมีชื่อแบรนด์เช่น 'Huawei';
           * modelLabel: หากผลิตภัณฑ์มีหลายรูปแบบจะแสดงเกณฑ์การจัดหมวดหมู่ (เช่นสีขนาด ... )
           * modelList: หากผลิตภัณฑ์มีรูปแบบหลายรูปแบบ
                        ทุกองค์ประกอบในอาร์เรย์เป็นคู่ key-value key คือรายการ  # value คือคำอธิบายรูปแบบ
                        เช่น [ { key: 'S-MPH-001', value: 'White' }, { key: 'S-MPH-002', value: 'Black' } ]
           * optionList: รายการที่คล้ายกันสำหรับรายชื่อ
                       {
                              display: "text" or "picture",
                              items: [ {
                                     itemNo: "S-MPH-0002",
                                     keywords: "Plastic Case for S7"
                              } ]
                       }
           * price: ราคาปัจจุบันของสินค้า
           * priceList: ราคาขายส่งของราคาตามปริมาณการสั่งซื้อ
                        ทุกองค์ประกอบในอาร์เรย์เป็นคู่ key-value key คือปริมาณ value คือราคาที่สอดคล้องกัน
                        นั่นคือ [ { key: 2, value: '2.98' }, { key: 10, value: '2.49' } ] 
           * clearance: สินค้านี้เป็นสินค้าเคลียร์หรือไม่
           * orgPrice: หากสินค้าอยู่ในระหว่างการเคลียร์หรือโปรโมชั่น ฟิลด์นี้เก็บราคาเดิม
           * priceExpired: หากสินค้าอยู่ระหว่างโปรโมชั่น ฟิลด์นี้จะจัดเก็บวันที่หมดอายุในรูปแบบของ MM / dd / yyyy HH: mm (เช่น 10/31/2013 00:00) อาจเป็นโมฆะ
           * status: สถานะของสินค้า ดูภาคผนวก B
           * unitWeight: น้ำหนักหน่วยของสินค้า
           * packQty: ปริมาณของสินค้าใน 1 กล่อง
           * packWeight: ปริมาณของสินค้าใน 1 กล่องที่อยู่ในหน่วย 'กิโลกรัม'
           * packLength&packWidth&packHeight: ปริมาณของสินค้าใน 1 กล่องที่อยู่ในหน่วย 'มม.'
           * containsBattery: สินค้ามีแบตเตอรี่หรือไม่? จริงหรือเท็จ
           * giftItemNo: หากสินค้ามีของขวัญฟรีช่องนี้มีรายการของขวัญ #
           * brands: หากสินค้านี้เป็นอุปกรณ์เสริม ฟิลด์นี้จะแสดงแบรนด์รุ่นที่เข้ากันได้ ฟิลด์นี้ไม่ถูกส่งกลับโดย '/openapi/product!search.do'
                     ตัวอย่างเช่น: [ { brand: { name: "Apple" }, models: [ { name: "iPhone" }, { name: "iPad" } ] } ]
           * params: พารามิเตอร์ที่สำคัญสำหรับสินค้า ฟิลด์นี้ไม่ถูกส่งกลับโดย '/openapi/product!search.do'.
                     ตัวอย่างเช่น: [ { name: "Connectivity" , values: [ "WIFI", "3G", "GPS" ] } ]

Interface 4: ดาวน์โหลดภาพของผลิตภัณฑ์ที่ระบุ

    (a) URL: /openapi/product!getImages.do 
    (b) พารามิเตอร์:
           * itemNo: รายการ # ของผลิตภัณฑ์ที่คุณต้องการได้รับรายละเอียด     
           * size: ขนาดภาพผลิตภัณฑ์ที่คุณต้องการเป็นพิกเซลหรือไม่ก็ได้
                   ขนาดสูงสุดคือ 800 x 800 รายการเก่า ๆ อาจเป็น 500 x 500
           * watermark: ลายน้ำ ไม่จำเป็น
    (c) ผลลัพธ์:
           สรุป:
           * หากไม่มี itemNo รหัสตอบกลับคือ 404 มิฉะนั้นจะส่งกลับ zip stream

Interface 5: รับรายการเปลี่ยนรูปภาพ

    (a) URL: /openapi/product!getImageChangeList.do 
    (b) พารามิเตอร์:
           * pageSize: จำนวนหน้าที่เปลี่ยนแปลงของรายการทเมื่อกลับ ค่าเริ่มต้นเป็น 40 สูงสุดเป็น 100
           * page: หมายเลขหน้า เริ่มต้นตั้งเป็น 1
           * gmtModifiedStart: เพื่อเรียกหมายเลขไอเท็มที่มีภาพเคยเปลี่ยนตั้งแต่ 'gmtModifiedStart' ในรูปแบบของ MM / dd / yyyy HH: mm: ss (เช่น 10/30/2016 11:14:01)
    (c) ผลลัพธ์:
            สรุป: 
           * total: จำนวนรายการทั้งหมดตรงกับเงื่อนไขที่ระบุ
           * pageCount: จำนวนหน้าทั้งหมดที่คำนวณโดยรวม
           * result: อาร์เรย์มีหมายเลขไอเท็มและเวลาที่อัปเดตภาพ นั่นคือ[{"itemNo": "S-MPH-001", "gmtModified": "10/31/2016 01:04:22"}]
     โปรดดาวน์โหลดภาพผลิตภัณฑ์ซึ่งมีหมายเลขสินค้าอยู่ในรายการการตั้งค่า
      คำแนะนำ: จะได้รับภาพที่มีการเปลี่ยนแปลงได้อย่างไร?
            (1) ก่อนจะเรียก API การตั้งค่าให้โหลดเวลาที่บันทึกไว้ก่อนหน้า T0 จาก db/file;
(2) เรียก API การตั้งค่าด้วย gmtModifiedStart = T0 มันจะกลับสินค้าที่มีภาพเคยเปลี่ยนตั้งแต่ T0
(3) ดาวน์โหลดภาพผลิตภัณฑ์อีกครั้งซึ่งมีหมายเลขสินค้าอยู่ในรายการเปลี่ยน
(4) อัปเดต T0 ให้เป็น max gmtModified ระหว่างรายการที่ส่งคืนโดย API การเปลี่ยนแปลง จากนั้น ให้บันทึก T0 เป็น db/file;
(5) เพิ่มจำนวนหน้าและทำซ้ำขั้น 2 ~ 4 ครั้งจนกระทั่ง API ของตัวกำหนดการส่งกลับไม่มีข้อมูล

Interface 6: รับรายชื่อประเทศสำหรับการจัดส่ง

    (a) URL: /openapi/order!getCountries.do 
    (b) พารามิเตอร์:: 
           ไม่มี.
    (c) ผลลัพธ์:
           สรุป: 
           * รับรายชื่อประเทศสำหรับจัดส่งสินค้ารวมทั้งเขต / จังหวัดหากมีอยู่
           ทุ่ง:
           * id: รหัสเฉพาะของประเทศ
           * code: รหัสประเทศให้สอดคล้องกับ ISO 3166
           * name: ชื่อประเทศ
           * shipToState: ค่าจัดส่งที่จัดทำขึ้นตามประเทศหรือไม่? อาจจะเสียค่าใช้จ่ายน้อยลง true/false;
           * stateList: รายชื่อประเทศ  / จังหวัดที่เป็นตัวเลือกของประเทศฟิลด์ต่อไปนี้:
                   ** code: รหัสจังหวัด / เขต 
                   ** name: รหัสจังหวัด / เขต 

Interface 7: รับราคาและค่าจัดส่งสำหรับสินค้า

    (a) URL: /openapi/order!getPricesAndFreights.do 
    (b) พารามิเตอร์: 
           * countryId: รหัสเฉพาะของประเทศ
           * state: รหัสสถานะของที่อยู่จัดส่งให้ดู '/openapi/order!getCountries.do' หรือไม่ก็ได้
           * items.#.itemNo, items.#.qty: รายการสินค้าเพื่อคำนวณราคาและค่าจัดส่ง
                   ** ตัว # คือจำนวนเต็มเพื่อแยกความแตกต่างของไอเท็ม เช่น items.1.itemNo, items.2.itemNo...
                   ** itemNo: รายการ # ของผลิตภัณฑ์
                   ** qty: ปริมาณสำหรับรายการ
    (c) ผลลัพธ์:
           สรุป: 
           * รับราคาและค่าจัดส่งสำหรับสินค้า
           ทุ่ง:
           * priceList: ราคาสำหรับรายการฟิลด์ต่างๆดังนี้:
                   ** productId: รหัสเฉพาะของผลิตภัณฑ์
                   ** itemNo: รายการ # ของผลิตภัณฑ์
                   ** qty: ปริมาณสำหรับรายการ
                   ** price: เป็นราคาต่อหน่วยสุดท้าย
                   ** orgPrice: ราคาต่อหน่วยสำหรับสินค้า ราคาสุดท้ายอาจถูกกว่า
                   ** amount:  ยอดรวมย่อยสำหรับรายการ
                   ** orgAmount: ยอดรวมย่อยของรายการสำหรับสินค้า ราคาสุดท้ายอาจถูกกว่า
           * freightList:  ค่าขนส่งสำหรับรายการฟิลด์ต่างๆดังนี้:
                   ** id: รหัสที่ไม่มีการรับประกันของทางจัดส่งสินค้า
                   ** name: ชื่อของทางจัดส่งสินค้า
                   ** logo: URL โลโก้ของทางจัดส่งสินค้า
                   ** description: คำอธิบายวิธีจัดส่งสินค้า
                   ** website: เว็บไซต์ของทางจัดส่งสินค้า
                   ** transitTime: คำอธิบายเวลาการจัดส่งสำหรับรายการ
                   ** shippingCost: ค่าขนส่งสำหรับสินค้า

Interface 8: สร้างการสั่งซื้อ

    (a) URL: /openapi/order!createOrder.do 
    (b) พารามิเตอร์: 
           * siteNumber: คุณเป็นเจ้าของเลขที่ใบสั่งซื้อหรือหมายเลขอ้างอิงอื่น ๆ ที่สั่งซื้อ SUNSKY หรือไม่ก็ได้ ความยาวสูงสุด: 32 ตัวอักษร
           * useBalanceOnly: หากตั้งค่าเป็น true คุณต้องมียอดเงินเพียงพอในเว็บไซต์ของ SUNSKY มิเช่นนั้นการยกเว้น 'INSUFFICENT_BALANCE' จะถูกส่งออกไป
                   หากตั้งค่าเป็น false การสั่งซื้อจะถูกสร้างโดยใช้วิธีการชำระเงินแบบโอนเงินผ่านธนาคาร เมื่อคุณมียอดคงเหลือไม่เพียงพอ ค่าเริ่มต้นตั้งค่าเป็น false หรือไม่ก็ได้
           * coupon: รหัสคูปองสามารถใช้ได้
           * deliveryAddress.countryId: รหัสเฉพาะของประเทศ
           * deliveryAddress.state: รหัสสถานะของที่อยู่จัดส่งให้ดูที่ '/openapi/order!getCountries.do'. 
                   หากไม่มีข้อมูลสถานะสำหรับประเทศ โปรดป้อนข้อมูลด้วยตนเอง ความยาวสูงสุด: 40 ตัวอักษร
           * deliveryAddress.city: เมืองที่อยู่จัดส่ง ความยาวสูงสุด: 40 ตัวอักษร
           * deliveryAddress.company: ชื่อบริษัทของที่อยู่จัดส่งหรือไม่ก็ได้ ความยาวสูงสุด: 100 ตัวอักษร
           * deliveryAddress.address: ที่อยู่ของที่อยู่จัดส่ง ความยาวสูงสุด: 100 ตัวอักษร;
           * deliveryAddress.address2: ที่อยู่บรรทัดที่ 2 ของที่อยู่จัดส่งไม่จำเป็น ความยาวสูงสุด: 100 ตัวอักษร
           * deliveryAddress.postcode: รหัสไปรษณีย์ / รหัสไปรษณีย์ของที่อยู่จัดส่ง ความยาวสูงสุด: 20 ตัวอักษร
           * deliveryAddress.receiver: ชื่อเต็มของผู้รับ ความยาวสูงสุด: 32 ตัวอักษร
           * deliveryAddress.telephone: โทรศัพท์ติดต่อของผู้รับ ไม่จำเป็นแต่แนะนำ ความยาวสูงสุด: 20 ตัวอักษร
           * deliveryAddress.shippingWayId: รหัสเฉพาะของทางจัดส่ง
                   คุณสามารถรับรายชื่อทางจัดส่งโดยโทรไปที่ '/openapi/order!getPricesAndFreights.do' และรับรหัส id จาก 'freightList' ในผล
           * deliveryAddress.shipment: drop -- dropshipping; ขายส่ง - ซื้อเอง ไม่จำเป็น ตั้งค่าเริ่มต้นเป็น "ขายส่ง"
           * items.#.itemNo, items.#.qty: รายการสินค้าที่จะสร้างคำสั่ง
                   ** ตัว # คือจำนวนเต็มเพื่อแยกความแตกต่างของไอเท็ม เช่น items.1.itemNo, items.2.itemNo...
                   ** itemNo: รายการ # ของผลิตภัณฑ์
                   ** qty: ปริมาณสำหรับรายการ
    (c) ผลลัพธ์:
           สรุป: 
           * สร้างคำสั่ง SUNSKY พร้อมรายการและข้อมูลที่อยู่จัดส่ง
           ทุ่ง:
           * number: หมายเลขใบสั่งซื้อ
           * status: สถานะคำสั่งซื้อ ดูภาคผนวก C
           * amount: ยอดรวมย่อยของรายการ
           * shippingCost: ค่าจัดส่งสินค้าตามใบสั่งซื้อ
           * totalAmount: จำนวนรวมของการสั่งซื้อ จำนวนเงิน = ราคา + ค่าจัดส่ง
           * siteNumber: ดู '/openapi/order!createOrder.do';
           * packStatus: 0 - การจัดเตรียม 1 - การบรรจุ 2 - บรรจุส่วนใหญ่แล้ว 3 - บรรจุและพร้อมที่จะจัดส่ง
* trackingNumber: หมายเลขติดตามการสั่งซื้อ * gmtCreated: เวลาสร้างการรสั่งซื้อ ในรูปแบบ 'MM/dd/yyyy HH:mm'(i.e. 10/31/2013 05:01); * gmtPaid: เวลาชำระเงินของการรสั่งซื้อ ในรูปแบบ 'MM/dd/yyyy HH:mm'(i.e. 10/31/2013 05:01); * gmtShipped: เวลาส่งของการรสั่งซื้อ ในรูปแบบ 'MM/dd/yyyy HH:mm'(i.e. 10/31/2013 05:01); * deliveryAddress.*: ข้อมูลที่อยู่จัดส่ง ดู '/openapi/order!createOrder.do'; ฟิลด์เพิ่มเติม: ** shippingWay.id: รหัสเฉพาะของทางจัดส่ง ** shippingWay.name: ชื่อของทางจัดส่ง * detailList: อาร์เรย์รายการของคำสั่งฟิลด์ดังต่อไปนี้ ** productId: รหัสเฉพาะของผลิตภัณฑ์ ** itemNo: รายการ # ของผลิตภัณฑ์ ** title: ชื่อผลิตภัณฑ์ ** qty: ปริมาณสำหรับรายการ ** price: เป็นราคาต่อหน่วยสุดท้าย ** amount: ยอดรวมย่อยสำหรับรายการ ** scaned: 0- ไม่พร้อมที่จะแพ็ค; 1 - พร้อมที่จะแพ็ค; ** delayToShip: 0-เป็นปกติ; 1 - ล่าช้าในการจัดส่ง

Interface 9: ค้นหาคำสั่งซื้อ

    (a) URL: /openapi/order!getOrderList.do 
    (b) พารามิเตอร์: 
           * pageSize: ขนาดอาร์เรย์ของการสั่งที่ส่งคืน ค่าตั้งต้นเป็น 40, max คือ 100;
           * page: หมายเลขหน้า เริ่มต้นตั้งเป็น 1;
           * status: สถานะคำสั่งซื้อหรือไม่ก็ได้ ดูภาคผนวก C;
           * siteNumber: ไม่บังคับ ดู '/openapi/order!createOrder.do';
           * gmtCreatedStart: เพื่อเรียกคำสั่งที่สร้างขึ้นหลัง (รวม) 'gmtCreatedStart' ในรูปแบบของ MM / dd / yyyy (เช่น 10/31/2013) หรือไม่ก็ได้
           * gmtCreatedEnd: เพื่อเรียกคำสั่งที่สร้างก่อน (รวม) 'gmtCreatedEnd' ในรูปแบบของ MM / dd / yyyy (เช่น 10/31/2013) หรือไม่ก็ได้ 
    (c) ผลลัพธ์:
            สรุป:
           * API นี้คืนการสั่งซื้อที่ตรงกับเงื่อนไขที่คุณระบุ
           ทุ่ง:
           * total: หมายเลขการสั่งซื้อทั้งหมดตรงกับเงื่อนไขที่คุณระบุ
           * pageCount: จำนวนคำสั่งซื้อทั้งหมดที่คำนวณโดยรวม
           * result: อาร์เรย์ประกอบด้วยเร็กคอร์ดคำสั่งดูที่ '/openapi/order!createOrder.do' เพื่อดูรายละเอียด 
                      'detailList' ไม่ได้ถูกส่งคืนโดยอินเทอร์เฟซนี้ โปรดใช้ '/openapi/order!getOrderDetails.do' เพื่อรับข้อมูลรายการ


Interface 10: เรียกดูรายละเอียดการสั่งซื้อ

    (a) URL: /openapi/order!getOrderDetails.do 
    (b)  พารามิเตอร์: 
           * number:  เลขที่ใบสั่งซื้อของ SUNSKY     
    (c)  ผลลัพธ์:
           สรุป: 
           * API นี้ส่งคืนข้อมูลทั้งหมดของการสั่งที่ระบุ
           ทุ่ง:
           * ดู  '/openapi/order!createOrder.do';


Interface 11: ตรวจสอบยอดเงินของคุณใน SUNSKY

    (a) URL: /openapi/order!getBalance.do 
    (b) พารามิเตอร์: 
           ไม่มี     
    (c) ผลลัพธ์:
           สรุป: 
           * API นี้คืนยอดเงินของคุณใน SUNSKY
            ทุ่ง:
           เพียงสตริงที่มียอดเงินของคุณ เช่น "1200.00".


Interface 12: ดูประวัติการชำระเงินของคุณ

    (a) URL: /openapi/order!getBillList.do 
    (b) พารามิเตอร์: 
           * pageSize: ขนาดอาร์เรย์ของตั๋วเงินที่ส่งคืน ค่าตั้งต้นเป็น 40, สูงสุดคือ 100
           * page: หมายเลขหน้า เริ่มต้นตั้งเป็น 1;
           * gmtCreatedStart: เรียกเก็บเงินที่สร้างขึ้นหลังจาก (รวม) 'gmtCreatedStart' ในรูปแบบของ MM / dd / yyyy (เช่น 10/31/2013) หรือไม่ก็ได้
           * gmtCreatedEnd:  เพื่อดึงข้อมูลตั๋วเงินที่สร้างก่อน (รวม) 'gmtCreatedEnd' ในรูปแบบของ MM / dd / yyyy (เช่น 10/31/2013) หรือไม่ก็ได้     
    (c) ผลลัพธ์:
            สรุป: 
           * API นี้คืนตั๋วที่ตรงกับเงื่อนไขที่คุณระบุ
           ทุ่ง:
           * total: จำนวนเงินทั้งหมดที่ตรงกับเงื่อนไขที่ระบุ
           * pageCount: จำนวนใบเรียกเก็บเงินทั้งหมดซึ่งคำนวณโดยรวม 
           * result: อาร์เรย์มีตั๋วเงิน ช่องดังนี้:
                     * txType: prepay/createOrder/payForOrder/cancelOrder;
                     * refId: ลำดับที่เกี่ยวข้องกับการเรียกเก็บเงินถ้า txType เป็น createOrder/payForOrder/cancelOrder;
                     * amount: จำนวนเงินที่เปลี่ยนแปลงหลังจากทำรายการ
                     * balance: อดเงินคงเหลือใน SUNSKY หลังการทำธุรกรรม
                     * gmtCreated: เวลาที่สร้างขึ้นของใบเรียกเก็บเงิน ในรูปแบบ 'MM/dd/yyyy HH:mm'(i.e. 10/31/2013 05:01);


Interface 13: รับรายการร้อน

    (a) URL: /openapi/stats!getHotItems.do 
    (b) พารามิเตอร์: 
           * countryId: รหัสเฉพาะของประเทศ   
    (c) ผลลัพธ์:
           สรุป: 
           * API นี้ส่งคืนรายการสินค้าที่น่าสนใจในประเทศที่ระบุ
            ทุ่ง:
           * itemNo: รายการ # ของผลิตภัณฑ์


Interface 14: รับรายชื่อคูปอง

    (a) URL: /openapi/coupon!getList.do 
    (b) พารามิเตอร์: 
           * pageSize: ขนาดอาร์เรย์ของคูปองที่ส่งคืน ค่าตั้งต้นเป็น 40, สูงสุดคือ 100
           * page: หมายเลขหน้า เริ่มต้นตั้งเป็น 1 
    (c) ผลลัพธ์:
           สรุป:
           * API นี้คืนคูปองที่ตรงกับเงื่อนไขที่คุณระบุ
           ทุ่ง:
           * total: จำนวนคูปองทั้งหมดตรงกับเงื่อนไขที่คุณระบุ
           * pageCount: จำนวนคูปองทั้งหมดที่คำนวณโดยรวมและ pageSize
           * result: อาร์เรย์มีคูปอง ช่องดังนี้:
                     * code: รหัสคูปอง
                     * description: คำอธิบายคูปองเพื่ออธิบายวิธีการใช้คูปอง
                     * startTime: เวลาเริ่มต้นของคูปอง ในรูปแบบ'MM/dd/yyyy HH:mm'(i.e. 10/31/2013 05:01);
                     * endTime: เวลาสิ้นสุดของคูปอง ในรูปแบบ 'MM/dd/yyyy HH:mm'(i.e. 10/31/2013 05:01);
                     * personLimit: จำนวนครั้งที่บุคคลหนึ่งสามารถใช้คูปอง
                     * qty: คูปองนี้สามารถใช้ได้กับส่วนลด
                     * discountType: 
                                   1 -- จำนวนส่วนลดคงที่; 
                                   2 -- ส่วนลดเป็นเปอร์เซ็นต์; 
                                   3 -- ราคาคงที่;
                     * discount:ตามส่วนลดประเภทต่าง ๆ ค่าที่ตรงกันหมายถึง:
                                   1 -- ส่วนลด (สตริง);
                                   2 -- เปอร์เซ็นต์ (สตริง) หลังการลดราคา, 90 หมายถึง 10% OFF;
                                   3 -- ราคาสุดท้าย (สตริง);
                     * targetType: 
                                   1 - หมวดหมู่
                                   2 - ผลิตภัณฑ์;
                                   3 - เกณฑ์จำนวนเงินการสั่งซื้อ
                                   4 - แบรนด์;
                     * target: ตาม TargetType ประเภทต่าง ๆ ค่าที่สอดคล้องกันดังต่อไปนี้:
                                   1 -- รายการหมวดหมู่ json (สตริง) ได้แก่ [ { id: 'category id', name: 'Category name' } ]
                                   2 -- รายการผลิตภัณฑ์ json (สตริง) ได้แก่  [ { id: 'product id', name: 'Product name', itemNo: 'Item #' } ]
                                   3 -- เกณฑ์จำนวนเงินตามการสั่งซื้อ (สตริง) ได้แก่  200;
                                   4 -- รายการแบรนด์ json (สตริง) ได้แก่ [ { name: 'HAWEEL' } ];
Appendix A: สถานะหมวดหมู่
    0 - ไม่ถูกต้อง
    1 - ใช้ได้
    2 - ลบแล้ว

Appendix B: สถานะผลิตภัณฑ์

    0 - ไม่ถูกต้อง
    1 - ใช้ได้
    2 - ลบแล้ว
    3 - สินค้าหมด

Appendix C: สถานะการสั่งซื้อ

    1 - ค้างชำระ
    2 - ชำระแล้ว
    3 - จัดส่งแล้ว
    4 - ยกเลิกแล้ว
    5 - ส่งแล้ว

Appendix D: ตัวอย่างโค้ด (Java, PHP)

    OpenApiService.zip
ติดต่อ SUNSKY
ผู้จัดการฝ่ายขาย: Ms. Grace
+86-13924630968
เพิ่มเติม