Temporarily stage a document for this application user

POST

/t1/document/uploads

const url = 'https://api.tansr.com/t1/document/uploads';
const options = {
  method: 'POST',
  headers: {'x-tansr-app-token': '<x-tansr-app-token>', 'Content-Type': 'application/json'},
  body: '{"fileName":"example","mime":"application/pdf","dataBase64":"example"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.tansr.com/t1/document/uploads \
  --header 'Content-Type: application/json' \
  --header 'x-tansr-app-token: <x-tansr-app-token>' \
  --data '{ "fileName": "example", "mime": "application/pdf", "dataBase64": "example" }'

Requires document capability. Content is held only in memory on this API instance for at most 10 minutes, with per-scope and instance limits. It is lost on restart. No provider call, quotation or charge is created. Do not automatically repeat an upload after an uncertain response. This endpoint has no durable Idempotency-Key semantics.

Authorizations

Request Body^required

application/json

object

fileName

required

string

>= 1 characters <= 200 characters /^[^\\/\u0000-\u001f\u007f]+$/

mime

required

Any of:

string

Allowed value: application/pdf

dataBase64

required

string

>= 4 characters <= 27962028 characters /^[A-Za-z0-9+/]*={0,2}$/

Responses

201

Temporary scoped reference, never file content

application/json

object

uploadRef

required

string

/^document_[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$/

expiresAt

required

string format: date-time

Example^generated

{
  "uploadRef": "example",
  "expiresAt": "2026-04-15T12:00:00Z"
}

400

Invalid file content, encoding, MIME or filename

403

Document capability not authorized

413

File or temporary storage limit exceeded

Temporarily stage a document for this application user

Authorizations

Request Bodyrequired

Responses

201

Examplegenerated

400

403

413

本文是否有帮助?

Request Body^required

Example^generated