4.8 AddGroup Example

This example demonstrates an AddGroup request that is sent by the client to the server to add a group to the list of groups for this client.

Figure 8: AddGroup request example

The client sends a SERVICE request with a SOAP envelope/xml envelope in the body. The m:addGroup element indicates to the server that this request is for adding a group. The XML contains the name of the group, which is "Friends" in this case.

 SERVICE sip:server.contoso.com;transport=tcp SIP/2.0
 Via: SIP/2.0/TCP 11.22.33.44:14383
 Max-Forwards: 70
 From: <sip:user1@server.contoso.com>
   ;tag=c3c995d890e144b2aa7f2bd38c424a51;epid=f540d58d81
   To: <sip:user1@server.contoso.com>
     ;tag=5FDD7BA7
     Call-ID: f34928e3852c434a85a1f3c0e1e8a449
     CSeq: 2 SERVICE
     Contact: <sip:user1@server.contoso.com:14383;
                maddr=11.22.33.44;transport="tcp">
       ;proxy=replace
       User-Agent: RTC/1.3.5369
       Proxy-Authorization: Kerberos qop="auth", 
         realm="SIP Communications Service", opaque="1CF1F9E0", 
         crand="2daa2825", cnum="7", targetname="sip/server.contoso.com", 
         response="602306092a864886f71201020201011100
           ffffffffb0dd9fa33c820618ea9ff577dcb659b8"
       Content-Type: application/SOAP+xml
       Content-Length: 281
  
       <SOAP-ENV:Envelope 
         xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
         <SOAP-ENV:Body>
           <m:addGroup 
             xmlns:m="http://schemas.microsoft.com/winrtc/2002/11/sip">
             <m:name>Friends</m:name>
             <m:externalURI />
             <m:deltaNum>16</m:deltaNum>
           </m:addGroup>
         </SOAP-ENV:Body>
       </SOAP-ENV:Envelope>

The server responds to the SERVICE request with a 200 OK to indicate that the AddGroup request was successful. The 200 OK response can have a body.

  
  
 SIP/2.0 200 OK
 Authentication-Info: Kerberos 
     rspauth="602306092A864886F71201020201011100
            FFFFFFFF18134184AFDFDDE2B92BA96B6B8318F9", 
       srand="A8D0D0FF", snum="8", opaque="1CF1F9E0", qop="auth", 
       targetname="sip/server.contoso.com", 
       realm="SIP Communications Service"
 Content-Length: 250
 Via: SIP/2.0/TCP 11.22.33.44:14383;ms-received-port=1624;
    ms-received-cid=12c00
 From: <sip:user1@server.contoso.com>
   ;tag=c3c995d890e144b2aa7f2bd38c424a51;epid=f540d58d81
   To: <sip:user1@server.contoso.com>
     ;tag=5FDD7BA7
     Call-ID: f34928e3852c434a85a1f3c0e1e8a449
     CSeq: 2 SERVICE
     Content-Type: application/SOAP+xml
     <SOAP-ENV:Envelope 
       xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
       <SOAP-ENV:Body>
         <m:addGroup 
           xmlns:m="http://schemas.microsoft.com/winrtc/2002/11/sip">
           <m:groupID>1</m:groupID>
         </m:addGroup>
       </SOAP-ENV:Body>
     </SOAP-ENV:Envelope>