Developer Guides

Practical walkthroughs that build on the live Tonta upload API.

Uploader Quick Start

Embed our drop-in widget or wire up a basic HTML form that posts directly to uploader/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 using 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 uploader/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
  • Accessing metadata after download
Read guide →

Video Processing Workflow

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

  • Modal configuration
  • 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 to our support team if you get stuck.

View Documentation Contact Support