Barcode to Stone ID

​

Overview

• Rough stones → Send only the base code (e.g., ABCD).
• Split/Polished stones → Append the part suffix (e.g., .1, .2) to indicate the derived stone.

​

Flow

​

API Reference

​

Endpoint

GET https://example.com/your-end-point?barcode={barcode}

​

Headers (if any)

secret-key: <your-api-key>
Accept: application/json
Content-Type: application/json

​

Request Example

GET https://example.com/your-end-point?barcode=165165165
secret-key: sk_test_123456
Accept: application/json
Content-Type: application/json

​

Successful Response

{
  "stoneId": "ABCD.1"
}

​

Error Response

{
  "error": "Invalid barcode or stone not found"
}

​

Integration Notes

• Rough stones return only the base (e.g., ABCD).
• Split stones return the part suffix (e.g., ABCD.1, ABCD.2).

​

🛠️ Support