Pour synchroniser les produits, vous aurez besoin d'un catalogId . Dans la plupart des intégrations, ce dernier sera créé en votre nom par votre responsable de compte technique. Une fois qu'un catalogue est créé, votre responsable de compte technique doit le rendre visible dans votre portail CitrusAd.

Contexte de création des catalogues

Voici un exemple de contexte pour la création d'un catalogue :

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

En cas de succès, l'objet suivant sera renvoyé :

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

❗️

Une fois qu'un objet a bien été renvoyé, vous recevrez un id pour votre nouveau catalogue. Si vous effectuez à nouveau la même requête, vous recevrez un nouvel id, créant ainsi deux catalogues.

📘

Vous aurez besoin de cet id pour la synchronisation des produits.

Création de plusieurs catalogues

Si vous créez plusieurs catalogues, vous pouvez en ordonner jusqu'à 100 par requête. Voici un exemple de contexte pour la création de deux catalogues :

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"
        }
    ]
}

En cas de succès, l'objet suivant sera renvoyé (chaque catalogue aura son propre 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"
        }
    ]
}

🚧

Un catalogue est masqué par défaut après sa création. Contactez votre responsable de compte technique pour que votre catalogue soit rendu visible sur votre espace de noms.