ข้ามไปที่เนื้อหา

การซิงค์ API โปรไฟล์

โปรดตั้งค่า API ตามประเภทโปรไฟล์ชุมชนในเมนูการรวม API โปรไฟล์

เมื่อใช้เฉพาะโปรไฟล์ชุมชน ให้ลงทะเบียน API รูปภาพโปรไฟล์พื้นฐาน
เมื่อเชื่อมโยงโปรไฟล์เกม ให้ลงทะเบียน API โปรไฟล์เกม

รูปโปรไฟล์เริ่มต้น¶

API รูปโปรไฟล์ใช้เพื่อเปลี่ยนรูปโปรไฟล์เริ่มต้นของชุมชน.

API จะดึงข้อมูลและการอัปเดตจะเกิดขึ้น เวลา 02:00 (KST) ผ่านโปรแกรมชุด (ใช้กับทั้งสภาพแวดล้อมการผลิตและแซนด์บ็อกซ์)。
ขนาดต้องมีอย่างน้อย 160 x 160px และการทำมุมกลมและขอบจะถูกนำมาใช้โดยค่าเริ่มต้น ดังนั้นโปรดสร้างภาพในอัตราส่วนสี่เหลี่ยมจัตุรัส。

URL ที่ร้องขอ¶

URL เชิงพาณิชย์	https://${URL}/profile/get-image-list
URL ทดสอบ	https://${URL}/profile/get-image-list

ร่างคำขอ¶

+ ประเภท : post
+ พารามิเตอร์
    - ไม่มีพารามิเตอร์

ร่าง BODY¶

+ ประเภท : json
+ พารามิเตอร์

ชื่อ	คำอธิบาย	ประเภท	ค่า
result	ผลลัพธ์	JSON Object
result.code	รหัสผลลัพธ์ (100 : สำเร็จ)	Integer	100
result.msg	ข้อความผลลัพธ์	String
params	พารามิเตอร์	JSON Object
params.total	จำนวนรายการ	int	10
params.list	รายการ (URL รูปภาพ)	String Away	\["https://test-img.co.kr/profile1.jpg","https://test-img.co.kr/profile2.jpg" ... \]

รหัสคืน¶

+ 100 \- สำเร็จ \- สำเร็จ (โปรดตรวจสอบให้แน่ใจว่าความสำเร็จจะแสดงด้วย 100 เสมอ.)

ตัวอย่างการตอบกลับ¶

{
    "result": {
        "code": 100,
        "msg": "success"
    },
    "params":{
        "total": 10,
        "list":[
                "https://test-img.co.kr/profile1.jpg",
                "https://test-img.co.kr/profile2.jpg",
                "https://test-img.co.kr/profile3.jpg",
                ……
                "https://test-img.co.kr/profile10.jpg"
        ]
    }
}

Game Profile API¶

ผู้ดูแลระบบสามารถกำหนดค่า API เพื่อให้ผู้ใช้มีโปรไฟล์เดียวกันทั้งในชุมชนและในเกม

โปรไฟล์เกมจะถูกอัปเดตเมื่อผู้ใช้เข้าสู่ระบบในชุมชน.

URL ที่ร้องขอ¶

URL เชิงพาณิชย์	https://${URL}/profile/get-player
URL ทดสอบ	https://${URL}/profile/get-player

ข้อมูลการร้องขอ¶

+ ประเภท : post
+ พารามิเตอร์

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
pid	PlayerID ของผู้ใช้	สตริง	ใช่

ตัวอย่าง¶

{
    "pid" : "20000010000"
}

เนื้อหาการตอบกลับ¶

+ ประเภท : json
+ พารามิเตอร์

ชื่อ	คำอธิบาย	ประเภท	ค่า
result	ผลลัพธ์	JSON Obejct
result.code	รหัสผลลัพธ์ (100: สำเร็จ)	จำนวนเต็ม	100
result.msg	ข้อความผลลัพธ์	สตริง
params	พารามิเตอร์	JSON Obejct
params.pid	PlayerID ของผู้ใช้	สตริง	20000010000
params.nickname	ชื่อเล่นของผู้ใช้	สตริง	Tom
params.p_image	URL รูปโปรไฟล์ของผู้ใช้	สตริง	https://test-img.co.kr/profile1.jpg

รหัสการคืนค่า¶

+ 100 - SUCCESS - สำเร็จ (โปรดตรวจสอบให้แน่ใจว่าความสำเร็จจะแสดงด้วย 100 เสมอ)
+ 101 - INVALID_REQUEST - เมื่อค่าคีย์ที่จำเป็นหายไป
+ 102 - NOT_EXIST_USER - เมื่อผู้ใช้ไม่มีอยู่

ตัวอย่างการตอบกลับ¶

{
    "result": {
        "code": 100,
        "msg": "success"
    },
    "params": {
        "pid": "20000010000",
        "nickname": "Tom",
        "p_image": "https://test-img.co.kr/profile1.jpg"
    }
}