v2 Jobs

Mint a paid upload ticket (device-signed)

EP-048. Device-signed (ES256). A linked, paid device mints a one-time, short-TTL ticket bound server-side to {device, account, tier, byte cap}, then streams a tier-sized file to POST /api/v2/jobs/upload. This lets the web app and the extension upload files larger than the free/v1 10 MB limit, which the body-hashed v1 /jobs cannot stream. Returns eligible=false (200) for an anonymous/unlinked device or a tier at or below the free limit, so the client stays on v1 /jobs.

post/api/v2/jobs/upload-ticket

Request

  • Base URL: https://pdf2md.dev
  • URL: https://pdf2md.dev/api/v2/jobs/upload-ticket
  • Auth: HTTP bearer

Response

Ticket (eligible=true) or not eligible (eligible=false)

eligibleboolean required

true when a paid ticket was minted; false when the device is anonymous/unlinked or at/below the free limit (client uses v1 /jobs)

ticketstring

one-time ticket for the Upload-Ticket header (present only when eligible)

max_file_size_bytesinteger required

the byte cap enforced by the upload (tier limit when eligible, else the free limit)

tierstring required

the account's tier (or 'anonymous' when unlinked)

expires_in_secinteger

ticket TTL in seconds (present only when eligible)

Changes

No recorded changes to this operation across all 1 revision of this API.