Skip to content

Invite Family Member

API Address:/v2/family/enduserapi/inviteFamilyMember

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

API Description:Invite family member

Request Parameters:

Parameter NameParameter DescriptionRequest TypeRequiredData TypeSchema
fidFamily IDquerytruestring
invalidTimeInvitation expiration time, millisecond timestampquerytrueinteger(int64)
memberNameMember namequerytruestring
memberRoleFamily member role:
1-Family creator, only has this role in the family they created
2-Family administrator
3-Family regular member
querytrueinteger(int32)
acceptTimeInvitation acceptance timequeryfalsestring(date-time)
emailInvitee's emailqueryfalsestring
inviteTimeInvitation timequeryfalsestring(date-time)
phoneInvitee's phone numberqueryfalsestring
uidInvitee's uidqueryfalsestring

Response Status:

Status CodeDescriptionSchema
200Family member invitation successfulReturn registration code response data
5019Phone number format incorrect
5145Timestamp format incorrect
5636Please enter Family ID
5638Regular member has no permission
5645Please enter member role
5646Please enter expiration time
5647Expiration time cannot be earlier than current time
5648Please enter member name
5649Member name too long, please enter a name within 256 characters
5650Member name already exists, please re-enter
5651Please enter invitee information
5653User has already been invited, please do not invite again

Response Parameters:

Parameter NameParameter DescriptionTypeSchema
codeResponse status codeinteger(int32)integer(int32)
dataResponse dataobject
extMsgExtended messagestring
msgResponse messagestring

Response Example:

javascript
{
	"code": 0,
	"data": {},
	"extMsg": "",
	"msg": ""
}