Get Started

Jewellery AI Try-On API Integration Guide

 

Overview of Jewellery AI Try-On API

 

The Jewellery AI Try-On API enables partners and developers to seamlessly integrate a virtual try-on experience for jewellery products in their applications. This powerful tool uses advanced technology to create an engaging and user-friendly shopping experience, allowing customers to visualize jewellery items, such as rings, earrings, or necklaces, in real-time.

 

📌  API Details

 

          Endpoint:                        POST https://jewellery-dev.kizora.tech/en/partners/storeverify/

          Request Format:            JSON

          Response Format:         JSON

 

 

📌 API Request Parameters

   

Field	Type	Required	Description
access_key	string	✅ Yes	Unique API access key for authentication.
secret_access_key	string	✅ Yes	Secret API key for secure authentication.
product_sku	string	✅ Yes	The SKU of the jewellery product for Try-On.

 

 

📌 Sample Request

 

{
    "access_key": "0_NR88SQVPxJLrtfPgW2O6Lrc2E",
    "secret_access_key": "DtGHU_iuuhvAMbnGDEb_wZ27Bsgq9muhAp8eccQ4XaPHTLdLXOZW2w",
    "product_sku": "658"
}

 

📌 API Response

 

✅ Success Response

{
    "success": true,
    "tryon_url": "https://jewellery-dev.kizora.tech/en/abcd1f/ar/Earrings3D/658?otk=fu78nOLHGfu1PitctEE2c1rf8gugoABNHGUdXWhXOno"
}

 

❌ Error Response (Invalid Credentials)

{
    "success": false,
    "error": "Invalid access key"
}

 

📌 Best Practices

 

• Use HTTPS to secure requests.
•  
• Handle errors properly (invalid credentials, expired tokens).
•  
• Store API keys securely, never hardcode them in the frontend.
•  
• Use server-side logic to call this API, never expose it in JavaScript.

 

📌 API Integration Examples

 

✅ Python (Requests)

 

import requests

url = "https://jewellery-dev.kizora.tech/en/partners/storeverify/"
data = {
    "access_key": "0_NR88SQVPxJLrtfPgW2O6Lrc2E",
    "secret_access_key": "DtGHU_iuuhvAMbnGDEb_wZ27Bsgq9muhAp8eccQ4XaPHTLdLXOZW2w",
    "product_sku": "658"
}

response = requests.post(url, json=data)
print(response.json())  # Output Try-On URL

 

✅ Java (HttpURLConnection)

 

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import org.json.JSONObject;

public class StoreVerifyAPI {
    public static void main(String[] args) throws Exception {
        String url = "https://jewellery-dev.kizora.tech/en/partners/storeverify/";
        URL obj = new URL(url);
        HttpURLConnection con = (HttpURLConnection) obj.openConnection();
        con.setRequestMethod("POST");
        con.setRequestProperty("Content-Type", "application/json");
        con.setDoOutput(true);

        JSONObject json = new JSONObject();
        json.put("access_key", "0_NR88SQVPxJLrtfPgW2O6Lrc2E");
        json.put("secret_access_key", "DtGHU_iuuhvAMbnGDEb_wZ27Bsgq9muhAp8eccQ4XaPHTLdLXOZW2w");
        json.put("product_sku", "658");

        OutputStream os = con.getOutputStream();
        os.write(json.toString().getBytes());
        os.flush();

        BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
        String response;
        while ((response = in.readLine()) != null) {
            System.out.println(response);
        }
        in.close();
    }
}

 

✅ PHP (cURL)

 

 "0_NR88SQVPxJLrtfPgW2O6Lrc2E",
    "secret_access_key" => "DtGHU_iuuhvAMbnGDEb_wZ27Bsgq9muhAp8eccQ4XaPHTLdLXOZW2w",
    "product_sku" => "658"
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

 

✅ Node.js (Axios)

 

const axios = require('axios');

const url = "https://jewellery-dev.kizora.tech/en/partners/storeverify/";

const data = {
    access_key: "0_NR88SQVPxJLrtfPgW2O6Lrc2E",
    secret_access_key: "DtGHU_iuuhvAMbnGDEb_wZ27Bsgq9muhAp8eccQ4XaPHTLdLXOZW2w",
    product_sku: "658"
};

axios.post(url, data, { headers: { "Content-Type": "application/json" } })
    .then(response => console.log(response.data))
    .catch(error => console.error(error.response.data));

 

✅ C# (.NET HttpClient)

 

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

class Program {
    static async Task Main() {
        var url = "https://jewellery-dev.kizora.tech/en/partners/storeverify/";
        var client = new HttpClient();
        
        var requestData = new {
            access_key = "0_NR88SQVPxJLrtfPgW2O6Lrc2E",
            secret_access_key = "DtGHU_iuuhvAMbnGDEb_wZ27Bsgq9muhAp8eccQ4XaPHTLdLXOZW2w",
            product_sku = "658"
        };
        
        var json = System.Text.Json.JsonSerializer.Serialize(requestData);
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        
        var response = await client.PostAsync(url, content);
        var responseString = await response.Content.ReadAsStringAsync();
        
        Console.WriteLine(responseString);
    }
}