Logo Foto ke URL

Dokumentasi API

Akses API memerlukan langganan Pro atau Premium yang aktif. Sahkan dengan kunci API, kemudian muat naik imej ke pustaka yang sama seperti dalam Dashboard. Kuota mengikut pelan berbayar di laman web.

Imej produk

Muat naik imej

POST /api/v1/upload dengan multipart/form-data.

Parameter

Authorization
Wajib. Pengepala permintaan. Format: Bearer KUNCI_API_ANDA.
file
Wajib. Fail binari atau data base64.
name
Pilihan. Nama fail; dikesan secara automatik semasa muat naik multipart tempatan.

Contoh permintaan

Fail binari

curl https://phototourl.com/api/v1/upload \
  -X POST \
  -H "Authorization: Bearer ptu_live_YOUR_KEY" \
  -F "file=@./product.jpg"

Base64

curl https://phototourl.com/api/v1/upload \
  -X POST \
  -H "Authorization: Bearer ptu_live_YOUR_KEY" \
  -F "file=R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7" \
  -F "name=pixel.gif"

Untuk memuat naik fail tempatan, sentiasa gunakan POST. GET tidak disokong.

Medan respons

id
Id sumber dalam pustaka anda.
url
URL CDN untuk halaman produk.
fileName
Nama fail asal.
fileSize
Saiz fail dalam bait.
mimeType
Jenis MIME fail yang dimuat naik.
createdAt
Masa muat naik dalam UTC, format YYYY-MM-DD HH:mm:ss.
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "url": "https://cdn.phototourl.com/pro/2026-11-05-a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg",
  "fileName": "product.jpg",
  "fileSize": 128472,
  "mimeType": "image/jpeg",
  "createdAt": "2026-11-05 10:20:30"
}

Senaraikan imej

GET /api/v1/images dengan page dan pageSize pilihan (maks. 100).

curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \
  -H "Authorization: Bearer ptu_live_YOUR_KEY"

Medan respons

resources
Array imej: id, fileName, url, fileSize, mimeType, createdAt.
page
Nombor halaman semasa.
pageSize
Item setiap halaman.
total
Jumlah imej dalam pustaka.
{
  "resources": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "fileName": "product.jpg",
      "url": "https://cdn.phototourl.com/pro/2026-11-05-a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg",
      "fileSize": 128472,
      "mimeType": "image/jpeg",
      "createdAt": "2026-11-05 10:20:30"
    }
  ],
  "page": 1,
  "pageSize": 20,
  "total": 1
}

Padam imej

DELETE /api/v1/images/:id. Membuang fail dari storan dan pustaka anda.

curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \
  -H "Authorization: Bearer ptu_live_YOUR_KEY"

Medan respons

success
true apabila imej telah dipadam.
{ "success": true }

Had

API tidak tersedia pada Free. Pro dan Premium menggunakan had muat naik, storan dan saiz fail pelan anda. Apabila melebihi had, API memulangkan ralat dengan upgradeUrl.

Ralat

Permintaan gagal memulangkan kod ralat. Ralat kuota mungkin termasuk upgradeUrl.

  • dailyLimitReached— Had muat naik harian dicapai (HTTP 429).
  • storageLimitReached— Kuota storan melebihi (HTTP 413).
  • fileTooLarge— Fail lebih besar daripada yang dibenarkan pelan (HTTP 400).
  • 401— Kunci API tiada, tidak sah atau dibatalkan.
{
  "error": "dailyLimitReached",
  "errorParams": { "limit": 1000 },
  "plan": "paid",
  "limit": 1000,
  "upgradeUrl": "https://www.phototourl.com/pricing"
}