API
狀态碼列表及說(shuō)明
客戶端向 SuperMap iManager服務器發送HTTP請求時(shí)，SuperMap iManager 服務器會根據請求的(de)類型返回響應結果，通過響應結果中的(de)狀态碼，客戶端可以(yǐ)得知請求的(de)處理情況。例如：是(shì)否成功、出(chū)錯的(de)原因，等等。
HTTP 協議定義了(le／liǎo)各個(gè)狀态碼代表的(de)意義，官方定義有41種狀态碼，分5類，如下：
- 1xx：信息性——收到(dào)請求，繼續處理
- 2xx：成功性——成功收到(dào)、理解并接受行動
- 3xx：重定向——必須采取進一(yī / yì ／yí)步行動來(lái)完成請求
- 4xx：客戶端錯誤——請求包含錯誤語法或不(bù)能完成
- 5xx：服務器錯誤——服務器沒有成功完成顯然有效的(de)請求
SuperMap iManager 主要(yào / yāo)用到(dào)其中的(de)2xx 系列、4xx 系列和(hé / huò)5xx 系列，各個(gè)狀态碼的(de)含義如下表所示：
| 狀态碼值 | 含義 |
|---|---|
| 200 | 表示服務器成功執行了(le／liǎo)客戶端的(de) HTTP 請求。如果請求的(de)類型是(shì) GET 說(shuō)明獲取資源成功，是(shì) PUT 說(shuō)明修改資源成功，是(shì) DELETE 說(shuō)明删除資源成功，是(shì) HEAD 說(shuō)明獲取資源的(de)元數據成功。 |
| 201 | 表示服務器按客戶端的(de)請求成功創建了(le／liǎo)一(yī / yì ／yí)個(gè)新資源。對應的(de)請求類型是(shì) POST 或 PUT。注意，這(zhè)時(shí)返回的(de)信息中會包含 Location 報頭，指向新創建資源的(de)規範 URI。 |
| 400 | 表示客戶端的(de)請求參數不(bù)合法或沒有表達足夠的(de)信息。 |
| 401 | 表示因爲(wéi / wèi)安全的(de)原因，導緻對資源的(de)操作沒有完成。 |
| 404 | 表示客戶端請求的(de)資源不(bù)存在(zài)，即 URI 無效。 |
| 405 | 表明資源不(bù)支持該操作。 |
| 406 | 表示資源不(bù)支持客戶端請求的(de)表述格式。 |
| 500 | 表示服務器端發生非預期情況，導緻請求沒有完成。 |