Get Raw Image

Description

This API retrieves the original image associated with the specified image ID and returns the image file directly in its original format.

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

API Request & Response Guidelines

🟢 200 OK

Image Retrieved Successfully (Raw Binary)

Returned when the requested image is successfully fetched from storage and returned as a raw PNG image response.

Response type: image

This endpoint does not return JSON. Instead, it streams the image buffer directly.

🟢 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.

Description#

API Request & Response Guidelines#

🟢 200 OK#

Image Retrieved Successfully (Raw Binary)#

🟢 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