พื้นที่ทำงาน

ดูพื้นที่ทำงานปัจจุบัน

คืนพื้นที่ทำงานที่ผูกกับส่วนหัว X-Api-Key ไม่ต้องส่ง workspace_id ในเนื้อหาของคำขอ

GEThttps://api.unifyport.ai/v1/workspace

ก่อนเรียกใช้

ใช้ X-Api-Key ของ workspace เจ้าของทรัพยากรบนเซิร์ฟเวอร์ แทนค่าตัวอย่างทั้งหมดก่อนเรียกใช้

พารามิเตอร์คำขอ

ส่วนหัว

X-Api-Key

stringจำเป็น

API key ของพื้นที่ทำงาน ระบบจะระบุพื้นที่ทำงานจากส่วนหัวนี้

เนื้อหาของคำขอ

จุดเชื่อมต่อนี้ไม่ต้องใช้เนื้อหา JSON

ทำความเข้าใจผลลัพธ์

อ่านฟิลด์ตอบกลับและสถานะ HTTP ตามเอกสาร 204 สำเร็จไม่มีเนื้อหา ใช้ X-Request-Id เพื่อตรวจสอบ ขั้นตอนต่อไปอยู่ในการทำงานที่เกี่ยวข้อง

การตอบกลับ 200 OK

{
  "request_id": "<REQUEST_ID>",
  "data": {
    "name": "Production Workspace",
    "status": "active",
    "metadata": {
      "env": "production"
    },
    "account_quota": 10,
    "account_quota_used": 1,
    "account_quota_unlimited": false
  }
}

เนื้อหาการตอบกลับ

name

string

ชื่อแสดงผลของ workspace

status

string

สถานะ workspace: active หรือ inactive โดย inactive บล็อก API key ทั้งหมด

enum: active, inactive

metadata

object

label สภาพแวดล้อมของคุณเองที่เก็บไว้บน workspace

account_quota

integer

ความจุบัญชีแบบอ่านอย่างเดียวที่มีผลในปัจจุบัน รวมโควตาฟรีและโควตาแบบชำระเงินที่ยังไม่หมดอายุ โดยไม่หักจำนวนที่ใช้ไป; โควตาแบบชำระเงินที่หมดอายุแล้วจะไม่ถูกนับ

format: uint64

account_quota_used

integer

โควตาบัญชีที่ใช้อยู่ในปัจจุบันแบบอ่านอย่างเดียว การสร้างบัญชีจะใช้โควตาทันทีและการลบบัญชีจะคืนโควตา บัญชีที่รอการอนุญาต หยุดทำงาน หรือขาดการเชื่อมต่อยังถูกนับ เมื่อโควตาแบบชำระเงินหมดอายุ จำนวนที่ใช้อาจเกิน account_quota โดยจะคืนจำนวนที่ใช้จริง

format: uint64

account_quota_unlimited

boolean

ฟิลด์อ่านอย่างเดียวที่สงวนไว้เพื่อความเข้ากันได้ โหมดโควตาปัจจุบันจะคืนค่า false เสมอ; ให้ใช้ account_quota เป็นความจุบัญชี

การตอบกลับ

200

200 OK

คำขอสำเร็จ ดูตัวอย่างเนื้อหาตอบกลับด้านบน

401

Unauthorized

ส่วนหัว X-Api-Key หายไปหรือไม่ถูกต้อง

500

Internal Server Error

บริการพบข้อผิดพลาดที่ไม่คาดคิด

เมื่อคำขอล้มเหลว

ตรวจ HTTP และ error.code/numeric_code เก็บ request_id แล้วแก้พารามิเตอร์ ยืนยันตัวตนต่อ หรือตรวจ runtime ตามสาเหตุ ตรวจผลครั้งก่อนก่อนส่งหรือเขียนซ้ำ อ้างอิงรหัสข้อผิดพลาด

invalid_request · 10000 · 400: ตรวจฟิลด์บังคับ รูปแบบ และเงื่อนไขช่องทาง แล้วแก้คำขอ
invalid_api_key · 11001 · 401: ตรวจ X-Api-Key และว่า workspace ยังใช้งานอยู่