Render Business Image

From docs
Revision as of 15:08, 21 July 2026 by Ashley DeBon (talk | contribs) (Created page with "== Render Image == === Base URL === https://apimobile.callproof.com === Endpoint === /api/image/{document_type}/{id} === Purpose === Renders a stored image by encrypted ID....")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Render Image

Base URL

https://apimobile.callproof.com

Endpoint

/api/image/{document_type}/{id}

Purpose

Renders a stored image by encrypted ID. For business cards (`document_type` = business_card), returns a resized front or back card image as a JPEG response.

HTTP Method

GET

Headers

Header Required Description
Authorization No Not required for this endpoint

Security

  • No – This route is public (outside the authenticated API middleware group). Access depends on knowing the encrypted image ID.

Parameters

Path Parameters

Parameter Type Required Description
document_type string Yes Image category. Supported value for rendering: business_card
id string Yes Encrypted image/record identifier (Laravel-encrypted business card ID)

Query Parameters

Parameter Type Required Description
type string Conditional Required for business cards. Use frontImage for the front side or backImage for the back side

Request Body

None.

Successful Response (200)

Returns the image binary (JPEG), not a JSON body.

Field Type Description
Content-Type header Typically image/jpeg
Body binary Resized business card image (max width 900, max height 500)

Error Responses

Status Code Meaning
404 Not Found – invalid/encrypted ID, missing business card, or image could not be rendered
  • 404 – Decryption failed, business card not found, or image path unavailable.