Battery Animation App2

API Documentation

Complete reference for integrating with the Battery Animation App2. All public endpoints require an API key in the x-api-key header.

Simple & Easy

Get started in minutes with our RESTful API

Secure & Reliable

API key authentication with rate limiting

High Performance

Fast response times with optimized media delivery

Base URL

http://localhost:3000/api/v1

Authentication

Include your API key in every request header. Requests without a valid key receive a 401 response.

x-api-key: YOUR_API_KEY

Rate Limits

Default rate limit is 1,000 requests per hour per API key. Contact us for higher limits.

TierLimit
Default1,000 / hour
Starter10,000 / hour
Pro50,000 / hour
EnterpriseCustom

Available Endpoints

GET/api/v1/wallpapers
GET/api/v1/wallpapers/:id
POST/api/v1/wallpapers
PUT/api/v1/wallpapers/:id
DELETE/api/v1/wallpapers/:id
POST/api/v1/wallpapers/zip-upload
POST/api/v1/wallpapers/bulk-delete
POST/api/admin/wallpapers/reorder
GET/api/v1/animations
GET/api/v1/animations/:id
POST/api/v1/animations
PUT/api/v1/animations/:id
DELETE/api/v1/animations/:id
POST/api/v1/animations/zip-upload
POST/api/v1/animations/bulk-delete
POST/api/admin/animations/reorder
Example Request
curl -X GET "http://localhost:3000/api/v1/wallpapers" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  -G --data-urlencode "page=1" \
  --data-urlencode "per_page=10"
Example Response
JSON
{
  "success": true,
  "data": {
    "wallpapers": [
      {
        "id": "clx123abc",
        "name": "Ocean Waves Live Wallpaper",
        "url": "http://localhost:3000/uploads/wallpapers/ocean-waves.mp4",
        "fileName": "ocean-waves.mp4",
        "fileSize": 15728640,
        "format": "MP4",
        "mimeType": "video/mp4",
        "width": 1920,
        "height": 1080,
        "duration": 15.5,
        "thumbnailUrl": "http://localhost:3000/uploads/thumbnails/ocean-waves.jpg",
        "order": 1,
        "status": "Published",
        "tags": ["ocean", "waves", "live"],
        "createdAt": "2026-06-18T10:30:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "perPage": 10,
      "total": 1,
      "totalPages": 1
    }
  }
}

Need integration help? Contact support@mediacontentapi.com or try the API Explorer.