Developer Integration & API Reference

// Android Kotlin Example (Coroutines & OkHttp)
suspend fun fetchDynamicPrices(accessToken: String, productIds: List<String>): List<PricingResult> = withContext(Dispatchers.IO) {
    val jsonBody = JSONObject().apply {
        put("context", JSONObject().apply {
            put("merchant_id", "YOUR_MERCHANT_UUID")
            put("campaign_id", "YOUR_CAMPAIGN_UUID")
            put("customer_id", getAppUserIdOrDeviceId())
            put("products", JSONArray(productIds.map { JSONObject().put("product_id", it) }))
        })
    }
    val request = Request.Builder()
        .url("https://api.pricient.co/multi_request_price/")
        .addHeader("Authorization", "Bearer $accessToken")
        .post(jsonBody.toString().toRequestBody("application/json".toMediaType()))
        .build()
    
    val response = okHttpClient.newCall(request).execute()
    parsePricingResults(response.body?.string())
}

// React Native Example
export async function getDynamicPrices(accessToken, productIds) {
  const response = await fetch('https://api.pricient.co/multi_request_price/', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${accessToken}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      context: {
        merchant_id: 'YOUR_MERCHANT_UUID',
        campaign_id: 'YOUR_CAMPAIGN_UUID',
        customer_id: await AsyncStorage.getItem('user_id'),
        products: productIds.map(id => ({ product_id: id }))
      }
    })
  });
  const data = await response.json();
  return data.results;
}

const response = await fetch('https://api.pricient.co/get_public_token/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    api_key: 'YOUR_MERCHANT_API_KEY'
  })
});

const data = await response.json();
console.log('Access Token:', data.access_token);
// Store token for subsequent pricing requests

const axios = require('axios');

async function getAccessToken(apiKey) {
  const { data } = await axios.post('https://api.pricient.co/get_public_token/', {
    api_key: apiKey
  });
  return data.access_token;
}

import requests

url = "https://api.pricient.co/get_public_token/"
payload = {"api_key": "YOUR_MERCHANT_API_KEY"}

response = requests.post(url, json=payload)
data = response.json()
access_token = data.get("access_token")
print("Access Token:", access_token)

// Swift / iOS
let url = URL(string: "https://api.pricient.co/get_public_token/")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
let payload = ["api_key": "YOUR_MERCHANT_API_KEY"]
request.httpBody = try JSONSerialization.data(withJSONObject: payload)

let (data, _) = try await URLSession.shared.data(for: request)
if let json = try JSONSerialization.jsonObject(with: data) as? [String: Any],
   let token = json["access_token"] as? String {
    print("Access Token: \(token)")
}

// Android / Kotlin (OkHttp & Coroutines)
suspend fun fetchAccessToken(apiKey: String): String? = withContext(Dispatchers.IO) {
    val json = JSONObject().put("api_key", apiKey).toString()
    val request = Request.Builder()
        .url("https://api.pricient.co/get_public_token/")
        .post(json.toRequestBody("application/json".toMediaType()))
        .build()
    val response = okHttpClient.newCall(request).execute()
    val responseBody = response.body?.string()
    JSONObject(responseBody ?: "{}").optString("access_token")
}

const res = await fetch('https://api.pricient.co/request_price/', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    context: {
      merchant_id: "b64aa6bd-379c-4155-828e-ce7a3fa59f5b",
      campaign_id: "a69453b6-77ef-446d-808d-fe7f9738f01f",
      product_id: "0b74233e-80ef-4dfc-9b2b-3f4d8bd87eda",
      customer_id: "cust_sess_9a87d12f"
    }
  })
});

const { request_id, final_price, original_price } = await res.json();
console.log(`Optimized price: $${final_price} (Original: $${original_price})`);

// Node.js / SSR
const axios = require('axios');

async function getPrice(token, context) {
  const response = await axios.post('https://api.pricient.co/request_price/', 
    { context }, 
    { headers: { Authorization: `Bearer ${token}` } }
  );
  return response.data;
}

import requests

headers = {"Authorization": f"Bearer {access_token}"}
payload = {
    "context": {
        "merchant_id": "b64aa6bd-379c-4155-828e-ce7a3fa59f5b",
        "campaign_id": "a69453b6-77ef-446d-808d-fe7f9738f01f",
        "product_id": "0b74233e-80ef-4dfc-9b2b-3f4d8bd87eda",
        "customer_id": "cust_sess_9a87d12f"
    }
}

r = requests.post("https://api.pricient.co/request_price/", json=payload, headers=headers)
data = r.json()
print("Returned Price:", data["final_price"])
print("Tracking Request ID:", data["request_id"])

// Swift / iOS
let url = URL(string: "https://api.pricient.co/request_price/")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer \(accessToken)", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")

let payload: [String: Any] = [
    "context": [
        "merchant_id": "b64aa6bd-379c-4155-828e-ce7a3fa59f5b",
        "campaign_id": "a69453b6-77ef-446d-808d-fe7f9738f01f",
        "product_id": "0b74233e-80ef-4dfc-9b2b-3f4d8bd87eda",
        "customer_id": "cust_sess_9a87d12f"
    ]
]
request.httpBody = try JSONSerialization.data(withJSONObject: payload)
let (data, _) = try await URLSession.shared.data(for: request)

// Android / Kotlin (OkHttp & Coroutines)
suspend fun fetchSinglePrice(accessToken: String, productId: String, customerId: String): PricingResult = withContext(Dispatchers.IO) {
    val json = JSONObject().apply {
        put("context", JSONObject().apply {
            put("merchant_id", "YOUR_MERCHANT_UUID")
            put("campaign_id", "YOUR_CAMPAIGN_UUID")
            put("product_id", productId)
            put("customer_id", customerId)
        })
    }.toString()
    val request = Request.Builder()
        .url("https://api.pricient.co/request_price/")
        .addHeader("Authorization", "Bearer $accessToken")
        .post(json.toRequestBody("application/json".toMediaType()))
        .build()
    val response = okHttpClient.newCall(request).execute()
    parsePricingResult(response.body?.string())
}

const res = await fetch('https://api.pricient.co/multi_request_price/', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    context: {
      merchant_id: "b64aa6bd-379c-4155-828e-ce7a3fa59f5b",
      campaign_id: "a69453b6-77ef-446d-808d-fe7f9738f01f",
      customer_id: "cust_sess_9a87d12f",
      products: [
        { product_id: "0b74233e-80ef-4dfc-9b2b-3f4d8bd87eda" },
        { product_id: "681a0ed6-01c5-4b53-a84a-dbc879ef06f0" }
      ]
    }
  })
});
const { results } = await res.json();
results.forEach(item => {
  console.log(`Product ${item.product_identifier} -> Price: $${item.final_price}`);
});

// Node.js / Next.js Server-Side Call (Zero-Flicker)
import axios from 'axios';

export async function fetchCatalogPrices(customerId, productIds) {
  const { data } = await axios.post('https://api.pricient.co/multi_request_price/', {
    context: {
      merchant_id: process.env.PRICIENT_MERCHANT_ID,
      campaign_id: process.env.PRICIENT_CAMPAIGN_ID,
      customer_id: customerId,
      products: productIds.map(id => ({ product_id: id }))
    }
  }, {
    headers: { Authorization: `Bearer ${process.env.PRICIENT_API_KEY}` }
  });
  return data.results;
}

import requests

payload = {
    "context": {
        "merchant_id": "b64aa6bd-379c-4155-828e-ce7a3fa59f5b",
        "campaign_id": "a69453b6-77ef-446d-808d-fe7f9738f01f",
        "customer_id": "cust_sess_9a87d12f",
        "products": [
            {"product_id": "0b74233e-80ef-4dfc-9b2b-3f4d8bd87eda"},
            {"product_id": "681a0ed6-01c5-4b53-a84a-dbc879ef06f0"}
        ]
    }
}
r = requests.post("https://api.pricient.co/multi_request_price/", json=payload, headers={"Authorization": f"Bearer {access_token}"})
print(r.json())

// Swift / iOS
let url = URL(string: "https://api.pricient.co/multi_request_price/")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer \(accessToken)", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")

let payload: [String: Any] = [
    "context": [
        "merchant_id": "b64aa6bd-379c-4155-828e-ce7a3fa59f5b",
        "campaign_id": "a69453b6-77ef-446d-808d-fe7f9738f01f",
        "customer_id": "cust_sess_9a87d12f",
        "products": [
            ["product_id": "0b74233e-80ef-4dfc-9b2b-3f4d8bd87eda"],
            ["product_id": "681a0ed6-01c5-4b53-a84a-dbc879ef06f0"]
        ]
    ]
]
request.httpBody = try JSONSerialization.data(withJSONObject: payload)
let (data, _) = try await URLSession.shared.data(for: request)

// Android / Kotlin (OkHttp & Coroutines)
suspend fun fetchBulkPrices(accessToken: String, productIds: List<String>, customerId: String): List<PricingResult> = withContext(Dispatchers.IO) {
    val json = JSONObject().apply {
        put("context", JSONObject().apply {
            put("merchant_id", "YOUR_MERCHANT_UUID")
            put("campaign_id", "YOUR_CAMPAIGN_UUID")
            put("customer_id", customerId)
            put("products", JSONArray(productIds.map { JSONObject().put("product_id", it) }))
        })
    }.toString()
    val request = Request.Builder()
        .url("https://api.pricient.co/multi_request_price/")
        .addHeader("Authorization", "Bearer $accessToken")
        .post(json.toRequestBody("application/json".toMediaType()))
        .build()
    val response = okHttpClient.newCall(request).execute()
    parsePricingResults(response.body?.string())
}

const res = await fetch('https://api.pricient.co/record_purchase/', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    request_id: storedRequestId,
    purchased: true
  })
});
const data = await res.json();
console.log('Purchase recorded:', data.message);

// Node.js / SSR
const axios = require('axios');

async function logPurchase(token, requestId) {
  const { data } = await axios.post('https://api.pricient.co/record_purchase/', {
    request_id: requestId,
    purchased: true
  }, {
    headers: { Authorization: `Bearer ${token}` }
  });
  return data;
}

import requests

payload = {
    "request_id": "681a0ed6-01c5-4b53-a84a-dbc879ef06f0",
    "purchased": True
}
r = requests.post("https://api.pricient.co/record_purchase/", json=payload, headers={"Authorization": f"Bearer {access_token}"})
print(r.json())

// Swift / iOS
let url = URL(string: "https://api.pricient.co/record_purchase/")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer \(accessToken)", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")

let payload: [String: Any] = [
    "request_id": storedRequestId,
    "purchased": true
]
request.httpBody = try JSONSerialization.data(withJSONObject: payload)
let (data, _) = try await URLSession.shared.data(for: request)

// Android / Kotlin (OkHttp & Coroutines)
suspend fun logPurchase(accessToken: String, requestId: String): Boolean = withContext(Dispatchers.IO) {
    val json = JSONObject().apply {
        put("request_id", requestId)
        put("purchased", true)
    }.toString()
    val request = Request.Builder()
        .url("https://api.pricient.co/record_purchase/")
        .addHeader("Authorization", "Bearer $accessToken")
        .post(json.toRequestBody("application/json".toMediaType()))
        .build()
    val response = okHttpClient.newCall(request).execute()
    response.isSuccessful
}

const res = await fetch('https://api.pricient.co/multi_record_purchase/', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    campaign_id: "a69453b6-77ef-446d-808d-fe7f9738f01f",
    items: [
      { request_id: "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d", purchased: true, quantity: 1 },
      { request_id: "f6e5d4c3-b2a1-0f9e-8d7c-6b5a4f3e2d1c", purchased: true, quantity: 2 }
    ]
  })
});
const data = await res.json();
console.log('Purchases recorded:', data.message);

// Node.js / SSR
const axios = require('axios');

async function logCartPurchases(token, campaignId, items) {
  const { data } = await axios.post('https://api.pricient.co/multi_record_purchase/', {
    campaign_id: campaignId,
    items: items
  }, {
    headers: { Authorization: `Bearer ${token}` }
  });
  return data;
}

import requests

payload = {
    "campaign_id": "a69453b6-77ef-446d-808d-fe7f9738f01f",
    "items": [
        {"request_id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d", "purchased": True, "quantity": 1},
        {"request_id": "f6e5d4c3-b2a1-0f9e-8d7c-6b5a4f3e2d1c", "purchased": True, "quantity": 2}
    ]
}
r = requests.post("https://api.pricient.co/multi_record_purchase/", json=payload, headers={"Authorization": f"Bearer {access_token}"})
print(r.json())

// Swift / iOS
let url = URL(string: "https://api.pricient.co/multi_record_purchase/")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer \(accessToken)", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")

let payload: [String: Any] = [
    "campaign_id": "a69453b6-77ef-446d-808d-fe7f9738f01f",
    "items": [
        ["request_id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d", "purchased": true, "quantity": 1],
        ["request_id": "f6e5d4c3-b2a1-0f9e-8d7c-6b5a4f3e2d1c", "purchased": true, "quantity": 2]
    ]
]
request.httpBody = try JSONSerialization.data(withJSONObject: payload)
let (data, _) = try await URLSession.shared.data(for: request)

// Android / Kotlin (OkHttp & Coroutines)
suspend fun logCartPurchases(accessToken: String, campaignId: String, items: List<CartPurchaseItem>): Boolean = withContext(Dispatchers.IO) {
    val itemsArray = JSONArray().apply {
        items.forEach { item ->
            put(JSONObject().apply {
                put("request_id", item.requestId)
                put("purchased", true)
                put("quantity", item.quantity)
            })
        }
    }
    val json = JSONObject().apply {
        put("campaign_id", campaignId)
        put("items", itemsArray)
    }.toString()
    val request = Request.Builder()
        .url("https://api.pricient.co/multi_record_purchase/")
        .addHeader("Authorization", "Bearer $accessToken")
        .post(json.toRequestBody("application/json".toMediaType()))
        .build()
    val response = okHttpClient.newCall(request).execute()
    response.isSuccessful
}