HCHeroCovers API
Image Upload Service · v1.0.0
Developer portal

Image Upload API

Upload customer vehicle photos and retrieve their hosted image URLs. Use this page to check service health, test uploads, and review the available endpoints.

Checking API status… Maximum 5 images per request 10 MB maximum per image

Test image upload

Choose up to five JPG, PNG, WebP, HEIC, or HEIF images. Files are uploaded to the configured image storage service.

↑
Choose images to test

Or drag and drop them here

Select images to begin. Only upload test images that you are permitted to use.

API quick reference

These endpoints are relative to this service's base URL.

GET /health

Checks whether the API is responding.

Response
{
  "status": "ok",
  "service": "HeroCovers Image Upload API",
  "version": "1.0.0"
}
POST /api/upload

Multipart form upload. Use the field name files[]. Maximum five images, 10 MB each.

Response
{
  "success": true,
  "count": 1,
  "fileIds": [
    "herocovers/customer-uploads/..."
  ]
}
POST /api/files

Resolve uploaded file IDs into hosted URLs.

Request
{
  "fileImageIDs": [
    "herocovers/customer-uploads/..."
  ]
}

Response
[
  {
    "fileId": "herocovers/customer-uploads/...",
    "url": "https://..."
  }
]