SIP 엔드포인트 생성

POST

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

POST

/v1/accounts/:accountId/sip-endpoints

curl -X POST https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/sip-endpoints \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Acme 본사 트렁크"
}'

{
  "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"
}

BYOC SIP 트렁크 1개 생성. sip_trunk 애드온이 활성화돼 있어야 합니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

Request

This endpoint expects an object.

namestringRequired

UI 라벨 (필수, 100자 이하)

maxConcurrentinteger or nullOptional1-9999

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

401

Unauthorized Error

403

Forbidden Error