Get Raw Image in Base64 Format

Description

This API retrieves the original image that was previously uploaded through the Upload/Process API and returns it in Base64 format.

This API is rate-limited to 100 requests per minute per user.

API Request & Response Guidelines

🟢 200 OK

Image Base64 Retrieved Successfully

Returned when the requested image is successfully fetched from storage and converted into a Base64 string.

{
  "status": true,
  "message": "",
  "data": "iVBORw0KGgoAAAANSUhEUgAA..."
}

The data field contains the Base64-encoded representation of the image.

🟢 200 OK (Business Validation Errors)

Invalid or Missing Pic ID

Returned when the requested picID does not exist or does not belong to the authenticated user.

{
  "status": false,
  "message": "Authentication Error: Pic Not Found",
  "data": ""
}

File Not Found / Missing Image

Returned when the image exists in DB but file is missing in storage or fallback image is used.

{
  "status": false,
  "message": "The specified key does not exist.",
  "data": ""
}

Internal File Read Failure

Returned when the system fails to read local fallback file (no_file_found.png).

{
  "status": false,
  "message": "<error reading local file>",
  "data": ""
}

Invalid Input

Returned when picID is missing or invalid.

{
  "status": false,
  "message": "Pic ID is required",
  "data": ""
}

🟠 401 Unauthorized

Missing or Invalid Authorization

Returned when:

Authorization header is missing

API key is invalid

API key is not associated with a user

{
  "status": false,
  "message": "You are not Authorized"
}

🟠 429 Too Many Requests

Returned when the request limit is exceeded.

Limit:

100 requests per minute per user/API key

{
  "status": false,
  "message": "Rate limit exceeded."
}

🔴 500 Internal Server Error

Unexpected Server Error

Returned when an unexpected error occurs outside normal validation flow.

{
  "status": false,
  "message": "Service unavailable"
}

Generic format:

{
  "status": false,
  "message": "<error message>"
}

Important Note

Consumers of this API should not rely solely on the HTTP status code. Some validation and business-rule failures may return HTTP 200 OK with "status": false in the response body. Always inspect the status field to determine whether the operation succeeded.

{ "status": true, "message": "", "data": "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

Get Raw Image in Base64 Format

Description#

API Request & Response Guidelines#

🟢 200 OK#

Image Base64 Retrieved Successfully#

🟢 200 OK (Business Validation Errors)#

Invalid or Missing Pic ID#

File Not Found / Missing Image#

Internal File Read Failure#

Invalid Input#

🟠 401 Unauthorized#

Missing or Invalid Authorization#

🟠 429 Too Many Requests#

🔴 500 Internal Server Error#

Unexpected Server Error#

Important Note#

Request

Responses