인증

Platform API로 보내는 모든 요청에는 두 개의 헤더가 필요합니다.

헤더	필수	용도
API-Key	✅	개발자 콘솔에서 발급한 API 키
X-TenantID	✅	요청이 실행되는 조직(워크스페이스) ID

curl "$ME_BASE/voice/providers" \
  -H "API-Key: $ME_API_KEY" \
  -H "X-TenantID: $ME_TENANT"

인증 정보는 서버에만 두세요

API-Key는 비밀 정보입니다. 브라우저나 모바일 앱처럼 통제할 수 없는 클라이언트에 넣지 마세요. 자체 백엔드를 통해 요청하세요.

키가 닿는 범위

키는 소유자의 권한을 그대로 가집니다. 요청은 키 소유자로서 X-TenantID의 조직에 대해 인가됩니다. 즉 키가 닿는 범위는 소유자와 같고, 그 이상은 아닙니다.

키 자체가 권한을 좁혀 주지는 않습니다. 연동에 필요한 권한만 가진 계정으로 키를 발급하고, 유출되면 즉시 재발급하세요.

오류

상태	의미	해결
401	API-Key 또는 X-TenantID가 없거나 올바르지 않음	두 헤더가 모두 있고 유효한지 확인합니다
400	요청 본문이 잘못됨	API 레퍼런스와 대조합니다
404	대상을 찾을 수 없음	경로와 ID를 확인합니다