curl "https://jeterdev.tools/api/v1/listings/search?query=handmade+art&limit=10" \
  -H "x-api-key: jt_YOUR_KEY_HERE"

jt_a3f4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6

curl "https://jeterdev.tools/api/usage" \
  -H "x-api-key: jt_YOUR_KEY"

{"plan":"pro","dailyLimit":50000,"used":142,"remaining":49858,"resetsAt":"2026-05-09T00:00:00.000Z"}

X-RateLimit-Limit-Day:        50000
X-RateLimit-Remaining-Day:   49858
X-RateLimit-Reset-Day:       1746835200
X-RateLimit-Limit-Second:    10
X-RateLimit-Remaining-Second:9
X-Plan:                      pro

{
  "error": {
    "code": "RATE_LIMIT_DAILY",
    "status": 429,
    "message": "Daily request limit reached (50000/day).",
    "hint": "Limit resets at midnight UTC.",
    "docs": "https://jeterdev.tools/docs#rate-limits"
  }
}

{
  "error": {
    "code": "STORE_NOT_CONNECTED",
    "status": 403,
    "message": "Shop 61004439 is not connected.",
    "hint": "Connect the shop at jeterdev.tools/dashboard."
  }
}

{
  "error": {
    "code": "STORE_TOKEN_EXPIRED",
    "status": 403,
    "message": "Shop 61004439 OAuth token has expired and could not be refreshed. Re-link the shop to restore access.",
    "connection_expired": true,
    "hint": "Re-connect the shop at jeterdev.tools/dashboard."
  }
}

curl -X POST "https://jeterdev.tools/api/v1/uploads/presign"   -H "x-api-key: jt_YOUR_KEY"   -H "Content-Type: application/json"   -d '{"filename":"product-photo.jpg","content_type":"image/jpeg","size":15728640,"type":"image"}'

{
  "upload_id":    "jt_a1b2c3d4...",
  "upload_url":   "https://storage.googleapis.com/...?Signature=...",
  "method":       "PUT",
  "content_type": "image/jpeg",
  "expires_in":   "30min",
  "note":         "PUT your file binary to upload_url with Content-Type header"
}

# curl — empty response body on success (HTTP 200)
curl -X PUT "https://storage.googleapis.com/...?Signature=..."   -H "Content-Type: image/jpeg"   --data-binary "@/path/to/photo.jpg"

# fetch (browser / Node.js)
await fetch(upload_url, {
  method:  "PUT",
  headers: { "Content-Type": "image/jpeg" },
  body:    fileBlob,   // File, Buffer, or ReadableStream — up to 5GB
});
// Empty response body = success

curl -X POST "https://jeterdev.tools/api/v1/uploads/confirm"   -H "x-api-key: jt_YOUR_KEY"   -H "Content-Type: application/json"   -d '{"upload_id":"jt_a1b2c3d4..."}'

{
  "url":          "jt-upload://jt_a1b2c3d4...",
  "upload_id":    "jt_a1b2c3d4...",
  "filename":     "product-photo.jpg",
  "size":         15728640,
  "content_type": "image/jpeg",
  "type":         "image",
  "expires_in":   "24h"
}

const fs = require("fs");
const JT_KEY = "jt_YOUR_KEY";
const BASE   = "https://jeterdev.tools/api/v1";

async function uploadImage(filePath, filename) {
  const size = fs.statSync(filePath).size;

  // 1. Presign
  const { upload_id, upload_url } = await fetch(`${BASE}/uploads/presign`, {
    method:  "POST",
    headers: { "x-api-key": JT_KEY, "Content-Type": "application/json" },
    body:    JSON.stringify({ filename, content_type: "image/jpeg", size }),
  }).then(r => r.json());

  // 2. PUT directly to Firebase Storage
  await fetch(upload_url, {
    method:  "PUT",
    headers: { "Content-Type": "image/jpeg" },
    body:    fs.readFileSync(filePath),
  });
  // Empty response = success

  // 3. Confirm
  const { url } = await fetch(`${BASE}/uploads/confirm`, {
    method:  "POST",
    headers: { "x-api-key": JT_KEY, "Content-Type": "application/json" },
    body:    JSON.stringify({ upload_id }),
  }).then(r => r.json());

  return url; // "jt-upload://jt_..."
}

// Use in listings/create
const imageUrl = await uploadImage("./ai-product-15mb.jpg", "product.jpg");

await fetch(`${BASE}/listings/create`, {
  method:  "POST",
  headers: { "x-api-key": JT_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    state:   "draft",
    shops:   [{ shop_id: 61004439, shipping_profile_id: 289094606827, return_policy_id: 1396555302092 }],
    listing: { title: "AI Product", description: "...", taxonomy_id: 482, price: 29.99, quantity: 10, who_made: "i_did", when_made: "2020_2026" },
    images:  [{ url: imageUrl, rank: 1 }],
  }),
});

{
  "state": "publish",
  "shops": [...],
  "listing": { "title": "AI Generated Mug", ... },
  "images": [
    { "url": "jt-upload://jt_a1b2c3d4...", "rank": 1 },
    { "url": "jt-upload://jt_b2c3d4e5...", "rank": 2 }
  ]
}

{
  "state": "draft",
  "shops": [{
    "shop_id": 61004439,
    "shipping_profile_id": 289094606827,
    "return_policy_id":    1396555302092,
    "processing_profile_id": 1456101932490,
    "shop_section_id":     55308357,
    "price": 34.99
  }],
  "listing": {
    "title": "Vintage Band Tee", "description": "Premium cotton...",
    "listing_type": "physical", "taxonomy_id": 482,
    "price": 29.99, "quantity": 100,
    "who_made": "i_did", "when_made": "2020_2026",
    "tags": ["vintage tee", "band shirt"],
    "processing_min": 1, "processing_max": 3
  },
  "images": [
    { "url": "https://example.com/black-tee.jpg", "rank": 1 },
    { "url": "https://example.com/white-tee.jpg", "rank": 2 }
  ],
  "personalization": {
    "enabled": true, "is_required": false,
    "instructions": "Enter name (max 15 chars)", "max_chars": 15
  },
  "category_attributes": {
    "200":          { "value_ids": [1],    "values": ["Black"] },
    "325502675244": { "value_ids": [2668], "values": ["Short sleeve"] }
  },
  "variations": {
    "properties": [
      { "property_id": 200,         "name": "Color", "values": ["Black","White"] },
      { "property_id": 62809790533, "name": "Size", "scale_id": 17, "values": ["S","M","L"] }
    ],
    "offerings": [
      { "color": "Black", "size": "S", "price": 29.99, "quantity": 20, "sku": "BLK-S" },
      { "color": "Black", "size": "L", "price": 34.99, "quantity": 15, "sku": "BLK-L" },
      { "color": "White", "size": "M", "price": 29.99, "quantity": 25, "sku": "WHT-M" }
    ],
    "variation_images": { "property": "color", "mapping": { "Black": 0, "White": 1 } }
  }
}

{
  "error": {
    "code": "VALIDATION_FAILED", "status": 400,
    "message": "Request validation failed.",
    "fields": {
      "listing.title": "Title is required",
      "shops[0].shipping_profile_id": "Required for physical listings"
    }
  }
}

{
  "error": {
    "code": "STORE_NOT_OWNED", "status": 403,
    "message": "The following shop IDs are not connected: 61004439",
    "hint": "Connect shops at jeterdev.tools/dashboard."
  }
}

{ "job_id": "jt_...", "listing_pk": 1234567, "status": "completed", "results": [...] }

{ "error": { "code": "JOB_NOT_FOUND", "status": 404, "message": "Job 'jt_...' not found. Jobs expire after 24 hours." } }

curl -X POST "https://jeterdev.tools/api/v1/notifications/pushover" \
  -H "x-api-key: jt_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_key":  "YOUR_PUSHOVER_USER_KEY",
    "app_token": "YOUR_PUSHOVER_APP_TOKEN"
  }'

{ "success": true, "message": "Pushover connected. A test notification was sent to your device." }

curl "https://jeterdev.tools/api/v1/notifications/pushover" -H "x-api-key: jt_YOUR_KEY"

{ "configured": true, "app_token": "abcd..." }

curl -X DELETE "https://jeterdev.tools/api/v1/notifications/pushover" -H "x-api-key: jt_YOUR_KEY"