> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.claw-ops.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.claw-ops.com/_mcp/server. # SIP 자격증명 발급 POST https://api.claw-ops.com/v1/accounts/{accountId}/sip-credentials Content-Type: application/json 외부 SIP 단말 인증용 digest 자격증명 1개 발급. realm 은 자동 생성 (\{accountId\_lower}.sip.claw-ops.com). 평문 password 는 응답에 1회만 노출되며 저장되지 않음. password 미지정 시 안전한 랜덤 32자 자동 생성. Reference: https://docs.claw-ops.com/api-레퍼런스/claw-ops-api/sip-trunks/create-sip-credential ## Authentication - `Authorization` header (bearer token, required) — API Key를 Bearer 토큰으로 전달 ## Request ### Path parameters - `accountId` (string, required) ### Body (application/json) - `name` (string, required) - `username` (string, required) — 영문/숫자/_/- 3~64자 - `password` (string, optional) — 12~128자. 미지정 시 자동 생성. - `ipAclId` (string, optional, nullable) - `allowedNumbers` (list of string, optional) — 비우면 계정 전체 번호 허용 (100개 이하) ## Response ### 201 발급 성공 — password 는 이 응답에서만 노출 - `id` (string, optional) - `accountId` (string, optional) - `name` (string, optional) - `username` (string, optional) - `realm` (string, optional) - `enabled` (boolean, optional) — kamailio 인증 허용 여부 - `status` (enum, optional) - Allowed values: `active`, `disabled`, `deleted` - `ipAclId` (string, optional, nullable) — SipIpAcl 참조 — 비우면 IP 무제한 (digest only) - `allowedNumbers` (list of string, optional) — From 헤더에 허용된 발신번호. 비우면 계정 전체 번호 허용. - `lastUsedAt` (datetime, optional, nullable) - `dateCreated` (datetime, optional) - `dateUpdated` (datetime, optional) - `password` (string, optional) — 평문 password — 이 응답에서만 노출되며 이후 절대 조회 불가. 안전한 곳에 즉시 보관 필요. 잊었으면 새 자격증명 발급 후 구버전 status=disabled 권장. ## Examples **Request** ```json { "name": "Acme WebRTC 앱", "username": "webrtc_acme01" } ``` **Response** ```json { "id": "string", "accountId": "string", "name": "Acme WebRTC 앱", "username": "webrtc_acme01", "realm": "ac1a2b3c4d.sip.claw-ops.com", "enabled": true, "status": "active", "ipAclId": "string", "allowedNumbers": [ "string" ], "lastUsedAt": "2024-01-15T09:30:00Z", "dateCreated": "2024-01-15T09:30:00Z", "dateUpdated": "2024-01-15T09:30:00Z", "password": "string" } ``` **SDK Code** ```python import requests url = "https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/sip-credentials" payload = { "name": "Acme WebRTC 앱", "username": "webrtc_acme01" } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/sip-credentials'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"name":"Acme WebRTC 앱","username":"webrtc_acme01"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/sip-credentials" payload := strings.NewReader("{\n \"name\": \"Acme WebRTC 앱\",\n \"username\": \"webrtc_acme01\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/sip-credentials") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"Acme WebRTC 앱\",\n \"username\": \"webrtc_acme01\"\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/sip-credentials") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"name\": \"Acme WebRTC 앱\",\n \"username\": \"webrtc_acme01\"\n}") .asString(); ``` ```php request('POST', 'https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/sip-credentials', [ 'body' => '{ "name": "Acme WebRTC 앱", "username": "webrtc_acme01" }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/sip-credentials"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"Acme WebRTC 앱\",\n \"username\": \"webrtc_acme01\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "name": "Acme WebRTC 앱", "username": "webrtc_acme01" ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/sip-credentials")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```