跳至主要内容

錯誤參考

這是 Kaleidr 平台 API 的完整錯誤清單。每個錯誤都包含 HTTP 狀態碼和一個錯誤代碼，後者是供程式進行分支處理的簡短、穩定字串。僅憑 HTTP 狀態碼並不足夠。403 可能有多種不同原因；429 既可能表示“降低要求頻率”，也可能表示“額度已耗盡”。

先瞭解回應結構，因為錯誤代碼並不總是在同一個欄位中。

回應格式​

結構示例適用情況
包裝後的錯誤代碼{"detail": "origin_not_allowed"}幾乎所有 401、403、404、413、500 和 503 錯誤、422 要求限制錯誤代碼，以及兩種 429 錯誤（map_load_quota_exceeded 和上傳 API 的 ingest_rate_limited）。錯誤代碼是 detail 字串。
扁平物件{"error": "rate_limited", "detail": "API key rate limit exceeded. Slow down."}其他所有 429 錯誤。程式碼位於 error，detail 是面向使用者的說明。額度錯誤還會包含其他欄位。
驗證清單{"detail": [{"loc": ["body", "product"], "msg": "…", "type": "…"}]}要求本文或查詢參數格式錯誤時的 422 回應。detail 是數組，每個問題對應一項。
HTTP 200 中的錯誤{"error": "Route planning failed."}僅適用於 POST /chat/control/route。請參見下文。

下面的函數可以從以上任意結構中讀取錯誤代碼：

async function kaleidrError(res) {
  const body = await res.json().catch(() => ({}));
  const code =
    typeof body.error === 'string' ? body.error :      // flat 429
    typeof body.detail === 'string' ? body.detail :    // wrapped code
    Array.isArray(body.detail) ? 'validation_error' :  // 422
    'unknown_error';
  return { status: res.status, code, body, retryAfter: Number(res.headers.get('retry-after')) || null };
}

需要關注兩個回應標頭：429 回應中的 Retry-After（以秒為單位），以及可選的 X-Request-Id，後者可在聯繫支援團隊時識別要求。

身分驗證：401​

API 不接受此身分憑證。

錯誤代碼觸發條件處理方式
Invalid or missing API key沒有傳送身分憑證，或者金鑰未知、已撤銷或已過期。也可能是：工作階段權杖已過期；工作階段關聯的金鑰被撤銷或在沒有寬限期的情況下輪替；金鑰中已移除該工作階段的來源或產品；工作階段是在方案降級前簽發的；組織被暫停或沒有方案。在 kaleidr.com/api-keys 檢查金鑰及其狀態。如果是工作階段，請重新交換權杖。若有效金鑰持續失敗，請稍後重新嘗試：短暫的平台故障也可能回傳此錯誤。
publishable_requires_session將可公開使用的金鑰（kld_pk_…）傳送到了運行時端點。在瀏覽器中讓 SDK 執行交換，或先呼叫 POST /sdk/sessions。在後端使用伺服器金鑰。

授權：403​

API 已識別身分憑證，但拒絕此要求。

錯誤代碼觸發條件處理方式
insufficient_scope金鑰建立時沒有授予此端點或產品所需的權限範圍。使用具有所需權限範圍的金鑰。不能向現有金鑰新增權限範圍。
tier_capability_not_allowed金鑰具有相應權限範圍或產品，但組織的目前方案不包含它。若已發布地圖的所有者方案不含聊天功能，也會回傳此錯誤。但 vendor 例外：低於 Enterprise 方案的金鑰即使仍帶有 vendor 也不會被拒絕，只是回答不會使用組織資料。更換方案，或使用目前方案包含的產品。
server_key_in_browser伺服器金鑰（kld_sk_…）隨 Origin 要求標頭傳送。將呼叫移到後端。如果金鑰曾出現在頁面原始碼中，請輪替該金鑰。
session_origin_mismatch工作階段權杖被用於與簽發來源不同的來源，或者在未提供 Origin 的情況下使用已發布地圖的工作階段。在實際使用工作階段的頁面上重新交換。
ip_not_allowed帶有 IP 允許清單的伺服器金鑰或舊版金鑰從清單外的地址發起呼叫，或無法確定呼叫者地址。從允許的地址呼叫，或修改金鑰的 allowed_ips。
publishable_key_required使用伺服器金鑰或舊版金鑰呼叫了 POST /sdk/sessions。使用可公開使用的金鑰進行交換。
origin_required工作階段交換要求缺少 Origin 要求標頭。從瀏覽器頁面執行交換。
origin_not_allowed頁面來源不在金鑰允許的來源清單內，或不在已發布地圖允許的網域清單內。將準確的來源新增到金鑰，或將網域新增到地圖。
product_not_allowed金鑰僅允許某些產品，而要求針對其他產品。在工作階段交換時：要求的 product 不在可公開使用的金鑰的允許產品中。在運行時：伺服器金鑰或舊版金鑰呼叫了不被允許的產品端點，例如僅允許 tile 的金鑰呼叫 /chat/*。修改 allowed_products，或使用其他金鑰。
chat_disabled已發布地圖的工作階段交換：地圖的 Kaleidr AI 未開啓所請求的功能。在 Studio 中地圖的 Kaleidr AI 圖塊裡開啓 Control Tower 或 Popup Window。
feature_not_granted為彈出視窗聊天開啓的已發布地圖工作階段被用於 /chat/control/stream。每項功能各有獨立的工作階段。使用 "feature": "control_tower" 交換工作階段；地圖在 Control Tower 開啓時授予該功能。
owner_has_no_organization已發布地圖的工作階段交換：地圖所有者沒有可承擔費用的組織。所有者必須建立或加入組織。

找不到資源：404​

錯誤代碼觸發條件處理方式
not_found已發布地圖的工作階段交換：沒有任何已發布地圖或分享連結使用此 share_id。檢查 ID，並確認地圖已經發佈。
sessions_disabled平台已禁用工作階段交換。你無法自行修改此設定，請聯繫支援團隊。
Not Found路徑不存在。根據端點文件檢查 URL，包括 /inference-api/b2b/v1 前綴。

驗證：422​

要求本文或查詢字串不符合端點要求。detail 是一個數組，其中每項的 loc 指明欄位，msg 說明錯誤。

{
  "detail": [
    { "type": "missing", "loc": ["body", "product"], "msg": "Field required", "input": {} }
  ]
}

請修正要求，不要未修改就重試。兩個串串流端點 /chat/summary/stream 和 /chat/button/stream 在要求本文格式錯誤時回傳 500 而非 422；欄位超長的情況除外（見下文）。

要求限制：422 與錯誤代碼​

格式正確但超過大小限制的要求也會回傳 422，不過採用包裝後的結構：detail 是包含錯誤代碼的字串，而不是數組。此類拒絕不會計費。

{ "detail": "conversation_too_long" }
錯誤代碼端點觸發條件處理方式
too_many_messages/chat/control/streammessages 超過 400 項。只傳送最近的對話輪次。
message_too_long/chat/control/stream某條消息的 content 超過 64,000 個字符。縮短該消息。
conversation_too_long/chat/control/stream所有消息的 content 總長度超過 200,000 個字符。刪除較早的對話輪次後重新傳送。
invalid_session_id/chat/control/streamsession_id 超過 128 個字符，或包含字母、數字、_、.、:、- 之外的字符。使用符合要求的 ID，例如 UUID。
lang_too_long/chat/control/streamlang 超過 35 個字符。傳送 pt-BR 之類的 BCP 47 語言標籤。
invalid_layout/chat/control/streamlayout 超過 16 個字符。viewer 顯示導覽版面時傳送 guide，或省略該欄位。
field_too_long/chat/summary/stream, /chat/button/stream文本欄位超過長度限制，或清單項數超過限制。縮短欄位。限制詳見端點文件。

聊天串流的限制詳見端點文件。

要求過大：413​

錯誤代碼觸發條件處理方式
request_too_large要求本文超過 2 MiB，或 /design/* 端點要求本文超過 5 MiB。回應本文為 {"detail": "request_too_large"}。不會計費。減少傳送量：精簡對話，或減少設計要求中的範例行。不要未修改就重試。
request_body_too_large/shared-api 下的金鑰管理或業務資料要求超過 1 MiB，或上傳要求 POST /shared-api/datahub/ingests 超過 32 MiB。縮小要求本文。上傳要求詳見上傳業務資料。

如果要求聲明的大小遠超任意端點的限制，它可能在抵達 API 前就被網路邊緣拒絕。這類回應沒有 Kaleidr JSON 回應本文，因此也沒有可讀取的錯誤代碼；請減少傳送量。

因大小而被拒絕的要求與其他在處理前被拒絕的要求一樣，不會收費，之後也不會佔用 AI 點數或並行名額。

額度和速率限制：429​

決定是否重新嘗試之前，請先讀取回應本文。

代碼欄位Retry-After發生時機處理方式
quota_exceedederror距離 reset_at 的秒數組織的 AI 點數不足以支付這次呼叫，或呼叫將超出該金鑰本身的每月上限。上傳 API 的對應設定建議呼叫也會傳回此錯誤。不要重試。等待至 reset_at、增加點數，或提高金鑰的上限。
rate_limitederror5金鑰每分鐘的請求額度已用盡。針對某個金鑰、已發布地圖或單一位址進行過多次工作階段交換時，也會發生。等待 Retry-After 指定的秒數，再加入隨機延遲後重試。
org_overloadederror5組織同時執行中的呼叫過多。等待其中一個執行中的呼叫結束後再重試。關閉不再需要的串流連線。
b2b_overloadederror5API 已達到對所有呼叫端提供服務的容量上限。等待 Retry-After 指定的秒數，再以逐步增加的退避間隔重試。
limiter_unavailableerror5速率限制器無法回應。稍後再試。這不是你的請求速率造成的問題。
visitor_limit_reachederror5已發布地圖的聊天功能中，某位訪客超過了每分鐘或每日請求上限。請訪客稍後再試。
map_load_quota_exceededdetail無針對 tile 的 POST /sdk/sessions：組織的地圖載入額度已用盡。不要重試。等待期間重設，或加購地圖載入套件。

quota_exceeded 回應本文包含以下數值：

{
  "error": "quota_exceeded",
  "detail": "Usage limit reached. Please try again later.",
  "product": "b2b",
  "meter": "b2b.tokens",
  "tier": "pro",
  "limit": 5000000,
  "used": 4999100,
  "remaining": 900,
  "reset_at": "2026-11-01T04:00:00+00:00",
  "period": "month",
  "reset_in_seconds": 1296000
}

這是伺服器金鑰收到的回應本文。使用工作階段權杖（由可公開使用的金鑰交換所得，或來自已發布地圖的訪客工作階段）發起的要求會收到更簡短的回應本文，不會洩露組織的方案或使用量：

{
  "error": "quota_exceeded",
  "detail": "Usage limit reached. Please try again later.",
  "meter": "b2b.tokens",
  "reset_at": "2026-11-01T04:00:00+00:00",
  "reset_in_seconds": 1296000
}

各欄位、單個金鑰上限的變體及處理示例程式碼詳見額度與速率限制。

伺服器錯誤：5xx​

狀態錯誤代碼觸發條件處理方式
500An internal error occurred. Please try again.發生意外故障。稍等片刻後重新嘗試一次。
500map_design_analyze_failedPOST /design/analyze 無法分析表格。不會計費。檢查表格列與範例行，然後重新嘗試。
500Summary stream errorPOST /chat/summary/stream 無法啓動：要求本文無法讀取，或建築物要求缺少 address。欄位過長時則回傳 422 field_too_long。修正要求本文。
500Button chat stream errorPOST /chat/button/stream 無法啓動：要求本文無法讀取或缺少 query。欄位過長時則回傳 422 field_too_long。修正要求本文。
503sessions_not_configured平台故障導致工作階段交換不可用。重新嘗試；持續失敗時聯繫支援團隊。
503share_grant_unavailable已發布地圖的工作階段交換：無法讀取地圖設定。稍後重新嘗試。

狀態碼為 200 的錯誤​

POST /chat/control/route 在無法規劃路線時也會回傳 200：

{ "error": "Route planning failed." }

此回應包含 error，但沒有 action。只檢查狀態碼的使用者端會誤認為呼叫成功，隨後在讀取 action 時失敗。請始終檢查回應本文中的 error。錯誤文本已適合直接向使用者展示。詳情見路線指引。

GET /retrieval/geocode/forward 也有類似行為：內部查詢失敗時回傳 200 且 results 為空，這與沒有匹配結果的查詢相同。

串串流傳輸中的錯誤​

上述內容均適用於串流開始之前：被拒絕的串串流要求會收到普通 HTTP 錯誤。一旦回應狀態為 200 且開始傳輸框架，故障就會通過 error 事件傳送：

event: error
data: {"type": "error", "code": "upstream_stall", "message": "The AI service stopped responding. Please try again.", "partial_text": "The Louvre sits"}
串流code觸發條件處理方式
/chat/control/streamupstream_stall回答停止推進，或串流達到約 10 分鐘的最長運行時間。提供重新嘗試選項。如果 partial_text 有用，請保留它。
/chat/control/stream缺失生成回答期間的其他故障。顯示 message。重新嘗試可能成功。
/chat/summary/stream缺失摘要生成失敗。顯示 message，或不顯示摘要。
/spot/overview/stream缺失概覽失敗或無法描述 ref。如果無法描述，事件會攜帶 ref：不在指定點的 poi: 或 region: 引用、缺少 hint.name 的 place:，或 API 不提供描述的建築物或地址。不顯示概覽。對於攜帶 ref 的事件，不要重新嘗試。
/chat/button/stream無此串流沒有 error 事件。失敗時連線會直接關閉，不傳送 end。將沒有 end 就關閉的串流視為失敗。

適用於每一種串流的規則：

  • error 事件會取代 end。之後最多只會再出現可選的 quota 事件。
  • 如果連線關閉前既沒有 end 也沒有 error，則視為失敗。
  • quota 事件不是錯誤，而是在 end 或 error 之後傳送的用量報告。使用工作階段權杖讀取串流時，它僅包含 type、meter 和 reset_at。
  • 未知事件名稱不代表錯誤，應忽略它。

即使串流失敗或中途關閉，也仍會計費。對於 /chat/control/stream，費用不會低於根據傳送的對話內容估算的金額，因此可能高於開始時預留的點數：參見串串流呼叫的計費方式。每次重新嘗試都是另一次獨立計費的要求。

瀏覽器隱藏的錯誤​

當來源或身分憑證被拒絕時，回應不會包含 CORS 回應標頭，瀏覽器會阻止程式碼讀取狀態和回應本文。頁面控制台會顯示 CORS 錯誤，fetch 會被拒絕；SDK 會記錄包含 [kaleidr:<product>] 的錯誤。

要讀取真實錯誤代碼，請打開 Network 選項卡並選擇失敗的要求。常見程式碼包括 origin_not_allowed、Invalid or missing API key 和 server_key_in_browser。參見 CORS 與允許的來源。

沒有 Kaleidr JSON 回應本文的 4xx 錯誤來自 API 前面的網路邊緣層。原因可能是速率限制（降低要求頻率，稍後重新嘗試），也可能是聲明的要求大小遠超所有端點的限制（減少傳送量；未修改就重試會得到相同結果）。

地圖瓦片主機​

不通過來自允許來源、使用有效可公開使用的金鑰的 Kaleidr 嵌入元件訪問 tile.kaleidr.com 時，會收到：

狀態錯誤代碼Retry-After處理方式
429tile_access_restricted（位於 error，並帶有 message 和 docs）3600使用帶可公開使用的金鑰的 Tile 產品。如果金鑰設定了允許來源清單，請將頁面來源加入清單。

金鑰管理​

來自 https://api.kaleidr.com/shared-api/api-keys 的錯誤。API Keys 頁面使用該接口，你也可以通過帳號訪問權杖呼叫。所有錯誤都採用包裝後的結構。

狀態錯誤代碼觸發條件處理方式
401不固定沒有有效的賬戶訪問權杖。這裡不接受平台金鑰。重新登入。
403org_admin_required帳號不是組織的所有者或管理員。聯繫所有者或管理員。
403plan_required組織沒有方案。前往 kaleidr.com/billing選擇方案。
403free_plan_publishable_only在 Free 方案下要求建立伺服器金鑰。Free 方案輪替伺服器金鑰或舊版金鑰時也會回傳。建立可公開使用的金鑰，或升級到 Pro。
403tier_capability_not_allowed建立金鑰時：scopes 或 allowed_products 包含目前方案不允許的內容。常見情況是在 Free 或 Pro 下要求 vendor：無論是否提供 vendor_acknowledged 都會被拒絕，也不會建立金鑰。編輯金鑰時：allowed_products 包含方案不支援的產品，或在 Free 下設定為空清單。vendor 需要 Enterprise。其他情況下只填寫方案支援的權限範圍與產品。
404key_not_found組織中沒有該 ID 對應的金鑰。編輯與撤銷操作可匹配任何狀態的金鑰，因此重復撤銷已撤銷的金鑰會回傳 200。輪替需要有效金鑰，對已撤銷金鑰則回傳此錯誤。檢查 ID。輪替時，該金鑰可能已被撤銷。
409key_limit_reached組織已達到方案允許的活躍金鑰數量（Free 2、Pro 10、Enterprise 25）。撤銷一個金鑰，或輪替現有金鑰，而不是建立新金鑰。
409key_already_rotated金鑰已輪替，無論寬限期是否結束，都不能再次輪替。嘗試清空 expires_at 或將其設定為寬限期結束之後也會被拒絕。仍可設定更早的 expires_at 或編輯其他欄位。使用替代金鑰。
409key_expired從未輪替的金鑰已過期，且編輯要求包含 expires_at。無法為過期金鑰設定新的有效期，但仍可編輯其他欄位。建立新金鑰。
413request_body_too_large要求本文超過 1 MiB。縮小要求本文。
422unknown_scopescopes 包含 ai、maps、design、vendor 之外的值。修正清單。
422unknown_productallowed_products 包含 chat、editor、viewer、tile 之外的值。修正清單。
422vendor_scope_requires_acknowledgementEnterprise 下要求帶 vendor 權限的可公開使用的金鑰，但未提供 vendor_acknowledged: true。Free 或 Pro 下同樣的要求則回傳 403 tier_capability_not_allowed。閱讀 vendor 權限範圍，然後傳送此欄位。
422no_fields_to_update編輯要求沒有任何可編輯欄位。至少傳送一個欄位。
422驗證清單來源、IP 項、過去的到期時間或名稱格式錯誤。修正 loc 指明的欄位。
500insert_failed, session_unavailable平台故障。重新嘗試。
503api_key_pepper_not_configured平台故障導致無法建立金鑰。重新嘗試；持續失敗請聯繫支援團隊。

業務資料上傳​

來自 https://api.kaleidr.com/shared-api/datahub 下的上傳路由及欄位對應建議呼叫的錯誤。完整清單（包括導致各類 422 的文件和欄位限制）見上傳業務資料。以下列出在讀取文件前拒絕要求的錯誤，以及取消發佈或刪除資料版本時的錯誤：

狀態錯誤代碼觸發條件處理方式
403org_admin_required帳號不是組織所有者或管理員。欄位對應建議呼叫也會回傳。聯繫所有者或管理員。
403vendor_data_not_on_plan組織方案不支援上傳業務資料。此功能僅屬於 Enterprise。上傳、發佈、重新處理和欄位對應建議呼叫會回傳；讀取、取消發佈或刪除呼叫不會回傳。升級到 Enterprise。GET /shared-api/datahub/limits 在所有方案下都能直接回傳組織是否具有上傳權限，不會因此拒絕要求。Free 和 Pro 使用者可改為在 Kaleidr Studio 中向地圖新增資料：參見地圖中的資料集。
404release_not_found取消發佈或刪除時，組織中不存在該 ID 的版本，包括已完成刪除的版本。如果是在刪除操作中，可視為已刪除。
409org_ingest_in_progress組織的另一次上傳仍在處理。上傳、發佈和重新處理呼叫會回傳。等待完成後重新傳送。
409release_not_published對草稿或失敗的版本呼叫了取消發佈。無需取消發佈，可直接刪除。
409release_is_published嘗試刪除目前已發布的版本。先取消發佈，再刪除。
413request_body_too_large上傳要求超過 32 MiB。傳送更小的文件。文件本身可達到組織的文件大小限制。
422detail 中的 { "errors": [ … ] }文件超過行數或大小限制、JSON 包中的欄位超過長度限制，或 JSON 嵌套過深。合同設定的限制所對應的原因中會寫明限制值與方案。閱讀各項原因並修正文件。
429ingest_rate_limited組織在最近一小時內啓動了 30 次上傳。等待後重新嘗試。
429detail 中的一句話帳號在最近一小時內提出了 30 次欄位對應建議。回應本文沒有 error 欄位。等待後重新嘗試。
429error 中的 quota_exceeded欄位對應建議：組織的 AI 點數已用盡。回應本文是標準額度回應。等待 reset_at、補充點數或手動編寫欄位對應。

在 Kaleidr Studio 中上傳資料集​

本節不屬於使用金鑰認證的平台 API。這裡介紹已登入使用者在 Kaleidr Studio 的 Data 面板中向地圖新增資料集時，因大小限制而被拒絕所收到的回應。不涉及 API 金鑰。共有兩種含義不同的拒絕情況：

狀態錯誤代碼觸發條件處理方式
402quota_exceeded新資料集上傳超過組織的某項方案限制：單個資料集行數、單個文件大小，或組織所有資料集的總行數。limit_key 指明限制。已存儲的資料保留。Studio 會顯示提示及升級鏈接。上傳更小的文件，或刪除不再需要的資料集。Free 可升級到 Pro；Pro 或 Enterprise 可聯繫 Kaleidr提高組織總量上限，但單個資料集行數及單個文件大小不可超過下一行的硬性上限。
400VALIDATION_ERROR文件或資料集超過適用於所有方案的硬性上限：文件大於 64 MiB、資料集超過 100,000 行、地理文件超過 50,000 個要素，或圖片疊加層大於 16 MiB。程式碼位於 error。升級方案也不能通過此上傳。將文件拆分為更小的文件。不要未修改就重試，也不要提供升級方案。

收到哪種回應取決於大小，而不只是方案。系統會先檢查硬性上限，因此文件超過 64 MiB 或資料集超過 100,000 行時，Free、Pro、Enterprise 都回傳 400。402 表示上傳未超過硬性上限，但超過組織自身的限制，例如 Free 方案文件限制為 32 MiB，卻上傳了 40 MiB 文件。

402 quota_exceeded​

回應本文是問題詳情物件，還包含 Studio 自身的 error 和 message 欄位。程式碼同時位於 error 與 code，提示文字同時位於 message 與 detail：

{
  "error": "quota_exceeded",
  "message": "Your plan allows 250,000 rows across all of your organization's datasets. Delete a dataset or upgrade to add more.",
  "type": "https://errors.kaleidr.com/datasets/quota_exceeded",
  "title": "Quota Exceeded",
  "status": 402,
  "detail": "Your plan allows 250,000 rows across all of your organization's datasets. Delete a dataset or upgrade to add more.",
  "code": "quota_exceeded",
  "limit_key": "studio.data.rows.max",
  "limit": 250000,
  "used": 248500,
  "tier": "free",
  "upgrade_url": "https://kaleidr.com/pricing"
}
欄位含義
error, code始終為 quota_exceeded，同一個值出現兩次。
message, detail同一句話出現兩次。它用易懂的語言說明限制，可直接向使用者顯示。
type始終為 https://errors.kaleidr.com/datasets/quota_exceeded。
title始終為 Quota Exceeded。
status始終為 402。
limit_key導致上傳被拒絕的限制。見下表。
limit組織限制數值，單位與該限制一致。
used對總量限制，表示組織已存儲的行數；另外兩種限制表示此次上傳的行數或 MiB。
tier組織方案：free、pro 或 enterprise。讀取方案失敗時為 unknown，此時使用 Free 限制。
upgrade_url更換方案的網址。
limit_key限制limit 和 used 的單位提示語
studio.dataset.rows.max單個資料集行數行“您的方案允許單個資料集最多 50,000 行。請上傳更小的文件或升級方案。”
studio.dataset.file.mb單個上傳文件大小MiB“您的方案支援不超過 32 MB 的文件。請上傳更小的文件或升級方案。”
studio.data.rows.max組織所有資料集總行數行“您的方案允許組織所有資料集合計 250,000 行。請刪除一個資料集或升級方案以繼續新增。”

這些句子中的數值是 Free 方案限制；實際收到的句子會使用貴組織的限制。請向使用者展示句子，並依據 code 和 limit_key 執行分支處理。此 402 與平台 API 中關於 AI 點數的 429 quota_exceeded 是不同的回應。

400 VALIDATION_ERROR​

回應本文只有兩個欄位，沒有問題詳情的其他成員：

{
  "error": "VALIDATION_ERROR",
  "message": "File is larger than 64 MB."
}
拒絕原因message
文件超過 64 MiB“文件大於 64 MB。”
資料集超過 100,000 行“每個資料集最多 100000 條記錄”
地理文件超過 50,000 個要素“<filename> 包含超過 50000 個要素。請在上傳前拆分文件或簡化幾何形狀。”
圖片疊加層超過 16 MiB“疊加層影像大於 16 MB。”

上傳文件的其他問題（例如 Studio 不支援的文件類型，或文件沒有可用行）也會回傳相同狀態和程式碼；message 會說明具體原因。應將任何上傳時的 400 視為“該文件無法按目前形式新增”，並顯示 message。

相關內容​