API ของคู่ค้า

การซิงค์แค็ตตาล็อกผ่าน API

ในการซิงโครไนซ์ผลิตภัณฑ์ คุณต้องมี catalogId เพื่อผลักดันให้ ในการผสานการทำงานส่วนใหญ่ ผู้จัดการบัญชีด้านเทคนิคของคุณจะเป็นผู้สร้างขึ้นในนามของคุณ เมื่อสร้างแค็ตตาล็อกแล้ว ผู้จัดการบัญชีด้านเทคนิคของคุณต้องทำให้มองเห็นได้ภายในพอร์ทัล CitrusAd ของคุณ

บริบทการสร้างแคตตาล็อก

ด้านล่างนี้เป็นตัวอย่างบริบทสำหรับการสร้างแค็ตตาล็อก:

POST $BASE_URL/v1/catalogs HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogs": [
        {
            "name": "Retailer A"
        }
    ]
}

หากสำเร็จ อ็อบเจ็กต์ต่อไปนี้จะถูกส่งคืน:

{
    "catalogs": [
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer A",
            "id": "216af452-d219-4807-b8ca-578bba446541"
        }
    ]
}

❗️

เมื่อวัตถุถูกส่งกลับประสบความสำเร็จ คุณจะได้รับ id สําหรับแค็ตตาล็อกใหม่ของคุณ หากคุณส่งคำขอเดิมอีกครั้ง คุณจะได้รับ idสร้างแค็ตตาล็อกสองรายการ

📘

คุณจะต้องการสิ่งนี้ id สําหรับการซิงค์ผลิตภัณฑ์

การสร้างแค็ตตาล็อกหลายรายการ

หากคุณกำลังสร้างแค็ตตาล็อกหลายรายการ คุณสามารถจัดลำดับได้สูงสุด 100 รายการต่อคำขอ ด้านล่างนี้เป็นตัวอย่างบริบทสำหรับการสร้างสองแค็ตตาล็อก:

POST $BASE_URL/v1/catalogs HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogs": [
        {
            "name": "Retailer A"
        },
        {
            "name": "Retailer B"
        }
    ]
}

หากสำเร็จ วัตถุต่อไปนี้จะถูกส่งคืน (แต่ละแค็ตตาล็อกจะมี id):

{
    "catalogs": [
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer A",
            "id": "216af452-d219-4807-b8ca-578bba446541"
        },
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer B",
            "id": "75047339-65f5-41b8-8f2c-e76b04716cd4"
        }
    ]
}

🚧

แค็ตตาล็อกจะถูกซ่อนตามค่าเริ่มต้นเมื่อสร้างแล้ว ติดต่อผู้จัดการบัญชีด้านเทคนิคของคุณเพื่อให้แคตตาล็อกของคุณปรากฏบนเนมสเปซของคุณ