API 文档

Service(v2) – Opportunity Push Data

关于Service V2的Opportunity(商机)接口的socket.io推送消息。

Namespace

servicev2

Base

NameValueDescNotes
eventstring推送事件类型。
roomstring推送房间。均以“private”或“public”开头,并且以“-”做为分隔符。
datadict推送数据内容。根据对应事件,推送不同的数据。

Room

private-service-opportunity

当前用户需要join room的时候,前端按照以上房间名使用户加入到Opportunity的推送房间。

注意:这里目前后端还没想好如何解决分流的问题,一旦加入该房间的用户数量过大时,有可能发生雪崩情况,前端这里尽量先做一下灵活处理,发现用户不需要收听该房间的信息时,就自动退出该房间。

Event

1.触发点:当某个商机(服务需求)已到达截止时间或发布者关闭了该商机:

事件名:

service.opportunity.demand_close

推送数据如下:

NameValueDescNotes
demanddict服务需求数据
— idinteger服务需求的ID
— statusstring服务需求的状态,该值一定为closed

2.触发点:当商机(服务需求)的发起人选出了优胜者:

Service(v2) – Demand Push Data

关于Service V2的Demand(服务需求)接口的socket.io推送消息。

Namespace

servicev2

Base

NameValueDescNotes
eventstring推送事件类型。
roomstring推送房间。均以“private”或“public”开头,并且以“-”做为分隔符。
datadict推送数据内容。根据对应事件,推送不同的数据。

Room

private-service-demand-{用户uid}

当前用户需要join room的时候,前端按照以上房间名格式使用户加入到demand的推送房间。

Event

1.触发点:当其他用户提交竞标出价(submit-bid)后:

事件名:

如果该用户是新的竞标者:
service.demand.new_participant

如果该用户之前已提交过竞标出价,这次是更新出价:
service.demand.new_bid

无论是新竞标者还是更新出价,推送数据如下:

NameValueDescNotes
demanddict服务需求数据
— idinteger服务需求的ID
— titlestring服务需求的标题
participantdict竞标者数据
— userdict竞标者的用户数据
—- uidinteger竞标者的用户UID
—- usernamestring竞标者的用户姓名
— bid_pricestring竞标者本次提交的价格,比如”10.23″

2.触发点:竞标者退出了竞争(在reaction接口中选择了`abandon`)

事件名:

service.demand.participant_abandon

推送数据如下:

NameValueDescNotes
demanddict服务需求数据
— idinteger服务需求的ID
— titlestring服务需求的标题
participantdict竞标者数据
— userdict竞标者的用户数据
—- uidinteger竞标者的用户UID
—- usernamestring竞标者的用户姓名