Skip to content

v0.0.36

jktalk-direct-proto

jktalk/direct/v1/base.proto

ProductInfoMessage

FieldTypeLabelDescription
idstring產品行銷訊息 ID
captionstring小標
titlestring主標題
linkstring點擊後連結的網址
open_modeProductInfoMessage.OpenMode.Value點擊後的開啟方式
image_urlstring圖片網址

ProductInfoMessage.OpenMode

ProductInfoMessage.OpenMode.Value

NameNumberDescription
None0
Blank1開新網頁
Self2當前視窗

pan/auth/v1/base.proto

Auth

FieldTypeLabelDescription
pan_access_tokenstringoptional
pan_refresh_tokenstringoptional
pan_auth_tokenstringoptional
pan_app_tokenstringoptional
pkce_code_challengestringoptional
pkce_code_verifierstringoptional

pan/account/v1/member/member.proto

AddPhoneAnswer

AddPhonePayload

FieldTypeLabelDescription
pan_access_tokenstring
verify_tokenstring身份驗證token
recaptcha_tokenstringrecaptcha驗證得到的token
phonestring新電話號碼
country_codestring電話的國家分類

CredentialStatusAnswer

FieldTypeLabelDescription
recordsCredentialStatusAnswer.Recordrepeated

CredentialStatusAnswer.Record

FieldTypeLabelDescription
target_idIdentity
has_phonebool
has_emailbool
has_sec_questbool
has_passwordbool
is_virtualbool
is_main_memberbool

CredentialStatusPayload

FieldTypeLabelDescription
pan_access_tokenstring
target_idsIdentityrepeated

GetUsernamesBySessionAnswer

FieldTypeLabelDescription
namesGetUsernamesBySessionAnswer.Namerepeated

GetUsernamesBySessionAnswer.Name

FieldTypeLabelDescription
usernamestring
is_validbool
name_typeGetUsernamesBySessionAnswer.NameType

GetUsernamesBySessionPayload

FieldTypeLabelDescription
session_tokenstring

Identity

FieldTypeLabelDescription
uidint64
object_idstring
huidstring
emailstring
usernamestring
display_namestring

MemberAvatarUploaderAnswer

FieldTypeLabelDescription
signed_post_policyMemberAvatarUploaderAnswer.SignedPostPolicyEntryrepeated
url_to_uploadstring
display_image_pathstring

MemberAvatarUploaderAnswer.Error

MemberAvatarUploaderAnswer.SignedPostPolicyEntry

FieldTypeLabelDescription
keystring
valuestring

MemberAvatarUploaderPayload

FieldTypeLabelDescription
pan_access_tokenstring
image_typeMemberAvatarUploaderPayload.Image.FileType

MemberAvatarUploaderPayload.Image

MemberBasicInfoAnswer

FieldTypeLabelDescription
full_namestring
genderMemberBasicInfoAnswer.Gender.Value
birthdaygoogle.protobuf.Timestamp
salaryMemberBasicInfoAnswer.Salary.Value
professionalstring

MemberBasicInfoAnswer.Gender

MemberBasicInfoAnswer.Salary

MemberBasicInfoPayload

FieldTypeLabelDescription
pan_access_tokenstring

MemberCommandError

MemberCompanyJobInfoAnswer

FieldTypeLabelDescription
companystring
positionstring

MemberCompanyJobInfoPayload

FieldTypeLabelDescription
pan_access_tokenstring

MemberEducationInfoAnswer

FieldTypeLabelDescription
schoolstring
max_levelstring

MemberEducationInfoPayload

FieldTypeLabelDescription
pan_access_tokenstring

MemberIntroductionAnswer

FieldTypeLabelDescription
introductionstring

MemberIntroductionPayload

FieldTypeLabelDescription
pan_access_tokenstring

MemberPreferenceAnswer

FieldTypeLabelDescription
localestring

MemberPreferencePayload

FieldTypeLabelDescription
pan_access_tokenstring

MemberQueryError

MemberSocialInfoAnswer

FieldTypeLabelDescription
linestring
facebookstring
instagramstring
jvidstring
linkstring
twitterstring
tiktokstring

MemberSocialInfoPayload

FieldTypeLabelDescription
pan_access_tokenstring

MergeUsernameAnswer

MergeUsernamePayload

FieldTypeLabelDescription
session_tokenstring登入pan時產生的臨時token
usernamestring新username

MyOperationLogAnswer

FieldTypeLabelDescription
log_allOperationLogrepeated
pagerPager

MyOperationLogPayload

FieldTypeLabelDescription
pan_access_tokenstring
start_atgoogle.protobuf.Timestamp
pagerPager

OperationLog

FieldTypeLabelDescription
action_namestring
action_payloadstring
occur_dategoogle.protobuf.Timestamp

Pager

FieldTypeLabelDescription
page_currentint64
page_totalint64
page_sizeint64
item_totalint64

PhoneNumberListAnswer

error -> Internal

FieldTypeLabelDescription
recordsPhoneNumberListAnswer.Recordrepeated
default_indexint64該帳戶的默認手機號碼,默認值0
twid_verified_phone_indexint64默認值-1 (need_twid_status設為false會返回-1)

PhoneNumberListAnswer.Record

FieldTypeLabelDescription
phonestring電話號碼
phone_orderint64電話號碼升序編號,從1起算
created_atgoogle.protobuf.Timestamp電話號碼綁定時間

PhoneNumberListPayload

FieldTypeLabelDescription
pan_access_tokenstring
need_twid_statusbool是否需要標示有通過twid驗證的號碼

ResendEmailCodeAnswer

FieldTypeLabelDescription
verify_tokenstring身份驗證token

ResendEmailCodePayload

FieldTypeLabelDescription
verify_tokenstring身份驗證token

ResendSmsCodeAnswer

ResendSmsCodePayload

FieldTypeLabelDescription
pan_access_tokenstring
verify_tokenstring身份驗證token

SwitchDefaultPhoneAnswer

SwitchDefaultPhonePayload

FieldTypeLabelDescription
pan_access_tokenstringmain member only
verify_tokenstring身份驗證token
recaptcha_tokenstring驗證recaptcha得到的token
phone_orderint64要設定為默認電話的電話編號(升序,從1起算)

SwitchMainMemberAnswer

SwitchMainMemberPayload

FieldTypeLabelDescription
pan_access_tokenstring若該token並非當前主帳號則進行阻擋
uidint64新的主帳號的uid,若非當前子帳號之一則阻擋

UpdateBasicInfoPayload

FieldTypeLabelDescription
pan_access_tokenstring
basic_infoMemberBasicInfoAnswer

UpdateBasicInfoStatus

UpdateCompanyJobInfoPayload

FieldTypeLabelDescription
pan_access_tokenstring
company_jobMemberCompanyJobInfoAnswer

UpdateCompanyJobInfoStatus

UpdateEducationInfoPayload

FieldTypeLabelDescription
pan_access_tokenstring
educationMemberEducationInfoAnswer

UpdateEducationInfoStatus

UpdateEmailPayload

FieldTypeLabelDescription
pan_access_tokenstring
verify_tokenstring驗證身份的token
emailstring新信箱
redirect_urlstring信箱連結的跳轉URL
session_validstring完成recaptcha驗證的token
verify_token_typeVerifyTokenType身份驗證途徑

UpdateEmailStatus

FieldTypeLabelDescription
verify_tokenstring驗證身份的token

UpdateIntroductionPayload

FieldTypeLabelDescription
pan_access_tokenstring
introductionMemberIntroductionAnswer

UpdateIntroductionStatus

UpdatePasswordPayload

FieldTypeLabelDescription
pan_access_tokenstring
verify_tokenstring身份驗證token
passwordstring新密碼
verify_token_typeVerifyTokenType身份驗證途徑

UpdatePasswordStatus

UpdatePreferencePayload

FieldTypeLabelDescription
pan_access_tokenstring
preferenceMemberPreferenceAnswer

UpdatePreferenceStatus

UpdateSecurityQuestionPayload

FieldTypeLabelDescription
pan_access_tokenstring
verify_tokenstring身份驗證token
questionstring新提問
answerstring新答案
verify_token_typeVerifyTokenType身份驗證途徑

UpdateSecurityQuestionStatus

UpdateSocialInfoPayload

FieldTypeLabelDescription
pan_access_tokenstring
social_infoMemberSocialInfoAnswer

UpdateSocialInfoStatus

VerifyEmailCodePayload

FieldTypeLabelDescription
codestringOTP code
verify_tokenstring身份驗證token

VerifyEmailCodeStatus

VerifySmsCodeAnswer

VerifySmsCodePayload

FieldTypeLabelDescription
pan_access_tokenstring
verify_tokenstring身份驗證token
sms_codestringsms的otp code

GetUsernamesBySessionAnswer.NameType

error code -> VerificationFailed | NoNeedToProcess | Internal

NameNumberDescription
None0
Username1
DisplayName2
LegacyName3

MemberAvatarUploaderAnswer.Error.Code

NameNumberDescription
None0
Failed1001

MemberAvatarUploaderPayload.Image.FileType

NameNumberDescription
None0
Jpeg1
Png2
Gif3
Bmp4

MemberBasicInfoAnswer.Gender.Value

NameNumberDescription
None0
Male1
Female2

MemberBasicInfoAnswer.Salary.Value

NameNumberDescription
None0
Level11
Level22
Level33
Level44
Level55
Level66

MemberCommandError.Code

NameNumberDescription
None0
EmailInvalid2001信箱格式有誤
EmailDuplicated2002信箱重複
EmailUnchangeable2003信箱無變更
FailedToSendEmail2004驗證信發送失敗
ReachedEmailSendCountLimit2005驗證信發送超過次數上限
NoNeedToProcess2006不需要調用該API
SessionNotFound2007查詢不到對應verify token的session紀錄
OperatorNotMainMember2008當前操作者非主帳號
NewMainMemberInvalid2009新主帳號為無效的uid
PasswordInvalid2010密碼格式有誤
CodeInvalid2011otp code不符

MemberQueryError.Code

NameNumberDescription
None0
SessionNotFound2001查詢不到對應verify token的session紀錄
OperatorNotMainMember2002當前操作者非主帳號

VerifyTokenType

NameNumberDescription
Phone0
Password1

MemberCommand

Method NameRequest TypeResponse TypeDescription
UpdateBasicInfoUpdateBasicInfoPayloadUpdateBasicInfoStatus
UpdateSocialInfoUpdateSocialInfoPayloadUpdateSocialInfoStatus
UpdateIntroductionUpdateIntroductionPayloadUpdateIntroductionStatus
UpdateCompanyJobInfoUpdateCompanyJobInfoPayloadUpdateCompanyJobInfoStatus
UpdateEducationInfoUpdateEducationInfoPayloadUpdateEducationInfoStatus
UpdatePreferenceUpdatePreferencePayloadUpdatePreferenceStatus
UpdateEmailUpdateEmailPayloadUpdateEmailStatus更改帳號信箱
ResendEmailCodeResendEmailCodePayloadResendEmailCodeAnswer重發驗證信
VerifyEmailCodeVerifyEmailCodePayloadVerifyEmailCodeStatus驗證信箱OTP code
UpdatePasswordUpdatePasswordPayloadUpdatePasswordStatus更新密碼
UpdateSecurityQuestionUpdateSecurityQuestionPayloadUpdateSecurityQuestionStatus更新安全提問
MergeUsernameMergeUsernamePayloadMergeUsernameAnswer整合username (username升級)
SwitchMainMemberSwitchMainMemberPayloadSwitchMainMemberAnswer將某一子帳號改為主帳號
AddPhoneAddPhonePayloadAddPhoneAnswer新增電話 (只可透過手機驗證身份,如果是虛擬帳號且操作者為主帳號、可以透過帳密驗證)
ResendSmsCodeResendSmsCodePayloadResendSmsCodeAnswer重新發送SMS驗證簡訊
VerifySmsCodeVerifySmsCodePayloadVerifySmsCodeAnswer驗證SMS的OTP code,若成功會發送PhoneUpdated Pub/Sub event
SwitchDefaultPhoneSwitchDefaultPhonePayloadSwitchDefaultPhoneAnswer切換帳號默認電話,可透過手機或帳密驗證身份,若操作者非主帳號會阻擋,若成功會發送PhoneUpdated Pub/Sub event

MemberQuery

Method NameRequest TypeResponse TypeDescription
AvatarUploaderMemberAvatarUploaderPayloadMemberAvatarUploaderAnswer
BasicInfoMemberBasicInfoPayloadMemberBasicInfoAnswer
SocialInfoMemberSocialInfoPayloadMemberSocialInfoAnswer
IntroductionMemberIntroductionPayloadMemberIntroductionAnswer
CompanyJobInfoMemberCompanyJobInfoPayloadMemberCompanyJobInfoAnswer
EducationInfoMemberEducationInfoPayloadMemberEducationInfoAnswer
PreferenceMemberPreferencePayloadMemberPreferenceAnswer
MyOperationLogMyOperationLogPayloadMyOperationLogAnswer
GetUsernamesBySessionGetUsernamesBySessionPayloadGetUsernamesBySessionAnswer透過登入pan所產生的session token,得到該用戶的usernames (需完成Login phase 2驗證,且若username不需要升級會報錯)
PhoneNumberListPhoneNumberListPayloadPhoneNumberListAnswer該帳號擁有的全部電話,default_index表示結果集中「默認電話」的對應index,twid_verified_phone_index表示結果集中「有通過TWID驗證的電話」的對應index。若操作者為子帳號會遮蔽號碼中的3碼
CredentialStatusCredentialStatusPayloadCredentialStatusAnswer

jktalk/direct/v1/message.proto

ProductInfoMessagePayload

FieldTypeLabelDescription
product_info_messageProductInfoMessage商品行銷訊息
sender_identitypan.account.v1.member.Identity發送者身份
target_identitypan.account.v1.member.Identity接收者身份

ProductInfoMessageResult

FieldTypeLabelDescription
message_idstring訊息 ID

ProductInfoMessageResult.Error

ProductInfoMessageResult.Error.Code

NameNumberDescription
None0
InvalidAuth1001驗證失敗
InvalidId1002
InvalidCaption1003
InvalidTitle1004
InvalidLink1005
InvalidOpenMode1006
DuplicatedId1007產品行銷訊息 ID 重複
UnknownFailed9999未知錯誤

MessageCommand

Method NameRequest TypeResponse TypeDescription
SendProductInfoMessageProductInfoMessagePayloadProductInfoMessageResult發送商品行銷訊息

pan/account/v1/base/general.proto

App

NameNumberDescription
None0
AvPlus1
Jvid2
JkFace3
Forum4

pan/account/v1/member/base.proto

BaseInfo

FieldTypeLabelDescription
object_idstring
uidint64
huidstringhashed uid
usernamestring用戶名
display_namestring暱稱
avatarstring大頭貼路徑
emailstringoptional綁定信箱
is_activatedbool是否已被啟用
jpass_idstring= jkf_id, phone_id
is_ownerbool是否為主帳號
can_new_childbool是否可以新增子帳號
is_email_verifiedbool
last_used_atgoogle.protobuf.Timestamp最後登入時間
created_atgoogle.protobuf.Timestamp創建時間
modified_atgoogle.protobuf.Timestamp最後修改時間
is_ladybool是否為女郎
connected_appspan.account.v1.base.Apprepeated有關聯的平台

pan/account/v1/account/account.proto

AccountAddressLiving

FieldTypeLabelDescription
idstring
full_namestring
countrystring
zip_codestring
citystring
areastring
addressstring
phonestring
main_livingbool

AccountAddressLivingInfoAnswer

FieldTypeLabelDescription
address_allAccountAddressLivingrepeated

AccountAddressLivingInfoPayload

FieldTypeLabelDescription
pan_access_tokenstring

AccountAddressLivingPayload

FieldTypeLabelDescription
pan_access_tokenstring
dataAccountAddressLiving

AccountAddressShipping

FieldTypeLabelDescription
idstring
full_namestring
countrystring
zip_codestring
citystring
areastring
addressstring
phonestring
default_shippingbool

AccountAddressShippingInfoAnswer

FieldTypeLabelDescription
address_allAccountAddressShippingrepeated

AccountAddressShippingInfoPayload

FieldTypeLabelDescription
pan_access_tokenstring

AccountAddressShippingPayload

FieldTypeLabelDescription
pan_access_tokenstring
dataAccountAddressShipping

AccountBasicInfoAnswer

FieldTypeLabelDescription
full_namestring
phonestring

AccountBasicInfoPayload

FieldTypeLabelDescription
pan_access_tokenstring

ListMembersAnswer

FieldTypeLabelDescription
memberspan.account.v1.member.BaseInforepeated所有帳號的資料

ListMembersPayload

FieldTypeLabelDescription
pan_access_tokenstring

SetAddressLivingAsMainPayload

FieldTypeLabelDescription
pan_access_tokenstring
address_idstring

SetAddressLivingAsMainStatus

SetAddressShippingAsDefaultPayload

FieldTypeLabelDescription
pan_access_tokenstring
address_idstring

SetAddressShippingAsDefaultStatus

AccountCommand

Method NameRequest TypeResponse TypeDescription
SetAddressLivingAsMainSetAddressLivingAsMainPayloadSetAddressLivingAsMainStatus
SetAddressShippingAsDefaultSetAddressShippingAsDefaultPayloadSetAddressShippingAsDefaultStatus

AccountQuery

Method NameRequest TypeResponse TypeDescription
BasicInfoAccountBasicInfoPayloadAccountBasicInfoAnswerdeprecated
AddressLivingInfoAccountAddressLivingInfoPayloadAccountAddressLivingInfoAnswer
AddressShippingAccountAddressShippingInfoPayloadAccountAddressShippingInfoAnswer
ListMembersListMembersPayloadListMembersAnswer查詢指定pan_access_token的資料

AddressLivingCRUD

Method NameRequest TypeResponse TypeDescription
CreateAccountAddressLivingPayloadAccountAddressLiving
ReadAccountAddressLivingPayloadAccountAddressLiving
UpdateAccountAddressLivingPayloadAccountAddressLiving
DeleteAccountAddressLivingPayloadAccountAddressLiving

AddressShippingCRUD

Method NameRequest TypeResponse TypeDescription
CreateAccountAddressShippingPayloadAccountAddressShipping
ReadAccountAddressShippingPayloadAccountAddressShipping
UpdateAccountAddressShippingPayloadAccountAddressShipping
DeleteAccountAddressShippingPayloadAccountAddressShipping

pan/account/v1/apea/apea.proto

APEACommandError

APEAQueryError

MIDStatusRequest

FieldTypeLabelDescription
pan_access_tokenstring

MIDStatusResponse

FieldTypeLabelDescription
is_validbool身份已通過TWID驗證

ValidateMIDRequest

FieldTypeLabelDescription
pan_access_tokenstring
identitystring身分證
phone_orderint64在pan存儲的電話編號,來自PhoneNumberList

ValidateMIDResponse

APEACommandError.Code

NameNumberDescription
None0
TokenInValid2001
IdentityInValid2002
InLocked2003

APEAQueryError.Code

NameNumberDescription
None0
TokenInValid2001
IdentityInValid2002
InLocked2003

APEACommand

Method NameRequest TypeResponse TypeDescription
ValidateMIDValidateMIDRequestValidateMIDResponse以手機號碼+身份證驗證TWID

APEAQuery

Method NameRequest TypeResponse TypeDescription
MIDStatusMIDStatusRequestMIDStatusResponse查詢該pan帳號在APEA存儲的TWID驗證狀態

pan/account/v1/base/error.proto

Error

Error.Value

NameNumberDescription
None0
RecaptchaFailed1100recaptcha驗證失敗
VerifyTokenInvalid1151verify token無效
JPassTokenInvalid1152jpass domain相關token無效
AccessTokenInvalid1201pan access token無效
PhoneDuplicated1202電話號碼已被使用
PhoneFormatInvalid1203電話號碼格式錯誤
ReachedMessageLimit1204達到簡訊發送上限
VerificationFailed1205驗證失敗
NoNeedToProcess1206不需要調用該API
UsernameInvalid1207username格式有誤
UsernameDuplicated1208username已被使用
OperatorNotMainMember1209當前操作者非主帳號
MemberNotFound1210查無指定member
MemberInvalid1211member存在,但並非可操作對象
MemberDuplicated1212member關聯重複
FailedToNotifyEvent1213Pub/Sub fail
FailedToIdentifyIP1214無法解析用戶IP

pan/account/v1/friend/friendcommand.proto

AcceptFriendByPairTokenPayload

FieldTypeLabelDescription
pan_access_tokenstring接收方token
pair_tokenstring如果pair token驗證失敗,fallback會作為QR Code來驗證

AcceptFriendByPairTokenStatus

AcceptFriendByPairTokenStatus.Error

AddBlackPayload

FieldTypeLabelDescription
pan_access_tokenstring加入方token
member_idpan.account.v1.member.Identity被加入方id

AddBlackStatus

AddBlackStatus.Error

CancelFriendRequestPayload

FieldTypeLabelDescription
pan_access_tokenstring取消方token
requesterpan.account.v1.member.Identity取消方id (如果和token不符會報錯)
targetpan.account.v1.member.Identity當初收到邀請的用戶的id

CancelFriendRequestStatus

CancelFriendRequestStatus.Error

CreateFriendRequestPayload

FieldTypeLabelDescription
pan_access_tokenstring邀請方token
requesterpan.account.v1.member.Identity邀請方id (如果和token不合會報錯)
targetpan.account.v1.member.Identity被邀請方id
messagestringdeprecated

CreateFriendRequestStatus

CreateFriendRequestStatus.Error

RemoveBlackPayload

FieldTypeLabelDescription
pan_access_tokenstring解除方的token
member_idpan.account.v1.member.Identity被解除方的id

RemoveBlackStatus

RemoveBlackStatus.Error

RemoveBuddyPayload

FieldTypeLabelDescription
pan_access_tokenstring解除方的token
member_idpan.account.v1.member.Identity被解除方的id

RemoveBuddyStatus

RemoveBuddyStatus.Error

ReplyFriendRequestPayload

FieldTypeLabelDescription
pan_access_tokenstring回覆方token
requesterpan.account.v1.member.Identity回覆方id
targetpan.account.v1.member.Identity接受回覆方id
replyReplyFriendRequestPayload.Reply.Value是否同意成為好友

ReplyFriendRequestPayload.Reply

ReplyFriendRequestStatus

ReplyFriendRequestStatus.Error

AcceptFriendByPairTokenStatus.Error.Value

NameNumberDescription
None0
Failed1001
Expired1002
Invalid1003

AddBlackStatus.Error.Value

NameNumberDescription
None0
Failed1001

CancelFriendRequestStatus.Error.Value

NameNumberDescription
None0
Failed1001

CreateFriendRequestStatus.Error.Value

NameNumberDescription
None0
Failed1001

RemoveBlackStatus.Error.Value

NameNumberDescription
None0
Failed1001

RemoveBuddyStatus.Error.Value

NameNumberDescription
None0
Failed1001

ReplyFriendRequestPayload.Reply.Value

NameNumberDescription
None0
Accept1
Deny2

ReplyFriendRequestStatus.Error.Value

NameNumberDescription
None0
Failed1001

FriendCommand

Method NameRequest TypeResponse TypeDescription
RemoveBuddyRemoveBuddyPayloadRemoveBuddyStatus解除好友(如果對方是官方帳號會阻擋)
RemoveBlackRemoveBlackPayloadRemoveBlackStatus將對方從黑名單移除
AddBlackAddBlackPayloadAddBlackStatus將對方加入黑名單
CreateFriendRequestCreateFriendRequestPayloadCreateFriendRequestStatus發送好友邀請
ReplyFriendRequestReplyFriendRequestPayloadReplyFriendRequestStatus回覆好友邀請(同意或拒絕)
CancelFriendRequestCancelFriendRequestPayloadCancelFriendRequestStatus取消送出的好友邀請
AcceptFriendByPairTokenAcceptFriendByPairTokenPayloadAcceptFriendByPairTokenStatus透過pair token新增為好友

pan/account/v1/friend/friendquery.proto

Buddy

FieldTypeLabelDescription
member_idpan.account.v1.member.Identity好友id
display_namestring好友暱稱
avatarstring好友大頭貼路徑
modifiedgoogle.protobuf.Timestamp最後修改的時間
connected_atgoogle.protobuf.Timestamp成為好友(或是封鎖對方)的時間

FriendMyBlackAllAnswer

FieldTypeLabelDescription
buddy_allBuddyrepeated用戶列表
pagerPagerpagination的相關參數封裝

FriendMyBlackAllPayload

FieldTypeLabelDescription
pan_access_tokenstring
searchstring用戶暱稱的部分比對
pagerPagerpagination的相關參數封裝

FriendMyBuddyAllAnswer

FieldTypeLabelDescription
buddy_allBuddyrepeated好友列表
pagerPagerpagination的相關參數封裝

FriendMyBuddyAllPayload

FieldTypeLabelDescription
pan_access_tokenstring
searchstring用戶暱稱的部分比對
pagerPagerpagination的相關參數封裝

FriendMyBuddyByNewerDateAnswer

FieldTypeLabelDescription
buddy_allBuddyrepeated
pagerPager

FriendMyBuddyByNewerDatePayload

FieldTypeLabelDescription
pan_access_tokenstring
dategoogle.protobuf.Timestamp
pagerPager

FriendMyBuddyByOlderDateAnswer

FieldTypeLabelDescription
buddy_allBuddyrepeated
pagerPager

FriendMyBuddyByOlderDatePayload

FieldTypeLabelDescription
pan_access_tokenstring
dategoogle.protobuf.Timestamp
pagerPager

FriendMyBuddyWithFilterAnswer

FieldTypeLabelDescription
buddy_allBuddyrepeated好友列表

FriendMyBuddyWithFilterAnswer.Error

FriendMyBuddyWithFilterAnswer.IdError

查無用戶

FieldTypeLabelDescription
codeFriendMyBuddyWithFilterAnswer.IdError.Code
member_idpan.account.v1.member.Identity對方id
descriptionstring

FriendMyBuddyWithFilterAnswer.StatusError

查無好友關聯

FieldTypeLabelDescription
codeFriendMyBuddyWithFilterAnswer.StatusError.Code
member_idpan.account.v1.member.Identity對方id

FriendMyBuddyWithFilterPayload

FieldTypeLabelDescription
pan_access_tokenstring
counterpart_allpan.account.v1.member.Identityrepeated要查詢是否為好友的用戶id list

FriendMyFriendRequestStatusWithFilterAnswer

FieldTypeLabelDescription
status_allFriendRequestStatusrepeated好友邀請回覆狀態列表

FriendMyFriendRequestStatusWithFilterAnswer.Error

FriendMyFriendRequestStatusWithFilterAnswer.IdError

查無用戶

FieldTypeLabelDescription
codeFriendMyFriendRequestStatusWithFilterAnswer.IdError.Code
member_idpan.account.v1.member.Identity
descriptionstring

FriendMyFriendRequestStatusWithFilterAnswer.StatusError

查無好友邀請

FieldTypeLabelDescription
codeFriendMyFriendRequestStatusWithFilterAnswer.StatusError.Code
member_idpan.account.v1.member.Identity

FriendMyFriendRequestStatusWithFilterPayload

FieldTypeLabelDescription
pan_access_tokenstring
counterpart_allpan.account.v1.member.Identityrepeated要查詢的用戶id list

FriendMyPendingAllAnswer

FieldTypeLabelDescription
pending_allFriendRequestPendingrepeated好友邀請列表
pagerPagerpagination的相關參數封裝

FriendMyPendingAllPayload

FieldTypeLabelDescription
pan_access_tokenstring
pagerPagerpagination的相關參數封裝
searchstring用戶暱稱的部分比對

FriendMyPendingWithFilterAnswer

FieldTypeLabelDescription
pending_allFriendRequestPendingrepeated好友邀請列表

FriendMyPendingWithFilterAnswer.Error

FriendMyPendingWithFilterAnswer.IdError

查無用戶

FieldTypeLabelDescription
codeFriendMyPendingWithFilterAnswer.IdError.Code
member_idpan.account.v1.member.Identity
descriptionstring

FriendMyPendingWithFilterAnswer.StatusError

查無好友邀請

FieldTypeLabelDescription
codeFriendMyPendingWithFilterAnswer.StatusError.Code
member_idpan.account.v1.member.Identity

FriendMyPendingWithFilterPayload

FieldTypeLabelDescription
pan_access_tokenstring
counterpart_allpan.account.v1.member.Identityrepeated查詢是否有收到對方邀請的用戶id list

FriendMyRelationAnswer

FieldTypeLabelDescription
relation_allRelationStaterepeated所有關聯狀態

FriendMyRelationAnswer.Error

FriendMyRelationAnswer.IdError

查無用戶

FieldTypeLabelDescription
codeFriendMyRelationAnswer.IdError.Code
member_idpan.account.v1.member.Identity
descriptionstring

FriendMyRelationAnswer.StatusError

查無操作者資料(pan access token無效)

FieldTypeLabelDescription
codeFriendMyRelationAnswer.StatusError.Code
member_idpan.account.v1.member.Identity

FriendMyRelationPayload

FieldTypeLabelDescription
pan_access_tokenstring
counterpart_allpan.account.v1.member.Identityrepeated要查詢的用戶id list

FriendMyRelationStatusAnswer

FieldTypeLabelDescription
friend_countint64好友總數

FriendMyRelationStatusAnswer.Error

FriendMyRelationStatusPayload

FieldTypeLabelDescription
pan_access_tokenstring

FriendRequestPending

FieldTypeLabelDescription
requesterpan.account.v1.member.Identity發出好友邀請者的id
targetpan.account.v1.member.Identity收到好友邀請者的id
createdgoogle.protobuf.Timestamp邀請的發送時間
modifiedgoogle.protobuf.Timestamp邀請的最後修改時間

FriendRequestStatus

FieldTypeLabelDescription
requesterpan.account.v1.member.Identity發出好友邀請者
targetpan.account.v1.member.Identity收到好友邀請者
stateFriendRequestStatus.State.Value回覆狀態
createdgoogle.protobuf.Timestamp邀請發出的時間

FriendRequestStatus.State

MyFriendPairTokenAnswer

FieldTypeLabelDescription
pair_tokenstring

MyFriendPairTokenAnswer.Error

MyFriendPairTokenPayload

FieldTypeLabelDescription
pan_access_tokenstring

Pager

FieldTypeLabelDescription
page_currentint64
page_totalint64
page_sizeint64
item_totalint64
sortPager.Sort

RelationState

FieldTypeLabelDescription
member_idpan.account.v1.member.Identity該用戶的id
is_friendbool是好友
is_blackbool已加入黑名單

FriendMyBuddyWithFilterAnswer.Error.Code

NameNumberDescription
None0
Failed1001

FriendMyBuddyWithFilterAnswer.IdError.Code

NameNumberDescription
None0
NotFound1001
Failed1002

FriendMyBuddyWithFilterAnswer.StatusError.Code

NameNumberDescription
None0
NotFound1001
Failed1002

FriendMyFriendRequestStatusWithFilterAnswer.Error.Code

NameNumberDescription
None0
Failed1001

FriendMyFriendRequestStatusWithFilterAnswer.IdError.Code

NameNumberDescription
None0
NotFound1001
Failed1002

FriendMyFriendRequestStatusWithFilterAnswer.StatusError.Code

NameNumberDescription
None0
NotFound1001
Failed1002

FriendMyPendingWithFilterAnswer.Error.Code

NameNumberDescription
None0
Failed1001

FriendMyPendingWithFilterAnswer.IdError.Code

NameNumberDescription
None0
NotFound1001
Failed1002

FriendMyPendingWithFilterAnswer.StatusError.Code

NameNumberDescription
None0
NotFound1001
Failed1002

FriendMyRelationAnswer.Error.Code

NameNumberDescription
None0
Failed1001

FriendMyRelationAnswer.IdError.Code

NameNumberDescription
None0
NotFound1001
Failed1002

FriendMyRelationAnswer.StatusError.Code

NameNumberDescription
None0
NotFound1001
Failed1002

FriendMyRelationStatusAnswer.Error.Code

NameNumberDescription
None0
Failed1001

FriendRequestStatus.State.Value

NameNumberDescription
None0
Sent1
Pending2
Rejected3
Accepted4

MyFriendPairTokenAnswer.Error.Code

NameNumberDescription
None0
Failed1001

Pager.Sort

NameNumberDescription
ASC0
DESC1

FriendQuery

Method NameRequest TypeResponse TypeDescription
MyBuddyAllFriendMyBuddyAllPayloadFriendMyBuddyAllAnswer查詢所有好友
MyBuddyWithFilterFriendMyBuddyWithFilterPayloadFriendMyBuddyWithFilterAnswer查詢指定名單是否皆為好友(如果其中有任一用戶不存在、或不為好友,即報錯)
MyBlackAllFriendMyBlackAllPayloadFriendMyBlackAllAnswer查詢所有已加入黑名單的用戶
MyPendingAllFriendMyPendingAllPayloadFriendMyPendingAllAnswer查詢收到的所有好友邀請
MyPendingWithFilterFriendMyPendingWithFilterPayloadFriendMyPendingWithFilterAnswer查詢指定名單是否皆有發送好友邀請給自己(如果其中有任一用戶不存在、或沒有發送邀請給自己,即報錯)
MyRelationFriendMyRelationPayloadFriendMyRelationAnswer查詢指定名單是否為好友或已加入黑名單的用戶
MyRelationStatusFriendMyRelationStatusPayloadFriendMyRelationStatusAnswer查詢好友總數
MyBuddyByNewerDateFriendMyBuddyByNewerDatePayloadFriendMyBuddyByNewerDateAnswer查詢所有好友中「用戶資料的最後修改時間」在指定時間之後的用戶(sort by asc)
MyBuddyByOlderDateFriendMyBuddyByOlderDatePayloadFriendMyBuddyByOlderDateAnswer查詢所有好友中「用戶資料的最後修改時間」在指定時間之前的用戶(sort by desc)
MyFriendRequestStatusWithFilterFriendMyFriendRequestStatusWithFilterPayloadFriendMyFriendRequestStatusWithFilterAnswer查詢針對指定名單,自己發出的好友邀請的回覆狀態(如果其中有任一用戶不存在、或沒有發送邀請給對方,即報錯)
MyFriendPairTokenMyFriendPairTokenPayloadMyFriendPairTokenAnswer用自己的access token創建一個pair token (HS256 in JWT, token ttl = 10min. secret key ttl = 11min)

pan/account/v1/general/general.proto

GeneralCommandError

UnlockSessionTokenAnswer

UnlockSessionTokenPayload

FieldTypeLabelDescription
session_tokenstring要解除鎖定的session token
session_validstringrecaptcha驗證後生成的token
platformUnlockSessionTokenPayload.Platform目標裝置

GeneralCommandError.Code

NameNumberDescription
None0

UnlockSessionTokenPayload.Platform

NameNumberDescription
WEB0
IOS1
ANDROID2

GeneralCommand

Method NameRequest TypeResponse TypeDescription
UnlockSessionTokenUnlockSessionTokenPayloadUnlockSessionTokenAnswer解除session token的鎖定狀態(需要先完成recaptcha驗證)

pan/account/v1/jpass/jpass_upgrader_command.proto

FinishUpgradeAnswer

FieldTypeLabelDescription
phone_idstring生成或綁定的phone_id
object_idstring生成或綁定的object_id
uidint64生成或綁定的uid

FinishUpgradePayload

FieldTypeLabelDescription
jpass_upgrade_tokenstring必填。jpass升級token
pan_access_tokenstring選填。當user選擇「已有JKF帳號才需要」。
object_idstring選填。member的object_id,當user選擇「已有JKF帳號才需要」。

JpassUpgraderCommandError

JpassUpgraderCommandError.Code

NameNumberDescription
None0
JPassTokenInvalid2001jpass domain相關token無效
MemberInvalid2002member存在,但並非可操作對象
MemberDuplicated2003member關聯重複

JpassUpgraderCommand

Method NameRequest TypeResponse TypeDescription
FinishUpgradeFinishUpgradePayloadFinishUpgradeAnswer接收由pan-direct-api.CreateJpassUpgradeToken創建的jut,加上用戶登入後收到的pan access token,完成jpass升級流程

pan/account/v1/platform/platform.proto

App

FieldTypeLabelDescription
idstring
display_namestring
iconstring
coverstring

ApplicationListAnswer

FieldTypeLabelDescription
record_allApplicationListAnswer.Recordrepeated

ApplicationListAnswer.Record

FieldTypeLabelDescription
app_idstring平台id
app_display_namestring平台名稱
uidint64用戶uid
registered_dategoogle.protobuf.Timestamp註冊時間

ApplicationListPayload

FieldTypeLabelDescription
pan_access_tokenstring

Error

PlatformOffAppAllAnswer

FieldTypeLabelDescription
app_allApprepeated

PlatformOffAppAllPayload

FieldTypeLabelDescription
pan_access_tokenstring

PlatformOnAppAllAnswer

FieldTypeLabelDescription
app_allApprepeated

PlatformOnAppAllPayload

FieldTypeLabelDescription
pan_access_tokenstring

PlatformQuery

Method NameRequest TypeResponse TypeDescription
OnAppAllPlatformOnAppAllPayloadPlatformOnAppAllAnswer
OffAppAllPlatformOffAppAllPayloadPlatformOffAppAllAnswer
ApplicationListApplicationListPayloadApplicationListAnswer查詢自己有被授權使用的所有平台列表

pan/account/v1/security/loginlog.proto

LoginDevice

FieldTypeLabelDescription
object_idstring
member_idstring
app_idstring
ip_addressstring
user_agentstring
expiregoogle.protobuf.Timestamp
modifiedgoogle.protobuf.Timestamp
nationstring
citystring

LoginLogCommandError

LoginLogDeviceSomeAnswer

FieldTypeLabelDescription
device_allLoginDevicerepeated

LoginLogDeviceSomePayload

FieldTypeLabelDescription
pan_access_tokenstring

LogoutAllDeviceAnswer

LogoutAllDevicePayload

FieldTypeLabelDescription
pan_access_tokenstring移除該access_token之member的所有登入紀錄
check_onlybool若為true則檢查工作是否in progress,若是則拋錯

LoginLogCommandError.Code

NameNumberDescription
None0
InProgress2001刪除作業執行中

LoginLogCommand

Method NameRequest TypeResponse TypeDescription
LogoutAllDeviceLogoutAllDevicePayloadLogoutAllDeviceAnswer登出該帳號所有裝置

LoginLogQuery

Method NameRequest TypeResponse TypeDescription
DeviceSomeLoginLogDeviceSomePayloadLoginLogDeviceSomeAnswer

pan/account/v1/security/onetimecode.proto

OneTimeCodeCommand

rpc SetEmail(SetEmailPayload) returns (SetEmailStatus);

Method NameRequest TypeResponse TypeDescription

pan/account/v1/subscription/subscription.proto

AvailablePlanAllAnswer

FieldTypeLabelDescription
plansPlanrepeated

AvailablePlanAllPayload

FieldTypeLabelDescription
pan_access_tokenstring

Plan

FieldTypeLabelDescription
app_namestring產品名稱
plan_namestring方案名稱
plan_descstring方案描述
plan_icon_urlstring方案icon的URL
plan_site_urlstring產品端對應該方案的網址
has_subscribedbool該帳號是否已訂閱此方案
subscribed_atgoogle.protobuf.Timestamp訂閱時間

ServiceItem

FieldTypeLabelDescription
idstring
display_namestring
iconstring
coverstring

SubscriptionOffServiceItemAllAnswer

FieldTypeLabelDescription
service_item_allServiceItemrepeated

SubscriptionOffServiceItemAllPayload

FieldTypeLabelDescription
pan_access_tokenstring

SubscriptionOnServiceItemAllAnswer

FieldTypeLabelDescription
service_item_allServiceItemrepeated

SubscriptionOnServiceItemAllPayload

FieldTypeLabelDescription
pan_access_tokenstring

SubscriptionQuery

Method NameRequest TypeResponse TypeDescription
OnServiceItemAllSubscriptionOnServiceItemAllPayloadSubscriptionOnServiceItemAllAnswer
OffServiceItemAllSubscriptionOffServiceItemAllPayloadSubscriptionOffServiceItemAllAnswer
AvailablePlanAllAvailablePlanAllPayloadAvailablePlanAllAnswer產品端訂閱方案一覽

pan/account/v2/base/base.proto

Page

FieldTypeLabelDescription
sizeint32單頁資料筆數
numberint32第幾頁
total_countint64資料總計筆數

pan/account/v2/base/error.proto

Error

MemberQueryError

Error.Code

NameNumberDescription
None0
PanAccessTokenInvalid1201
PinnedFriendOverLimit1202

MemberQueryError.Code

NameNumberDescription
None0
UidInvalid1301

pan/account/v2/base/friend.proto

Friend

Friend.Reply

Friend.Reply.Status

NameNumberDescription
None0
Accept1
Reject2

pan/account/v2/base/member.proto

MemberBaseInfo

FieldTypeLabelDescription
object_idstring
uidint64
huidstringhashed uid
usernamestring用戶名
display_namestring暱稱
avatarstring大頭貼路徑
emailstringoptional綁定信箱
is_activatedbool是否已被啟用
jpass_idstringaka jkf_id, phone_id
is_mainbool是否為主帳號
can_new_childbool是否可以新增子帳號
is_email_verifiedbool
last_used_atgoogle.protobuf.Timestamp最後登入時間
created_atgoogle.protobuf.Timestamp創建時間
modified_atgoogle.protobuf.Timestamp最後修改時間
connected_appsstringrepeated有關聯的平台; app_id array

pan/account/v2/base/meta.proto

Achievement

Achievement consists of Type(Title), Label(Achievement), Relation(J_TAGGED_AS)

FieldTypeLabelDescription
issuer_jpass_idstring稱號發行者
issued_atgoogle.protobuf.Timestamp稱號發行時間
qualificationsQualificationrepeated稱號資格條件
typeAchievement.Type.Value稱號類型
labelstring稱號名稱
part_levelAchievement.PartLevel.Value稱號等級
seriesSeries系列資料

Achievement.PartLevel

Achievement.Type

DisplayTitle

FieldTypeLabelDescription
dataAchievement稱號資料
qualifiedQualified使用者獲得稱號的原因

DisplayTitleArray

FieldTypeLabelDescription
titlesDisplayTitlerepeated

Qualification

FieldTypeLabelDescription
qualification_idstring
app_idstring
app_display_namestring
reasonstring

Qualified

FieldTypeLabelDescription
qualification_idstring
attained_atgoogle.protobuf.Timestamp
revoked_atgoogle.protobuf.Timestamp

Series

FieldTypeLabelDescription
series_idstring
series_display_namestring

Achievement.PartLevel.Value

NameNumberDescription
None0
Red1
White2
Gold3
Rainbow4

Achievement.Type.Value

NameNumberDescription
None0
FirstPart1
SecondPart2

pan/account/v2/base/user.proto

User

User.Type

NameNumberDescription
None0
General1
Business2
Official3
Superstar4JvidModel, Lady, Actress

pan/account/v2/friend/command.proto

BlockAnswer

FieldTypeLabelDescription
resultsResultrepeated
all_successbool全部操作皆成功

BlockPayload

FieldTypeLabelDescription
pan_access_tokenstring
target_hashed_uidsstringrepeated要封鎖的好友pan hashed uid

ConfirmAllInvitationAnswer

ConfirmAllInvitationPayload

FieldTypeLabelDescription
pan_access_tokenstring同意該access_token之member的所有好友邀請
check_onlybool若為true則檢查工作是否in progress,若是則拋錯

FriendCommandError

HideAnswer

FieldTypeLabelDescription
resultsResultrepeated
all_successbool全部操作皆成功

HidePayload

FieldTypeLabelDescription
pan_access_tokenstring
target_hashed_uidsstringrepeated要隱藏的好友pan hashed uid

PinAnswer

FieldTypeLabelDescription
resultsResultrepeated
all_successbool全部操作皆成功

PinPayload

FieldTypeLabelDescription
pan_access_tokenstring
target_hashed_uidsstringrepeated要釘選的好友pan hashed uid

Result

FieldTypeLabelDescription
hashed_uidstring操作對象的pan hashed uid
successbool操作結果是否成功
reasonstring失敗理由。若success = true則reason為空

UnBlockAnswer

FieldTypeLabelDescription
resultsResultrepeated
all_successbool全部操作皆成功

UnBlockPayload

FieldTypeLabelDescription
pan_access_tokenstring
target_hashed_uidsstringrepeated要解除封鎖的好友pan hashed uid

UnHideAnswer

FieldTypeLabelDescription
resultsResultrepeated
all_successbool全部操作皆成功

UnHidePayload

FieldTypeLabelDescription
pan_access_tokenstring
target_hashed_uidsstringrepeated要解除隱藏的好友pan hashed uid

UnPinAnswer

FieldTypeLabelDescription
resultsResultrepeated
all_successbool全部操作皆成功

UnPinPayload

FieldTypeLabelDescription
pan_access_tokenstring
target_hashed_uidsstringrepeated要解除釘選的好友pan hashed uid

FriendCommandError.Code

NameNumberDescription
None0
InProgress2001作業執行中

FriendCommand

Method NameRequest TypeResponse TypeDescription
PinPinPayloadPinAnswer釘選好友 累計不可超過20個釘選,會同時解除hide
UnPinUnPinPayloadUnPinAnswer解除釘選好友 單次操作最多20筆
BlockBlockPayloadBlockAnswer封鎖好友 單次操作最多20筆,會同時解除pin並且hide
UnBlockUnBlockPayloadUnBlockAnswer解除封鎖好友 單次操作最多20筆,會同時解除hide
HideHidePayloadHideAnswer隱藏好友 單次操作最多20筆,會解除pin
UnHideUnHidePayloadUnHideAnswer解除隱藏好友 單次操作最多20筆
ConfirmAllInvitationConfirmAllInvitationPayloadConfirmAllInvitationAnswer同意所有好友邀請

pan/account/v2/friend/query.proto

BlockedListAnswer

FieldTypeLabelDescription
friendsFriendrepeated
pagepan.account.v2.base.Page

BlockedListAnswer.Record

有效欄位的參考,實際使用Friend

FieldTypeLabelDescription
hashed_uidstring
display_namestring
avatarstring
user_typepan.account.v2.base.User.Typerepeated
is_pinnedbool

BlockedListPayload

FieldTypeLabelDescription
pan_access_tokenstring
pagepan.account.v2.base.Pagepage和size不可小於1

Friend

FieldTypeLabelDescription
hashed_uidstringpan的hashed uid
uidint64pan的uid
display_namestringpan的display name
avatarstringpan的大頭貼url
typepan.account.v2.base.User.Typerepeated該用戶擁有的身份
is_friendbool和查詢者是好友
is_pinnedbool被查詢者釘選
is_blockedbool被查詢者封鎖
is_hiddenbool被查詢者隱藏

FriendCountAnswer

FieldTypeLabelDescription
countint64

FriendCountPayload

FieldTypeLabelDescription
pan_access_tokenstring

FriendListAnswer

FieldTypeLabelDescription
uid_match_friendFriendpayload中page number是1且search是uid才會有值
friendsFriendrepeated
pagepan.account.v2.base.Page

FriendListAnswer.Record

有效欄位的參考,實際使用Friend

FieldTypeLabelDescription
hashed_uidstring
uidint64
display_namestring
avatarstring
typepan.account.v2.base.User.Typerepeated
is_friendbool
is_pinnedbool
is_blockedbool
is_hiddenbool

FriendListPayload

FieldTypeLabelDescription
pan_access_tokenstring
pagepan.account.v2.base.Pagepage和size不可小於1
searchstring部分比對display_name。如果page = 1,會同時作為uid來完全比對,uid查詢結果為uid_match_friend
start_after_huidstring若不為空則優先於page
end_before_huidstring分頁用,start_after_huid和end_before_huid不可同時存在

FriendStatusAnswer

FieldTypeLabelDescription
relation_pairFriendStatusAnswer.Relationrepeatedex: from_huid = 123, to_huid = 456, status = WaitingReply -> 123已發出好友邀請給456 ex: from_huid = 123, to_huid = 456, status = Rejected -> 123發出好友邀請給456,但已被456拒絕

FriendStatusAnswer.Relation

FieldTypeLabelDescription
from_huidstring狀態發起方 (action的主詞)
to_huidstring狀態接受方 (action的受詞)
statusFriendStatusAnswer.FriendStatus好友狀態 (action)

FriendStatusPayload

FieldTypeLabelDescription
pan_access_tokenstring
target_hashed_uidstring查詢對象的pan hashed uid

HiddenListAnswer

FieldTypeLabelDescription
friendsFriendrepeated
pagepan.account.v2.base.Page

HiddenListAnswer.Record

有效欄位的參考,實際使用Friend

FieldTypeLabelDescription
hashed_uidstring
display_namestring
avatarstring
user_typepan.account.v2.base.User.Typerepeated

HiddenListPayload

FieldTypeLabelDescription
pan_access_tokenstring
pagepan.account.v2.base.Pagepage和size不可小於1

JkTalkUserInfosAnswer

FieldTypeLabelDescription
friendsFriendrepeated

JkTalkUserInfosAnswer.Record

有效欄位的參考,實際使用Friend

FieldTypeLabelDescription
hashed_uidstring
display_namestring
avatarstring
typepan.account.v2.base.User.Typerepeated
is_friendbool
is_pinnedbool
is_blockedbool
is_hiddenbool

JkTalkUserInfosPayload

FieldTypeLabelDescription
pan_access_tokenstring
hashed_uidsstringrepeated上限100,如果為空則是查自己

FriendStatusAnswer.FriendStatus

NameNumberDescription
None0
WaitingReply2已發出邀請,等待回覆中
Rejected3發出的邀請已被拒絕
IsFriend4是好友

FriendQuery

Method NameRequest TypeResponse TypeDescription
FriendListFriendListPayloadFriendListAnswer查詢好友列表 有釘選的先置頂。被釘選的好友中,官方帳號會置頂。其餘非釘選帳號中,官方帳號也會置頂。
BlockedListBlockedListPayloadBlockedListAnswer查詢已封鎖用戶列表
HiddenListHiddenListPayloadHiddenListAnswer查詢已隱藏好友列表
JkTalkUserInfosJkTalkUserInfosPayloadJkTalkUserInfosAnswer查詢指定用戶的「好友狀態」和「身份」

查是否為好友 (放pan-account) | | FriendStatus | FriendStatusPayload | FriendStatusAnswer | 查詢與指定用戶的「雙向好友狀態」

查單人 (放pan-account) | | FriendCount | FriendCountPayload | FriendCountAnswer | |

pan/account/v2/member/query.proto

DisplayTitlesAnswer

FieldTypeLabelDescription
title_mapDisplayTitlesAnswer.TitleMapEntryrepeated該用戶擁有的稱號, int64: uid

DisplayTitlesAnswer.TitleMapEntry

FieldTypeLabelDescription
keyint64
valuepan.account.v2.base.DisplayTitleArray

DisplayTitlesPayload

FieldTypeLabelDescription
pan_access_tokenstring品牌發行者
uidsint64repeated查詢 uid 是否持有稱號
app_idstringpan application id

IssuedTitlesAnswer

FieldTypeLabelDescription
title_mapIssuedTitlesAnswer.TitleMapEntryrepeated該用戶擁有的稱號, int64: uid

IssuedTitlesAnswer.TitleMapEntry

FieldTypeLabelDescription
keyint64
valuepan.account.v2.base.DisplayTitleArray

IssuedTitlesPayload

FieldTypeLabelDescription
pan_access_tokenstring品牌發行者
series_idstring系列 ID
uidsint64repeated查詢 uid 是否持有稱號

JkcMemberAuthTokenAnswer

FieldTypeLabelDescription
short_lived_auth_tokenstring

JkcMemberAuthTokenPayload

FieldTypeLabelDescription
app_idstringpan application id
pan_access_tokenstring
target_object_idstring切換帳號的 pan.members.object_id

JkcMemberListAnswer

FieldTypeLabelDescription
member_listpan.account.v2.base.MemberBaseInforepeatedJKC 專屬特規子帳號列表

JkcMemberListPayload

FieldTypeLabelDescription
app_idstringpan application id
pan_access_tokenstring

MemberQuery

Method NameRequest TypeResponse TypeDescription
DisplayTitlesDisplayTitlesPayloadDisplayTitlesAnswer查詢指定 uid 持有的稱號
IssuedTitlesIssuedTitlesPayloadIssuedTitlesAnswer查詢指定系列和指定 uid 持有的發行稱號
JkcMemberAuthTokenJkcMemberAuthTokenPayloadJkcMemberAuthTokenAnswerJKC 專屬特規切換帳號
JkcMemberListJkcMemberListPayloadJkcMemberListAnswerJKC 專屬特規查詢子帳號列表

Scalar Value Types

.proto TypeNotesC++JavaPythonGoC#PHPRuby
doubledoubledoublefloatfloat64doublefloatFloat
floatfloatfloatfloatfloat32floatfloatFloat
int32Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead.int32intintint32intintegerBignum or Fixnum (as required)
int64Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead.int64longint/longint64longinteger/stringBignum
uint32Uses variable-length encoding.uint32intint/longuint32uintintegerBignum or Fixnum (as required)
uint64Uses variable-length encoding.uint64longint/longuint64ulonginteger/stringBignum or Fixnum (as required)
sint32Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s.int32intintint32intintegerBignum or Fixnum (as required)
sint64Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s.int64longint/longint64longinteger/stringBignum
fixed32Always four bytes. More efficient than uint32 if values are often greater than 2^28.uint32intintuint32uintintegerBignum or Fixnum (as required)
fixed64Always eight bytes. More efficient than uint64 if values are often greater than 2^56.uint64longint/longuint64ulonginteger/stringBignum
sfixed32Always four bytes.int32intintint32intintegerBignum or Fixnum (as required)
sfixed64Always eight bytes.int64longint/longint64longinteger/stringBignum
boolboolbooleanbooleanboolboolbooleanTrueClass/FalseClass
stringA string must always contain UTF-8 encoded or 7-bit ASCII text.stringStringstr/unicodestringstringstringString (UTF-8)
bytesMay contain any arbitrary sequence of bytes.stringByteStringstr[]byteByteStringstringString (ASCII-8BIT)