ClawOps Docs
API Reference

단기 SIP 토큰 발급 (WebRTC/SIP 단말용)

POST
/v1/accounts/{accountId}/sip-credentials/{credentialId}/tokens

영구 SipCredential 로부터 단기 JWT 를 발급. 랜덤 ephemeral SIP username/password 와 함께 발급되며, JWT payload 에 SIP digest 인증에 필요한 모든 값(ws_url, realm, sip_username, sip_password, allowed_caller_ids)이 포함됨. 클라이언트는 JWT 를 디코드해서 JsSIP/SIP.js 등 SIP UA 에 그대로 사용. 서버측은 이 엔드포인트를 자체 백엔드에서 호출해 결과를 그대로 브라우저에 전달하는 패턴 권장 (API Key 노출 방지). 부모 자격은 status=active, enabled=true 여야 함.

Authorization

BearerAuth
AuthorizationBearer <token>

API Key를 Bearer 토큰으로 전달

In: header

Path Parameters

accountId*string
credentialId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/accounts/AC1a2b3c4d/sip-credentials/SC1a2b3c4d/tokens" \  -H "Content-Type: application/json" \  -d '{}'
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_at": "2019-08-24T14:15:22Z",
  "ws_url": "wss://sip.claw-ops.com:5063",
  "sip_uri": "ephem_xxxxxxxx@acjy4jwrdw2fxi62vb.sip.claw-ops.com"
}
{
  "error": "string",
  "code": "INVALID_PHONE_NUMBER"
}
{
  "error": "string",
  "code": "INVALID_PHONE_NUMBER"
}
{
  "error": "string",
  "code": "INVALID_PHONE_NUMBER"
}