ใช้ HTTP เพื่อร้องขอ API

กระบวนการเรียก API

ที่อยู่ API Call Request

PandaPon Global Open Platform มีสภาพแวดล้อมการผลิตออนไลน์ที่ข้อมูลที่สร้างขึ้นเป็นข้อมูลออนไลน์จริงและมีประสิทธิภาพตามที่อยู่ที่ร้องขอด้านล่าง

ที่อยู่คำขอ API: https://api.pandapon.com

คำขอและการตอบสนอง

PandaPon Global Open Platform API รองรับทั้งโปรโตคอลการสื่อสาร HTTP และ HTTPS เพื่อความปลอดภัยของข้อมูลขอแนะนำให้ส่งคำขอ API โดยใช้โปรโตคอล HTTPS

คำขอ API ทั้งหมดจะส่งคืนผลการตอบสนองที่แสดงสถานะการส่งคืน (สำเร็จหรือผิดพลาด) และอาจให้ผลลัพธ์หรือข้อมูลโดยละเอียดที่เกี่ยวข้องกับคำขอที่ระบุและรูปแบบข้อมูลที่ส่งคืนคือ JSON

พารามิเตอร์การร้องขอ

พารามิเตอร์การร้องขอของ API ทั้งหมดมีสองส่วนคือพารามิเตอร์ของระบบและพารามิเตอร์ทางธุรกิจ

พารามิเตอร์ของระบบ

คำขอ API ทั้งหมดต้องใช้ ** พารามิเตอร์ระบบ ** โปรดดูตารางด้านล่างสำหรับรายละเอียด:

ชื่อ	ประเภท	ไม่ว่าจะเป็นต้อง	ไม่ว่าจะเป็นพารามิเตอร์ของสัญญาณ	คำอธิบาย
access-key	String	是	是	PandaPon分配给开发者的AccessKey
timestamp	String	是	是	请求发送时间，请使用UTC时间戳，注意请求时间与UTC时间不得超过600秒
nonce-str	String	是	是	随机字符串32位
user-id	String	是	否	用于子账号权限控制
signature	String	是	否	接口签名，用于验证请求合法性，具体规则详见参数签名

สิ่งที่ต้องระวังคือทั้งหมดพารามิเตอร์ของระบบต้องเก็บไว้ที่ หัวคำขอ HTTP 。

พารามิเตอร์ทางธุรกิจ

นอกจากสิ่งที่ต้องมีพารามิเตอร์ของระบบนอก，คำขอ API ทั้งหมดจะต้องมีความสอดคล้องกันพารามิเตอร์ทางธุรกิจ，พารามิเตอร์ทางธุรกิจของแต่ละ API สามารถดูรายละเอียดได้จาก [API Reference] ( https://doc.pandapon.com/?nav=2 )。

การตอบสนองคำขอ

ข้อมูลการตอบสนองคำขอสำหรับ API ทั้งหมดจะอยู่ในรูปแบบของ JSON และการอ้างอิงรูปแบบดังต่อไปนี้:

ชื่อ	ประเภท	คำอธิบาย
requestId	String	请求id，可根据请求id查询对应日志
code	Integer	返回码
developId	String	开发者id
msg	String	返回码对应信息
data	Object	返回内容

ขอตัวอย่างการตอบสนอง：

{
    "requestId": "4cfda0b725184ab8a1e3ee3b9051ec35",
    "code": 200,
    "developId": "1014533973088404335",
    "msg": "成功",
    "data": {
        "quantity": 400,
        "categoryPath": "童装/婴儿装/亲子装->裙子(新)->连衣裙",
        "shopName": "u[2206891060210]",
        "description": "测试",
        "productUnit": null,
        "picUrls": [
            "https://img.alicdn.com/bao/uploaded/i1/263669477/O1CN01fH0cbf2JsW8fvHFwx_!!263669477.jpg"
        ],
        "title": "天穹发布商品，测试请不要拍",
        "mpId": "0qZ0UVBkUJz3CsnpLt6kiLdqmzNNcIX-IQGrQ53mhv0",
        "categoryName": "连衣裙",
        "itemId": "oOMEOyBJ-IprUqT2r1tIew",
        "userNick": "测试账号tbc003",
        "price": 1,
        "beginAmount": 0,
        "status": "active",
        "promotionPrice": 1,
        "shopId": 268763467,
        "categoryId": "121452038",
        "itemType": "HAVE_MATERIAL",
        "skuList": [
            {
                "picUrl": null,
                "quantity": 200,
                "price": 1,
                "skuId": "3452545926724",
                "status": "active",
                "promotionPrice": "1",
                "postFee": 0,
                "mpSkuld": null,
                "properties": [
                    {
                        "valueId": 28326,
                        "valueName": "红色",
                        "propId": 1627207,
                        "propName": "颜色分类"
                    },
                    {
                        "valueId": 3273546,
                        "valueName": "52cm",
                        "propId": 122216343,
                        "propName": "参考身高"
                    }
                ]
            },
            {
                "picUrl": null,
                "quantity": 200,
                "price": 1,
                "skuId": "3452545926725",
                "status": "active",
                "promotionPrice": "1",
                "postFee": 0,
                "mpSkuld": null,
                "properties": [
                    {
                        "valueId": 28324,
                        "valueName": "黄色",
                        "propId": 1627207,
                        "propName": "颜色分类"
                    },
                    {
                        "valueId": 3273546,
                        "valueName": "52cm",
                        "propId": 122216343,
                        "propName": "参考身高"
                    }
                ]
            }
        ]
    }
}

ลายเซ็นพารามิเตอร์

PandaPon Global Open Platform จะตรวจสอบความถูกต้องของแต่ละคำขอ API และเซิร์ฟเวอร์จะตรวจสอบว่าพารามิเตอร์การร้องขอนั้นถูกต้องหรือไม่ ดังนั้นทุกคำขอ HTTP จะต้องมีข้อมูลลายเซ็นและคำขอที่ลายเซ็นไม่ถูกต้องจะถูกปฏิเสธ

PandaPon Global Open Platform ยืนยันตัวตนของคำขอผ่าน AccessKey และคีย์ที่กำหนดให้นักพัฒนา (AccessSecret) คีย์ (AccessSecret) ใช้เพื่อสร้างสตริงลายเซ็นเมื่อมีการร้องขอ HTTP โปรดเก็บคีย์ของคุณไว้เป็นความลับอย่างเคร่งครัด (AccessSecret)

ขั้นตอนการสร้างลายเซ็นมีดังนี้
ขั้นตอนที่ 1: กด 'Access-key' พารามิเตอร์การร้องขอสาธารณะ, ' timestamp'，'nonce_str'，' คีย์ลับที่ได้รับอนุญาต 'ประกบโดยตรง;
ขั้นตอนที่ 2: ประกบสตริงที่เสร็จสมบูรณ์ในขั้นตอนแรกเข้ารหัสโดย md5;
ขั้นตอนที่ 3: แปลงสตริงทั้งหมดที่ได้จากการเข้ารหัสเป็นตัวพิมพ์ใหญ่เพื่อให้ได้ลายเซ็นสุดท้าย (สัญญาณ)

รหัสตัวอย่าง JAVA:

รหัสตัวอย่าง PHP:

คู่มือการพัฒนา

ใช้ HTTP เพื่อร้องขอ API#

กระบวนการเรียก API#

ที่อยู่ API Call Request#

คำขอและการตอบสนอง#

พารามิเตอร์การร้องขอ#

พารามิเตอร์ของระบบ#

พารามิเตอร์ทางธุรกิจ#

การตอบสนองคำขอ#

ลายเซ็นพารามิเตอร์#