Netim Direct
Updated on 20 September 2023

Create protection

1 Description
2 Common language examples

Description

POST https://rest.netim.com/1.0/brandprotection/

Create a new brand protection.

Headers

  • Authorization string
    The Autorization header must start with “Bearer ” followed by the session ID. Example:”Autorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26″
  • Content-type string
    Content type of the request Only “application/json” is accepted

Body

REQUIRED
  • label string (256)
    Brand main label
  • prod string (20)
    Brand protection product ID (See brand protection products)
  • duration integer
    Period of validity in years
  • idOwner string (12)
    ID of the owner contact (with “isOwner=1”)
  • type string (3)
    Brand’s type
  • info array
    Array of strings containing brand datas

JSON example

{
    "label":"exampleLabel",
    "prod":"ADULTBLOCK",
    "duration":"1",
    "idOwner":"IDOWN",
    "type":"ORG",
    "info": {
        "NAME":"test",
        "NUMBER":"123456789",
        "JURISDICTION":"example"
    }
}
  • idOwner must exist and belong the reseller.
  • idOwner must be a contact with isOwner=1
  • The type can take three different values :
    • SMD if your brand protection rely on a SMD file.
    • TM if your brand has a trademark.
    • ORG if your brand is an organization.
  • The array info is required to be filled with the following values if the type is not SMD:
    • NAME for the trademark or brand name.
    • NUMBER for the trademark or brand number.
    • JURISDICTION for the trademark or brand registry.

Common language examples

<?php
 
$ch = curl_init();
 
$body = array(
    "label" => "exampleLabel",
    "prod" => "ADULTBLOCK",
    "duration" => 1,
    "idOwner" => "IDOWN",
    "type" => "ORG",
    "info" => array(
        "NAME" => "test",
        "NUMBER" => "123456789",
        "JURISDICTION" => "example"
    ),
);
 
curl_setopt($ch, CURLOPT_URL,"https://rest.netim.com/1.0/brandprotection/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $sessionID", "Content-type: application/json"]);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
curl_setopt($ch, CURlOPT_POSTFIELDS, json_encode($body));
 
$result = json_decode(curl_exec ($ch), true);
$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close ($ch);

import java.util.Base64;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
public class Example {
 
    public static void main(String args[]) throws Exception {
        String sessionID = "12345678";
        String body = "{\"label\":\"exampleLabel\",\"prod\":\"ADULTBLOCK\",\"duration\":\"1\",\"idOwner\":\"IDOWN\",\"type\":\"ORG\",\"info\": {\"NAME\":\"test\",\"NUMBER\":\"123456789\",\"JURISDICTION\":\"example\"}}";
 
 
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
			.uri(URI.create("https://rest.netim.com/1.0/brandprotection/"))
			.method("POST", HttpRequest.BodyPublishers.ofString(body))
			.header("Content-Type", "application/json")
			.header("Accept-Language", "EN")
			.header("Authorization", "Bearer " + sessionID)
			.build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
 
        String result = response.body().toString();
    }
}
#!/usr/bin/python3
 
import json
import requests
 
url = 'https://rest.netim.com/1.0/brandprotection/'
 
sessionId = "1234567"
 
headers = {"Authorization": "Bearer " + sessionId, "Content-Type": "application/json"}
 
 
data = {
    "label":"exampleLabel",
    "prod":"ADULTBLOCK",
    "duration":"1",
    "idOwner":"IDOWN",
    "type":"ORG",
    "info": {
        "NAME":"test",
        "NUMBER":"123456789",
        "JURISDICTION":"example",
    }
}
 
response = requests.post(url, headers=headers, data=json.dumps(data))
curl -X POST https://rest.netim.com/1.0/brandprotection/ \
-H 'Authorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26=' \
-H 'Content-type: application/json' \
-d '{"label":"exampleLabel","prod":"ADULTBLOCK","duration":"1","idOwner":"IDOWN","type":"ORG","INFO":{"NAME":"test","NUMBER":"123456789","JURISDICTION":"example"}}'