Certificates

Asset Certificates Management

Get certificates for a pro asset

get

Get certificates associated with the specified pro asset

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Pro asset id

Responses

200

OK

application/json

403

Unauthorized

application/json

404

Asset not found

application/json

get

/assets/{id}/certificates

HTTPcURLJavaScriptPython

GET /api/jewellery/assets/{id}/certificates HTTP/1.1
Host: console.studio360.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "certificates": [
    {
      "lab_code": "text",
      "certificate_no": "text",
      "url": "https://example.com"
    }
  ]
}

Add new pro asset certificate

post

• Add new certificate for the pro asset

• Rate Limiting : 20 requests per minute per Token per IP address.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Pro asset id

Body

application/json

Request body to create a certificate by uploading a PDF file, an image file, or fetching it from a URL. Exactly one source must be provided.

lab_codestring · max: 64Required

Short code identifying the issuing laboratory (e.g. GIA, IGI).

certificate_nostring · max: 32Required

Unique certificate or report number issued by the lab.

file_pdfstring · byteOptional

Base64-encoded PDF certificate file (application/pdf).

file_imagestring · byteOptional

• Base64-encoded image certificate file (image/jpeg, image/png, image/jpg, image/webp).
• Extensiosn allowed: jpeg, png, jpg, webp

source_urlstring · uri · max: 256Optional

Public URL from which the certificate file (PDF or image) can be fetched.

Responses

200

Certificate created successfully

application/json

403

Unauthorized

application/json

404

Asset not found

application/json

422

Unprocessable Entity

application/json

post

/assets/{id}/certificates

HTTPcURLJavaScriptPython

POST /api/jewellery/assets/{id}/certificates HTTP/1.1
Host: console.studio360.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 124

{
  "lab_code": "text",
  "certificate_no": "text",
  "file_pdf": "Ynl0ZXM=",
  "file_image": "Ynl0ZXM=",
  "source_url": "https://example.com"
}

{
  "lab_code": "text",
  "certificate_no": "text",
  "url": "https://example.com"
}

Update existing pro asset certificate

put

Update existing certificate for the pro asset

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Pro asset id

Body

application/json

Request body to update an existing certificate identified by current lab_code and certificate_no, and replace it with new certificate details.

Responses

200

Certificate updated successfully

application/json

403

Unauthorized

application/json

404

Asset not found

application/json

422

Unprocessable Entity

application/json

put

/assets/{id}/certificates

HTTPcURLJavaScriptPython

PUT /api/jewellery/assets/{id}/certificates HTTP/1.1
Host: console.studio360.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 183

{
  "identifier": {
    "lab_code": "GIA",
    "certificate_no": "1234567890"
  },
  "certificate": {
    "lab_code": "IGI",
    "certificate_no": "IGI987654",
    "source_url": "https://www.igi.org/verify.php?r=IGI987654"
  }
}

{
  "lab_code": "text",
  "certificate_no": "text",
  "url": "https://example.com"
}

Delete existing pro asset certificate

delete

Delete existing certificate for the pro asset

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Pro asset id

Body

application/json

lab_codestring · max: 64Required

Short code identifying the issuing laboratory (e.g. GIA, IGI).

certificate_nostring · max: 32Required

Unique certificate or report number issued by the lab.

Responses

200

Certificate deleted successfully

application/json

403

Unauthorized

application/json

404

Asset not found

application/json

422

Unprocessable Entity

application/json

delete

/assets/{id}/certificates

HTTPcURLJavaScriptPython

DELETE /api/jewellery/assets/{id}/certificates HTTP/1.1
Host: console.studio360.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "lab_code": "text",
  "certificate_no": "text"
}

{
  "message": "text"
}