제품을 동기화하려면 푸시할 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"
        }
    ]
}

🚧
카탈로그는 기본적으로 생성된 후 숨겨집니다. 카탈로그를 네임스페이스에서 보이게 하려면 기술 계정 관리자에게 문의하십시오.