Guides

Developer guides

Practical walkthroughs built on the live Tonta upload API — from your first embed to production housekeeping.

Uploader quick start

Embed the drop-in widget or wire up a basic form that posts directly to upload.php.

  • Generate an uploader + API key
  • Allow your domain
  • Widget vs. custom form
  • Handling the JSON response
Read guide

Direct API uploads

Build your own uploader with fetch, Axios, or server-side code — no widget required.

  • Multipart requests with X-API-Key
  • Domain restriction tips
  • Multiple file uploads
  • Saving metadata alongside files
Read guide

Deleting & housekeeping

Keep storage tidy by calling delete.php with smallid or base IDs.

  • Single vs. bulk deletions
  • Handling response errors
  • Automating clean-up jobs
  • Monitoring storage quotas
Read guide

Metadata & XMP recipes

Embed searchable captions, creator credits and keywords directly into files.

  • Enabling XMP in the dashboard
  • Using xmp_* fields
  • Sample payloads for portraits & products
  • Reading metadata after download
Read guide

Video processing workflow

Offload video encoding to serverless GPUs and let the webhook update your uploader when renditions are ready.

  • Enabling video on an uploader
  • Webhook payload structure
  • Checking job status
  • Triggering downstream automations
Read guide

Troubleshooting & best practices

Diagnose common errors and make sure every uploader is production-ready.

  • 403s from domain restrictions
  • Storage limit warnings
  • Logging & monitoring
  • Safe key rotation
Read guide

Need more help?

Dive into the reference docs, or reach out if you get stuck.