TPW Developer Platform

Overview

This API allows you to process data and update user credits based on specific parameters. It performs calculations and returns the results along with the updated credit information.

Steps to Use

Set up your environment by including the necessary API dependencies.

Write your API request using the specified endpoint and parameters.

Send the API request and handle the response data accordingly.

Endpoint

POST /getItem

Request

Headers

Content-Type: application/json

Body Parameters

projectCode (string): The project code.
product: 1 Perfume, 2 Oil perfume, 3 Liquid Soap, etc.
limit (integer): The material limit.
type: Different kit or material types, Available options:
TEC026 - FTECkit

FLR026 - Perfumery Training Kit

ALLRMS - All Materials

NOBASE - All Materials without Fleuressence or FTEC Bases

ALLNAT - Natural Materials Only

FLR164 - Fleuressence Base

TEC164 - KFTEC164
key (string): Description of the perfume.
quantity (integer): Quantity value.
auth (string): Authentication token.

Example Request

{
    "projectCode": "tpw-api",
    "product": "1",
    "type": "TEC164",
    "key": "jasmin green fresh",
    "limit": "20",
    "quantity": 100
}

Example Usage

Use response access token from Authentication Token API

curl --location "https://www.perfumersworld.com/genFormula/getItem" \
            --header "Content-Type: application/json" \
            --header "Authorization: Bearer <access_token>" \
            --data "{
            \"projectCode\": \"tpw-api\",
            \"product\": \"1\",
            \"type\": \"TEC164\",
            \"key\": \"jasmin green fresh\",
            \"limit\": \"20\",
            \"quantity\": 100
            }"

fetch('https://www.perfumersworld.com/genFormula/getItem', {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/json'
                    'Authorization': 'Bearer <access_token>'
                },
                body: JSON.stringify({
                    projectCode: 'tpw-api',
                    product: '1',
                    limit: 12,
                    type: 'TEC164',
                    key: 'jasmin green fresh',
                    quantity: 100
                })
            })
            .then(response => response.json())
            .then(data => console.log(data))
            .catch(error => console.error('Error:', error));


$url = 'https://www.perfumersworld.com/genFormula/getItem';
$data = [
    "projectCode" => "tpw-api",
    "product" => "1",
    "type" => "TEC164",
    "key" => "jasmin green fresh",
    "limit" => "20",
    "quantity" => 100
];

$options = [
    'http' => [
        'header'  => [
            "Content-Type: application/json",
            "Authorization: Bearer <access_token>"
        ],
        'method'  => 'POST',
        'content' => json_encode($data),
    ],
];

$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);

if ($result === FALSE) {
    // Handle error
    echo "Error occurred";
}

echo $result;


import requests
import json

url = 'https://www.perfumersworld.com/genFormula/getItem'
headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <access_token>'
}
data = {
    "projectCode": "tpw-api",
    "product": "1",
    "type": "TEC164",
    "key": "jasmin green fresh",
    "limit": "20",
    "quantity": 100
}

response = requests.post(url, headers=headers, data=json.dumps(data))

if response.status_code == 200:
    print(response.json())
else:
    print(f'Error: {response.status_code}, {response.text}')

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

class Program
{
    static async Task Main(string[] args)
    {
        var url = "https://www.perfumersworld.com/genFormula/getItem";
        var data = new
        {
            projectCode = "tpw-api",
            product = "1",
            type = "TEC164",
            key = "jasmin green fresh",
            limit = "20",
            quantity = 100
        };

        var json = Newtonsoft.Json.JsonConvert.SerializeObject(data);
        var content = new StringContent(json, Encoding.UTF8, "application/json");

        using (var client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", "Bearer <access_token>");

            var response = await client.PostAsync(url, content);

            if (response.IsSuccessStatusCode)
            {
                var responseString = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseString);
            }
            else
            {
                Console.WriteLine($"Error occurred: {response.StatusCode}");
            }
        }
    }
}

How to Run This Shell Script on Linux or MacOS:

Download shell script linux

Open a terminal.
Navigate to the directory where the script is located using the cd /path/to/your/directory command.
Open the shell script for replace the access_token with your token.
Make the script executable by running the command: chmod +x run_curl.sh
Execute the script by running the command: ./run_curl.sh

Video Demo

How to Run This Batch File on Windows:

Download batch file windows

Open Command Prompt.
Navigate to the directory where the batch file is located using the cd /path/to/your/directory command.
Open the batch file for replace the access_token with your token.
Execute the batch file by running the command: run_curl.bat

Video Demo

Response

Success Response

Status Code: 200 OK
Content-Type: application/json
Body:

{
    "responseDate": "12-01-2025 20:16:10",
    "statusCode": "000",
    "credit": "956",
    "message": {
        "data": [
            {
                "name": "JASMINE PETAL F-TEC ",
                "sku": "6JJ18250",
                "family": "J",
                "abcs": "Jl",
                "price": "0.12",
                "qtn": "34.65",
                "impact": "100",
                "limitFra": "50",
                "DoseFraMax": "50",
                "life": "91.2",
                "ClassA": 5,
                "ClassB": 0,
                "ClassC": 2,
                "ClassD": 0,
                "ClassE": 0,
                "ClassF": 7,
                "ClassG": 4,
                "ClassH": 6,
                "ClassI": 0,
                "ClassJ": 36,
                "ClassK": 0,
                "ClassL": 22,
                "ClassM": 0,
                "ClassN": 6,
                "ClassO": 7,
                "ClassP": 0,
                "ClassQ": 0,
                "ClassR": 0,
                "ClassS": 1,
                "ClassT": 0,
                "ClassU": 2,
                "ClassV": 0,
                "ClassW": 0,
                "ClassX": 0,
                "ClassY": 0,
                "ClassZ": 1
            },
            {
                "name": "JASMIN FRUIT F-TEC ",
                "sku": "6JL18251",
                "family": "J",
                "abcs": "Jf",
                "price": "0.12",
                "qtn": "27.31",
                "impact": "120",
                "limitFra": "25",
                "DoseFraMax": "25",
                "life": "50",
                "ClassA": 0,
                "ClassB": 0,
                "ClassC": 0,
                "ClassD": 0,
                "ClassE": 0,
                "ClassF": 15,
                "ClassG": 0,
                "ClassH": 0,
                "ClassI": 0,
                "ClassJ": 80,
                "ClassK": 0,
                "ClassL": 0,
                "ClassM": 0,
                "ClassN": 5,
                "ClassO": 0,
                "ClassP": 0,
                "ClassQ": 0,
                "ClassR": 0,
                "ClassS": 0,
                "ClassT": 0,
                "ClassU": 0,
                "ClassV": 0,
                "ClassW": 0,
                "ClassX": 0,
                "ClassY": 0,
                "ClassZ": 0
            },
            {
                "name": "JASMIN ABS F-TEC ",
                "sku": "6JN19189",
                "family": "J",
                "abcs": "Jn",
                "price": "0.15",
                "qtn": "16.85",
                "impact": "100",
                "limitFra": "50",
                "DoseFraMax": "50",
                "life": "45",
                "ClassA": 0,
                "ClassB": 0,
                "ClassC": 0,
                "ClassD": 0,
                "ClassE": 0,
                "ClassF": 0,
                "ClassG": 0,
                "ClassH": 0,
                "ClassI": 0,
                "ClassJ": 60,
                "ClassK": 0,
                "ClassL": 0,
                "ClassM": 0,
                "ClassN": 40,
                "ClassO": 0,
                "ClassP": 0,
                "ClassQ": 0,
                "ClassR": 0,
                "ClassS": 0,
                "ClassT": 0,
                "ClassU": 0,
                "ClassV": 0,
                "ClassW": 0,
                "ClassX": 0,
                "ClassY": 0,
                "ClassZ": 0
            },
            {
                "name": "GREEN TEA F-TEC",
                "sku": "6EG18166",
                "family": "E",
                "abcs": "Lg",
                "price": "0.25",
                "qtn": "12.99",
                "impact": "100",
                "limitFra": "50",
                "DoseFraMax": "50",
                "life": "8.9",
                "ClassA": 0,
                "ClassB": 0,
                "ClassC": 1,
                "ClassD": 0,
                "ClassE": 1,
                "ClassF": 1,
                "ClassG": 9,
                "ClassH": 3,
                "ClassI": 0,
                "ClassJ": 7,
                "ClassK": 0,
                "ClassL": 10,
                "ClassM": 0,
                "ClassN": 0,
                "ClassO": 3,
                "ClassP": 0,
                "ClassQ": 0,
                "ClassR": 3,
                "ClassS": 8,
                "ClassT": 0,
                "ClassU": 0,
                "ClassV": 0,
                "ClassW": 0,
                "ClassX": 1,
                "ClassY": 0,
                "ClassZ": 53
            },
            {
                "name": "G-GREEN F-TEC ",
                "sku": "6GG18012",
                "family": "G",
                "abcs": "Gz",
                "price": "0.18",
                "qtn": "8.19",
                "impact": "150",
                "limitFra": "50",
                "DoseFraMax": "50",
                "life": "181.6",
                "ClassA": 0,
                "ClassB": 1,
                "ClassC": 0,
                "ClassD": 0,
                "ClassE": 0,
                "ClassF": 1,
                "ClassG": 86,
                "ClassH": 1,
                "ClassI": 1,
                "ClassJ": 0,
                "ClassK": 0,
                "ClassL": 1,
                "ClassM": 2,
                "ClassN": 0,
                "ClassO": 0,
                "ClassP": 0,
                "ClassQ": 0,
                "ClassR": 0,
                "ClassS": 0,
                "ClassT": 0,
                "ClassU": 0,
                "ClassV": 0,
                "ClassW": 2,
                "ClassX": 0,
                "ClassY": 0,
                "ClassZ": 5
            }
        ],
        "total": 100
    }
}

Error Response

Status Code: 500 Internal Server Error
Content-Type: application/json
Body:

{
    "error": "Error updating record: <error_message>"
}

Status Code: A002
Content-Type: application/json
Body:

{
    "responseDate": "04-01-2025 16:20:15",
    "statusCode": "A002",
    "message": "Token keyword is not match or missing"
}

Status Code: E002
Content-Type: application/json
Body:

{
    "responseDate": "04-01-2025 16:22:33",
    "statusCode": "E002",
    "message": "Empty Request body or IS_REQUIRE(Information)"
}

Get Started

Capabilities

TPW Developer Platform

Overview

Steps to Use

Endpoint

Request

Headers

Body Parameters

Example Request

Example Usage

How to Run This Shell Script on Linux or MacOS:

Video Demo

How to Run This Batch File on Windows:

Video Demo

Response

Success Response

Error Response