POST/v1/users/{user_id}/pinpage-uploads:estimate
Stable2026-04-01Try it

UploadService.EstimateUpload

EstimateUpload

Create a durable file-service estimate before reserving or signing work.

Authentication

支持组合OAuth 2.0
No identity
User identity
Org identity
所需 scopes:pinpage:upload

Request

路径参数

名称类型必填描述
user_idstringyesRequired. Owner path; accepts me or the authenticated user's identifier.

Response

200 OK · EstimateUploadResponse

字段类型必填描述
upload_estimateUploadEstimateyesRequired. Durable short-lived batch estimate; no charge has occurred.

错误响应 · google.rpc.Status

非 2xx 响应均按 AIP-193 规范包装为google.rpc.Status,含 code /message /details 三段。details[].reason 是机器可读的具体错误原因码,可用于客户端分支处理。

字段类型必填描述
codeinteger (int32)—The status code, which should be an enum value of google.rpc.Code.
messagestring—A developer-facing error message.
detailsarray<Any>—A list of messages that carry the error details.

Examples

curl -X POST \
  'https://api.appforges.com/v1/users/{user_id}/pinpage-uploads:estimate' \
  -H 'Authorization: Bearer $ACCESS_TOKEN'
OpenAPI spec v0.59.4 · synced 10/11/2026, 11:27:14 PM