Setting Product Tags Relations

$curl = curl_init();
$data = [
  'username' => 'USERNAME',
  'password' => 'PASSWORD',
  'account' => 'ACCOUNT_ID',
  'pid' => 12345,
  'tag_ids' => [1, 3, 5]
];
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://easycms.fi/public_api/set_product_tags_relations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => json_encode($data),
  CURLOPT_HTTPHEADER => array(
    "Authorization1: TOKEN",
    "Content-Type: application/json"
  ),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;

import requests
import json

url = "https://easycms.fi/public_api/set_product_tags_relations"
headers = {
    "Authorization1": "TOKEN",
    "Content-Type": "application/json"
}

# Add tags
payload = {
    'username': 'USERNAME',
    'password': 'PASSWORD',
    'account': 'ACCOUNT_ID',
    'pid': 12345,
    'tag_ids': [1, 3, 5]
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print(response.text)

# Replace all tags
payload = {
    'username': 'USERNAME',
    'password': 'PASSWORD',
    'account': 'ACCOUNT_ID',
    'pid': 12345,
    'tag_ids': [2, 4],
    'replace': 1
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print(response.text)

# Delete specific tags
payload = {
    'username': 'USERNAME',
    'password': 'PASSWORD',
    'account': 'ACCOUNT_ID',
    'pid': 12345,
    'tag_ids': [1, 5],
    'delete': 1
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print(response.text)

# Delete all tags
payload = {
    'username': 'USERNAME',
    'password': 'PASSWORD',
    'account': 'ACCOUNT_ID',
    'pid': 12345,
    'delete_all': 1
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print(response.text)

HttpClient client = HttpClient.newHttpClient();
String jsonBody = "{\"username\":\"USERNAME\",\"password\":\"PASSWORD\",\"account\":\"ACCOUNT_ID\",\"pid\":12345,\"tag_ids\":[1,3,5]}";
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://easycms.fi/public_api/set_product_tags_relations"))
    .headers("Authorization1", "TOKEN", "Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

const https = require('https');
const data = JSON.stringify({
  username: 'USERNAME',
  password: 'PASSWORD',
  account: 'ACCOUNT_ID',
  pid: 12345,
  tag_ids: [1, 3, 5]
});
const options = {
  hostname: 'easycms.fi',
  path: '/public_api/set_product_tags_relations',
  method: 'POST',
  headers: {
    'Authorization1': 'TOKEN',
    'Content-Type': 'application/json',
    'Content-Length': data.length
  }
};
const req = https.request(options, (res) => {
  let responseData = '';
  res.on('data', (chunk) => { responseData += chunk; });
  res.on('end', () => { console.log(responseData); });
});
req.on('error', (e) => { console.error(e); });
req.write(data);
req.end();

import React, { useState } from 'react';
function ManageTags() {
  const [response, setResponse] = useState('');
  const addTags = async () => {
    try {
      const res = await fetch('https://easycms.fi/public_api/set_product_tags_relations', {
        method: 'POST',
        headers: {
          'Authorization1': 'TOKEN',
          'Content-Type': 'application/json'
        },
        body: JSON.stringify({
          username: 'USERNAME',
          password: 'PASSWORD',
          account: 'ACCOUNT_ID',
          pid: 12345,
          tag_ids: [1, 3, 5]
        })
      });
      const data = await res.json();
      setResponse(JSON.stringify(data, null, 2));
    } catch (error) {
      console.error(error);
    }
  };
  return (
    <div>
      <button onClick={addTags}>Add Tags</button>
      <pre>{response}</pre>
    </div>
  );
}
export default ManageTags;

import okhttp3.OkHttpClient
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.RequestBody.Companion.toRequestBody
import okhttp3.Request

fun main() {
    val client = OkHttpClient()
    val json = """
        {
            "username": "USERNAME",
            "password": "PASSWORD",
            "account": "ACCOUNT_ID",
            "pid": 12345,
            "tag_ids": [1, 3, 5]
        }
    """.trimIndent()

    val body = json.toRequestBody("application/json".toMediaType())

    val request = Request.Builder()
        .url("https://easycms.fi/public_api/set_product_tags_relations")
        .post(body)
        .addHeader("Authorization1", "TOKEN")
        .build()

    client.newCall(request).execute().use { response ->
        if (!response.isSuccessful) throw IOException("Unexpected code $response")
        println(response.body?.string())
    }
}

using System;
using System.Net.Http;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var token = "TOKEN";
        var payload = new {
            username = "USERNAME",
            password = "PASSWORD",
            account = "ACCOUNT_ID",
            pid = 12345,
            tag_ids = new[] { 1, 3, 5 }
        };
        var json = JsonSerializer.Serialize(payload);
        var content = new StringContent(json, Encoding.UTF8, "application/json");

        using (var httpClient = new HttpClient())
        {
            httpClient.DefaultRequestHeaders.Add("Authorization1", token);
            var response = await httpClient.PostAsync("https://easycms.fi/public_api/set_product_tags_relations", content);
            if (response.IsSuccessStatusCode)
            {
                var responseData = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseData);
            }
            else
            {
                Console.WriteLine($"Error: {response.StatusCode}");
            }
        }
    }
}

#### OUTPUT object:

- `response_type`: Response status - "success" or "error".
- `message`: Status message describing the result of the operation.
- `tags`: Array of currently assigned tags for the product (after the operation).
  - `id`: The internal ID of the tag relation record.
  - `pid`: The product ID.
  - `products_tags_id`: The unique identifier for the tag.
  - `products_tags_name`: An object containing tag names in different languages.
  - `visible`: Visibility status of the tag.
  - `image_name`: The filename of the image associated with the tag.

#### changes object:

- **Add operation:**
  - `added`: Array of tag IDs that were successfully added.
  - `skipped_duplicates`: Array of tag IDs that already existed and were skipped.

- **Replace operation:**
  - `replaced`: Boolean indicating a replace operation was performed.
  - `old_deleted`: Number of previous relations that were removed.
  - `added`: Array of tag IDs that were added.

- **Delete operation:**
  - `deleted`: Number of tag relations that were removed.
  - `tag_ids_processed`: Array of tag IDs that were processed for deletion.

- **Delete All operation:**
  - `deleted_all`: Number of tag relations that were removed.
    

#### Add Tags Response Example:
{
  "INFO": {
    "start": 0,
    "limit": 50,
    "count": 3,
    "total_count": 3,
    "pid": 12345,
    "docs": "https://cms.helpostikotisivut.fi/DOCUMENTATION/bt5/set_product_tags_relations"
  },
  "OUTPUT": {
    "response_type": "success",
    "message": "Tag relations added successfully",
    "tags": [
      {
        "id": "15",
        "pid": "12345",
        "products_tags_id": "1",
        "products_tags_name": {
          "fi_FI": "Uutuus",
          "en_GB": "New",
          "sv_SE": "Nyhet"
        },
        "visible": "1",
        "image_name": "new-icon.png"
      },
      {
        "id": "23",
        "pid": "12345",
        "products_tags_id": "3",
        "products_tags_name": {
          "fi_FI": "Alennus",
          "en_GB": "Discount",
          "sv_SE": "Rabatt"
        },
        "visible": "1",
        "image_name": "discount-icon.png"
      },
      {
        "id": "24",
        "pid": "12345",
        "products_tags_id": "5",
        "products_tags_name": {
          "fi_FI": "Suosittu",
          "en_GB": "Popular",
          "sv_SE": "Popul\u00e4r"
        },
        "visible": "1",
        "image_name": "popular-icon.png"
      }
    ]
  },
  "changes": {
    "added": [1, 3, 5],
    "skipped_duplicates": []
  }
}

#### Replace Tags Response Example:
{
  "INFO": {
    "start": 0,
    "limit": 50,
    "count": 2,
    "total_count": 2,
    "pid": 12345,
    "docs": "https://cms.helpostikotisivut.fi/DOCUMENTATION/bt5/set_product_tags_relations"
  },
  "OUTPUT": {
    "response_type": "success",
    "message": "Tag relations replaced successfully",
    "tags": [
      {
        "id": "25",
        "pid": "12345",
        "products_tags_id": "2",
        "products_tags_name": {
          "fi_FI": "Tarjous",
          "en_GB": "Sale",
          "sv_SE": "Rea"
        },
        "visible": "1",
        "image_name": null
      },
      {
        "id": "26",
        "pid": "12345",
        "products_tags_id": "4",
        "products_tags_name": {
          "fi_FI": "Varattu",
          "en_GB": "Reserved",
          "sv_SE": "Reserverad"
        },
        "visible": "1",
        "image_name": null
      }
    ]
  },
  "changes": {
    "replaced": true,
    "old_deleted": 3,
    "added": [2, 4]
  }
}

#### Delete Specific Tags Response Example:
{
  "INFO": {
    "start": 0,
    "limit": 50,
    "count": 1,
    "total_count": 1,
    "pid": 12345,
    "docs": "https://cms.helpostikotisivut.fi/DOCUMENTATION/bt5/set_product_tags_relations"
  },
  "OUTPUT": {
    "response_type": "success",
    "message": "Tag relations deleted successfully",
    "tags": [
      {
        "id": "26",
        "pid": "12345",
        "products_tags_id": "4",
        "products_tags_name": {
          "fi_FI": "Varattu",
          "en_GB": "Reserved",
          "sv_SE": "Reserverad"
        },
        "visible": "1",
        "image_name": null
      }
    ]
  },
  "changes": {
    "deleted": 1,
    "tag_ids_processed": [2]
  }
}

#### Delete All Tags Response Example:
{
  "INFO": {
    "start": 0,
    "limit": 50,
    "pid": 12345,
    "docs": "https://cms.helpostikotisivut.fi/DOCUMENTATION/bt5/set_product_tags_relations"
  },
  "OUTPUT": {
    "response_type": "success",
    "message": "All tag relations deleted successfully",
    "tags": []
  },
  "changes": {
    "deleted_all": 1
  }
}