SIP 엔드포인트 수정

PUT

https://api.claw-ops.com/v1/accounts/:accountId/sip-endpoints/:endpointId

PUT

/v1/accounts/:accountId/sip-endpoints/:endpointId

curl -X PUT https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/sip-endpoints/SE1a2b3c4d \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "trunk-1-updated",
  "status": "active"
}'

{
  "id": "string",
  "accountId": "string",
  "name": "Acme 본사 트렁크",
  "maxConcurrent": 50,
  "status": "active",
  "outboundAuthUsername": "acme-trunk",
  "outboundAuthRealm": "pbx.acme.com",
  "outboundAuthEnabled": true,
  "routes": [
    {
      "id": "string",
      "endpointId": "string",
      "uri": "sip:pbx.acme.com:5060",
      "priority": 10,
      "weight": 100,
      "transport": "udp",
      "mediaCrypto": "rtp",
      "status": "active",
      "lastUsedAt": "2024-01-15T09:30:00Z",
      "lastFailureAt": "2024-01-15T09:30:00Z",
      "failureCount": 0,
      "dateCreated": "2024-01-15T09:30:00Z",
      "dateUpdated": "2024-01-15T09:30:00Z"
    }
  ],
  "dateCreated": "2024-01-15T09:30:00Z",
  "dateUpdated": "2024-01-15T09:30:00Z"
}

outboundAuth 를 생략하면 기존 값을 유지하고, null 또는 빈 객체를 보내면 제거합니다. 값을 바꿀 때는 username·realm·password 를 모두 보냅니다. mediaCrypto=sdes 라우트가 있는 엔드포인트에는 설정할 수 없습니다(400).

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

endpointIdstringRequired

Request

This endpoint expects an object.

namestringOptional

maxConcurrentinteger or nullOptional1-9999

statusenumOptional

Allowed values:

outboundAuthobjectOptional

받는 SIP 서버가 digest 인증을 요구할 때 쓰는 자격증명. username·realm·password 를 함께 보내야 하며 일부만 보내면 400 입니다. password 는 응답에 포함되지 않습니다.

Response

수정 성공

idstringOptional

endpoint id

accountIdstringOptional

namestringOptional

maxConcurrentinteger or nullOptional

동시 통화 한도 (null = 무제한)

statusenumOptional

Allowed values:

outboundAuthUsernamestring or nullOptional

외부 SIP 인증 username (미설정이면 null)

outboundAuthRealmstring or nullOptional

외부 SIP 인증 realm (미설정이면 null)

outboundAuthEnabledbooleanOptional

외부 SIP 인증 설정 여부

routeslist of objectsOptional

소속 라우트 목록 (priority asc 정렬)

dateCreateddatetimeOptional

dateUpdateddatetimeOptional

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error