1. Tony Wang Avatar Tony Wang
  2. Untitled project
  3. libsipc

Wiki

Clone wiki

libsipc / method-service

View History

SIP-C Method SERVICE

Update Impression(impresa?)

(not test yet)

header

S fetion.com.cn SIP-C/4.0
F: 88884444
I: 49 
Q: 1 S
N: SetUserInfoV4
L: 62

body

<args><userinfo><personal impresa="hello" /></userinfo></args>

response

header

SIP-C/4.0 200 OK
I: 49
Q: 1 S
L: 88

body

<results>
    <userinfo>
        <personal version="373739847" impresa="hello"/>
    </userinfo>
</results>

Update Presence Basic Value

header

S fetion.com.cn SIP-C/4.0
F: 88884444
I: 57 
Q: 1 S
N: SetPresenceV4
L: 55

body

<args><presence><basic value="600" /></presence></args>

response

header

SIP-C/4.0 200 OK
I: 57
Q: 1 S
L: 61

body

<results><presence><basic value="600" /></presence></results>

See also: the CONSTS table

Update SMS Online Status

header

S fetion.com.cn SIP-C/4.0
F: 88884444
I: 232 
Q: 1 S
N: SetUserInfoV4
L: 77

response

<args><userinfo><personal sms-online-status="1.00:00:00" /></userinfo></args>

response

header

SIP-C/4.0 200 OK
I: 232
Q: 1 S
L: 103

body

<results><userinfo><personal version="373745245" sms-online-status="1.00:00:00" /></userinfo></results>

|| sms-online-status || desc || | 0.00:00:00 | 接收短信/彩信 | | 36500.00:00:00 | 永远 |

Update Personal Info

(not test yet)

"基本设置"

header

S fetion.com.cn SIP-C/4.0
F: 88884444
I: 72 
Q: 1 S
N: SetUserInfoV4
L: 143

body

<args>
    <userinfo>
        <personal nickname="Lee" birth-date="2011-01-01" birthday-lunar="0"
                  lunar-animal="3" horoscope="1" age="0"/>
    </userinfo>
</args>

response

header

SIP-C/4.0 200 OK
I: 72
Q: 1 S
L: 169

body

<results>
    <userinfo>
        <personal version="373740430" nickname="Lee" birth-date="2011-01-01"
                  lunar-animal="3" horoscope="1" birthday-lunar="0" age="0"/>
    </userinfo>
</results>

"扩展设置"

header

S fetion.com.cn SIP-C/4.0
F: 88884444
I: 82
Q: 1 S
N: SetUserInfoV4
L: 93

body

<args>
    <userinfo>
        <personal job-title="operating" work-phone="13800013800"/>
    </userinfo>
</args>

response

header

SIP-C/4.0 200 OK
I: 82
Q: 1 S
L: 119

body

<results>
    <userinfo>
        <personal version="373740717" job-title="operating"
                  work-phone="13800013800"/>
    </userinfo>
</results>

Update Privacy

(not test yet)

Privacy

安全与隐私 -> 身份验证

其他人添加我为好友时

|| value || desc || | 1 | "完全同意" | | 2 | "需要我审核" | | 3 | "全部拒绝" |

1

S fetion.com.cn SIP-C/4.0
F: 87654321
I: 13 
Q: 1 S
N: SetUserInfoV4
L: 75

<args><userinfo><personal global-permission="buddy=1;" /></userinfo></args>

1 resp

SIP-C/4.0 200 OK
I: 13
Q: 1 S
L: 101

<results><userinfo><personal version="373425575" global-permission="buddy=1;" /></userinfo></results>

2

S fetion.com.cn SIP-C/4.0
F: 87654321
I: 15 
Q: 1 S
N: SetUserInfoV4
L: 75

<args><userinfo><personal global-permission="buddy=2;" /></userinfo></args>

2 resp

SIP-C/4.0 200 OK
I: 15
Q: 1 S
L: 101

<results><userinfo><personal version="373425629" global-permission="buddy=2;" /></userinfo></results>

防骚扰设置 -> 陌生人联系验证

x 拒绝陌生人和我联系

当客户端没有登录时，接手陌生人消息的方式

|| value || desc || | 0 | 下次登录时接收 | | 1 | 拒绝接收 |

0

S fetion.com.cn SIP-C/4.0
F: 87654321
I: 30 
Q: 1 S
N: SetUserInfoV4
L: 77

<args><userinfo><personal global-permission="contact=0;" /></userinfo></args>

0 resp

SIP-C/4.0 200 OK
I: 30
Q: 1 S
L: 103

<results><userinfo><personal version="373426048" global-permission="contact=0;" /></userinfo></results>

1

S fetion.com.cn SIP-C/4.0
F: 87654321
I: 22 
Q: 1 S
N: SetUserInfoV4
L: 64

<args><userinfo><personal save-xeno-msg="1" /></userinfo></args>

1 resp

SIP-C/4.0 200 OK
I: 22
Q: 1 S
L: 90

<results><userinfo><personal version="373425836" save-xeno-msg="1" /></userinfo></results>

拒绝接收

S fetion.com.cn SIP-C/4.0
F: 87654321
I: 34 
Q: 1 S
N: SetUserInfoV4
L: 95

<args><userinfo><personal global-permission="contact=1;" save-xeno-msg="1" /></userinfo></args>

Add Buddy

header

S fetion.com.cn SIP-C/4.0
I: 4
Q: 1 S
N: AddBuddyV4
L: 261
F: 87654321

body

<args>
    <contacts>
        <buddies>
            <buddy uri="mix:33334444" buddy-lists="" desc="buffer"
                expose-mobile-no="0"
                expose-name="1"
                addbuddy-phrase-id="0" />
        </buddies>
    </contacts>
</args>

or

header

S fetion.com.cn SIP-C/4.0
F: 33334444
I: 43 
Q: 1 S
N: AddBuddyV4
L: 148

body

<args>
    <contacts>
        <buddies>
            <buddy uri="mix:foo@bar.com" buddy-lists="" desc="366" addbuddy-phrase-id="0" />
        </buddies>
    </contacts>
</args>

XPath: /args/contacts/buddies/buddy

|| node in XPath || desc || | uri | _ | | buddy-lists | _ | | desc | a short phrase to identify yourself, the max length is 10 (in characters in UTF-8) | | expose-mobile-no | _ | | expose-name | _ | | addbuddy-phrase-id | _ |

response status code 200

header

SIP-C/4.0 200 OK
I: 4
Q: 1 S
L: 332

body

<results>
    <contacts version="373643171">
        <buddies>
            <buddy uri="mix:33334444" local-name="" buddy-lists=""
                   online-notify="0" desc="366" expose-mobile-no="0"
                   expose-name="1" relation-status="0" 
                   addbuddy-phrase-id="0" status-code="200"
                   permission-values="" basic-service-status="1"/>
        </buddies>
    </contacts>
</results>

|| node in XPath || desc || | status-code | _ | | error-reason | _ | | relation-status | _ | | permission-values | _ | | basic-service-status | _ |

response status code 486, send request for 'same user monthly limit' / 'same-user-daily-limit'

header

SIP-C/4.0 200 OK
I: 4
Q: 1 S
L: 320

body

<results>
    <contacts version="0">
        <buddies>
            <buddy uri="sip:33334444@fetion.com.cn;p=16106" local-name=""
                   buddy-lists="" online-notify="0" desc="buffer"
                   expose-mobile-no="0" expose-name="1" user-id="888877770"
                   addbuddy-phrase-id="0" status-code="486"
                   error-reason="same-user-monthly-limit"/>
        </buddies>
    </contacts>
</results>

or

header

SIP-C/4.0 200 OK
I: 4
Q: 1 S
L: 295

body

<results>
    <contacts version="0">
        <buddies>
            <buddy uri="tel:13800138001" local-name="" buddy-lists=""
                   online-notify="0" desc="366" expose-mobile-no="0"
                   expose-name="1" user-id="123456789" addbuddy-phrase-id="0"
                   status-code="486" error-reason="same-user-daily-limit"/>
        </buddies>
    </contacts>
</results>

|| node in XPath || desc || | status-code | _ | | error-reason | _ |

Solution of status code 486: send the request next monty

NOTE:

following all are valid values of the attribute 'uri':

tel:13800123456
sip:12345@fetion.com.cn;p=123456
mix:123456789
mix:foo@example.com

it matches the extract URI in the request.

Delete Buddy

header

S fetion.com.cn SIP-C/4.0
F: 88884444
I: 11
Q: 1 S
N: DeleteBuddyV4
L: 98

body

<args>
    <contacts>
        <buddies>
            <buddy user-id="888877770" delete-both="1" />
        </buddies>
    </contacts>
</args>

response

header

SIP-C/4.0 200 OK
I: 11
Q: 1 S
L: 124

body

<results>
    <contacts version="353115169">
        <buddies>
            <buddy user-id="888877770" delete-both="1" />
        </buddies>
    </contacts>
</results>

Response Add Buddy Application Request

Refuse it wihout reason

header

S fetion.com.cn SIP-C/4.0
I: 4
Q: 1 S
N: HandleContactRequestV4
L: 149
F: 87654321

body

<args>
    <contacts>
        <buddies>
            <buddy user-id="123456789" result="0" reason="" />
        </buddies>
    </contacts>
</args>

Refuse it with reason body

<args>
    <contacts>
        <buddies>
            <buddy user-id="888877770" result="0" reason="piss off" />
         </buddies>
     </contacts>
</args>

response

header

SIP-C/4.0 200 OK
I: 4
Q: 1 S
L: 195

body

<results>
    <contacts version="373579633">
        <buddies>
            <buddy local-name="" result="0" relation-status="2"
                   user-id="123456789" permission-values="identity=0;"
                   reason=""/>
        </buddies>
    </contacts>
</results>

How user ID 87654321 contact look likes in 373579633 ?

87654321 [对方拒绝]

|| node in XPath || desc || | relation-status | see Send REGISTER Request to proxy server in a brief -> attribute 'r' (relation status) |

Accept it

header

S fetion.com.cn SIP-C/4.0
I: 4
Q: 1 S
N: HandleContactRequestV4
L: 101
F: 33334444

body

<args>
    <contacts>
        <buddies>
            <buddy user-id="888899990" result="1" />
        </buddies>
    </contacts>
</args>

response

header

SIP-C/4.0 200 OK
I: 4
Q: 1 S
L: 293

body

<results>
    <contacts version="373576463">
        <buddies>
            <buddy local-name="" 
                online-notify="0" 
                expose-mobile-no="0" 
                expose-name="0" 
                expose-basic-presence="1" 
                accept-instant-message="1" 
                result="1" relation-status="1" 
                user-id="888899990" 
                permission-values="identity=0;" />
        </buddies>
    </contacts>
</results>

Ignore It

header

S fetion.com.cn SIP-C/4.0
I: 4
Q: 1 S
N: HandleContactRequestV4
L: 157
F: 88884444

body

<args>
    <contacts>
        <buddies>
            <buddy user-id="888877770" result="2" />
         </buddies>
     </contacts>
</args>

Move Contact Into Blacklist

header

S fetion.com.cn SIP-C/4.0
I: 5
Q: 1 S
N: AddToBlacklist
L: 151
F: 88884444

body

<args>
    <contacts>
        <blacklist>
            <blocked uri="sip:33334444@fetion.com.cn;p=16106"/>
        </blacklist>
    </contacts>
</args>

response

header

SIP-C/4.0 200 OK
I: 5
Q: 1 S
L: 156

body

<results>
    <contacts version="373736940">
        <blacklist>
            <blocked uri="sip:33334444@fetion.com.cn;p=16106" user-id="888877770" />
        </blacklist>
    </contacts>
</results>

If contact A in contact B's blacklist, system will auto reply refuse to contact A immedially after a send add buddy applidation request.

Remove Contact From Blacklist

header

S fetion.com.cn SIP-C/4.0
F: 88884444
I: 10 
Q: 1 S
N: RemoveFromBlacklistV4
L: 88

body

<args>
    <contacts>
        <blacklist>
            <blocked user-id="888877770" />
        </blacklist>
    </contacts>
</args>

response

SIP-C/4.0 200 OK
I: 10
Q: 1 S
L: 114

body

<results>
    <contacts version="373738693">
        <blacklist>
            <blocked user-id="888877770" />
        </blacklist>
    </contacts>
</results>

Get Contact Info By Account ID

header

S fetion.com.cn SIP-C/4.0
F: 87654321
I: 7 
Q: 1 S
N: GetContactInfoV4
L: 58

body

<args><contact uri="mix:13800138001" version="0" /></args>

response

header 

SIP-C/4.0 200 OK
I: 7
Q: 1 S
L: 302

body

<results>
    <contact uri="tel:13800138001" version="0" user-id="123456789"
             mobile-no="13800138001" basic-service-status="1" carrier="CMCC"
             carrier-status="0" portrait-crc="1644765971" birth-date="1900-1-1"
             birthday-valid="0" impresa="" carrier-region="CN.gd.20."
             user-region="" score-level="4"/>
</results>

Example II:

header

S fetion.com.cn SIP-C/4.0
F: 87654321
I: 8 
Q: 1 S
N: GetContactInfoV4
L: 78

body

<args><contact user-id="123456789" uri="tel:13800138001" version="0" /></args>

resposne

header

SIP-C/4.0 200 OK
I: 8
Q: 1 S
L: 302

body

<results>
    <contact uri="tel:13800138001" version="0" user-id="123456789"
             mobile-no="13800138001" basic-service-status="1" carrier="CMCC"
             carrier-status="0" portrait-crc="1644765971" birth-date="1900-1-1"
             birthday-valid="0" impresa="" carrier-region="CN.gd.20."
             user-region="" score-level="4"/>
</results>

Create Group

header

S fetion.com.cn SIP-C/4.0
F: 87654321
I: 46 
Q: 1 S
N: CreateBuddyList
L: 86

body

<args>
    <contacts>
        <buddy-lists>
            <buddy-list name="foo"/>
        </buddy-lists>
    </contacts>
</args>

resposne

header

SIP-C/4.0 200 OK
I: 46
Q: 1 S
L: 119

body

<results>
    <contacts version="380941366">
        <buddy-lists>
            <buddy-list name="foo" id="2"/>
        </buddy-lists>
    </contacts>
</results>

Delete Group

header

S fetion.com.cn SIP-C/4.0
F: 87654321
I: 47 
Q: 1 S
N: DeleteBuddyList
L: 82

body

<args>
    <contacts>
        <buddy-lists>
            <buddy-list id="2"/>
        </buddy-lists>
    </contacts>
</args>

response

header

SIP-C/4.0 200 OK
I: 47
Q: 1 S
L: 108

body

<results>
    <contacts version="380941372">
        <buddy-lists>
            <buddy-list id="2"/>
        </buddy-lists>
    </contacts>
</results>

Rename A Group

header

S fetion.com.cn SIP-C/4.0
F: 111122223
I: 18 
Q: 1 S
N: SetBuddyListInfo
L: 93

body

<args>
<contacts>
    <buddy-lists>
        <buddy-list id="1" name="bar" />
    </buddy-lists>
</contacts>
</args>

response

header

SIP-C/4.0 200 OK
I: 18
Q: 1 S
L: 119

body

<results>
    <contacts version="381700582">
        <buddy-lists>
            <buddy-list id="1" name="bar" />
        </buddy-lists>
    </contacts>
</results>

Move Buddy From Group A To Group B, Update Buddy's Group ID

header

S fetion.com.cn SIP-C/4.0
F: 111122223
I: 20 
Q: 1 S
N: SetContactInfoV4
L: 81

body

<args>
<contacts>
    <contact user-id="888877770" buddy-lists="1" />
</contacts>
</args>

response

header

SIP-C/4.0 200 OK
I: 20
Q: 1 S
L: 120

body

<results>
<contacts contact-list-version="381700637">
    <contact user-id="888877770" buddy-lists="1" />
</contacts>
</results>

Move Multiple Buddies From Group A To Group B

header

S fetion.com.cn SIP-C/4.0
F: 111122223
I: 22 
Q: 1 S
N: SetContactInfoV4
L: 126

<args>
<contacts>
    <contact user-id="983617669" buddy-lists="" />
    <contact user-id="888877770" buddy-lists="" />
</contacts>
</args>

response

header

SIP-C/4.0 200 OK
I: 22
Q: 1 S
L: 165

body

<results>
    <contacts contact-list-version="381700666">
        <contact user-id="983617669" buddy-lists="" />
        <contact user-id="888877770" buddy-lists="" />
    </contacts>
</results>

Updated