Skip to content

Data Store Protocol

Yannik Marchand edited this page Dec 26, 2023 · 19 revisions

NEX Protocols > Data Store (115)

The following games have additional methods in the datastore protocol:

This remainder of this page describes the methods that are not specific to any game.

Method ID Method Name
1 PrepareGetObjectV1
2 PreparePostObjectV1
3 CompletePostObjectV1
4 DeleteObject
5 DeleteObjects
6 ChangeMetaV1
7 ChangeMetasV1
8 GetMeta
9 GetMetas
10 PrepareUpdateObject
11 CompleteUpdateObject
12 SearchObject
13 GetNotificationUrl
14 GetNewArrivedNotificationsV1
15 RateObject
16 GetRating
17 GetRatings
18 ResetRating
19 ResetRatings
20 GetSpecificMetaV1
21 PostMetaBinary
22 TouchObject
23 GetRatingWithLog
24 PreparePostObject
25 PrepareGetObject
26 CompletePostObject
27 GetNewArrivedNotifications
28 GetSpecificMeta
29 GetPersistenceInfo
30 GetPersistenceInfos
31 PerpetuateObject
32 UnperpetuateObject
33 PrepareGetObjectOrMetaBinary
34 GetPasswordInfo
35 GetPasswordInfos
36 GetMetasMultipleParam
37 CompletePostObjects
38 ChangeMeta
39 ChangeMetas
40 RateObjects
41 PostMetaBinaryWithDataId
42 PostMetaBinariesWithDataId
43 RateObjectWithPosting
44 RateObjectsWithPosting
45 GetObjectInfos
46 SearchObjectLight

(1) PrepareGetObjectV1

Request

Type Name
DataStorePrepareGetParamV1 param

Response

Type Name
DataStoreReqGetInfoV1 pReqGetInfo

(2) PreparePostObjectV1

Request

Type Name
DataStorePreparePostParamV1 param

Response

Type Name
DataStoreReqPostInfoV1 pReqPostInfo

(3) CompletePostObjectV1

Request

Type Name
DataStoreCompletePostParamV1 param

Response

This method does not return anything.

(4) DeleteObject

Request

Type Name
DataStoreDeleteParam param

Response

This method does not return anything.

(5) DeleteObjects

Request

Type Name
List<DataStoreDeleteParam> params
Bool transactional

Response

Type Name
List<Result> pResults

(6) ChangeMetaV1

Request

Type Name
DataStoreChangeMetaParamV1 param

Response

This method does not return anything.

(7) ChangeMetasV1

Request

Type Name
List<Uint64> dataIds
List<DataStoreChangeMetaParamV1> params
Bool transactional

Response

Type Name
List<Result> pResults

(8) GetMeta

Request

Type Name
DataStoreGetMetaParam param

Response

Type Name
DataStoreMetaInfo pMetaInfo

(9) GetMetas

Request

Type Name
List<Uint64> dataIds
DataStoreGetMetaParam param

Response

Type Name
List<DataStoreMetaInfo> pMetaInfo
List<Result> pResults

(10) PrepareUpdateObject

Request

Type Name
DataStorePrepareUpdateParam param

Response

Type Name
DataStoreReqUpdateInfo pReqUpdateInfo

(11) CompleteUpdateObject

Request

Type Name
DataStoreCompleteUpdateParam param

Response

This method does not return anything.

(12) SearchObject

Request

Type Name
DataStoreSearchParam param

Response

Type Name
DataStoreSearchResult pSearchResult

(13) GetNotificationUrl

Request

Type Name
DataStoreGetNotificationUrlParam param

Response

Type Name
DataStoreReqGetNotificationUrlInfo info

(14) GetNewArrivedNotificationsV1

Request

Type Name
DataStoreGetNewArrivedNotificationsParam param

Response

Type Name
List<DataStoreNotificationV1> pResult
Bool pHasNext

(15) RateObject

Request

Type Name
DataStoreRatingTarget target
DataStoreRateObjectParam param
Bool fetchRatings

Response

Type Name
DataStoreRatingInfo pRating

(16) GetRating

Request

Type Name
DataStoreRatingTarget target
Uint64 accessPassword

Response

Type Name
DataStoreRatingInfo pRating

(17) GetRatings

Request

Type Name
List<Uint64> dataIds
Uint64 accessPassword

Response

Type Name
List<List<DataStoreRatingInfoWithSlot>> pRatings
List<Result> pResults

(18) ResetRating

Request

Type Name
DataStoreRatingTarget target
Uint64 updatePassword

Response

This method does not return anything.

(19) ResetRatings

Request

Type Name
List<Uint64> dataIds
Bool transactional

Response

Type Name
List<Result> pResults

(20) GetSpecificMetaV1

Request

Type Name
DataStoreGetSpecificMetaParamV1 param

Response

Type Name
List<DataStoreSpecificMetaInfoV1> pMetaInfos

(21) PostMetaBinary

Request

Type Name
DataStorePreparePostParam param

Response

Type Name
Uint64 dataId

(22) TouchObject

Request

Type Name
DataStoreTouchObjectParam param

Response

This method does not return anything.

(23) GetRatingWithLog

Request

Type Name
DataStoreRatingTarget target
Uint64 accessPassword

Response

Type Name
DataStoreRatingInfo pRating
DataStoreRatingLog pRatingLog

(24) PreparePostObject

Request

Type Name
DataStorePreparePostParam param

Response

Type Name
DataStoreReqPostInfo pReqPostInfo

(25) PrepareGetObject

Request

Type Name
DataStorePrepareGetParam param

Response

Type Name
DataStoreReqGetInfo pReqGetInfo

(26) CompletePostObject

Request

Type Name
DataStoreCompletePostParam param

Response

This method does not return anything.

(27) GetNewArrivedNotifications

Request

Type Name
DataStoreGetNewArrivedNotificationsParam param

Response

Type Name
List<DataStoreNotification> pResult
Bool pHasNext

(28) GetSpecificMeta

Request

Type Name
DataStoreGetSpecificMetaParam param

Response

Type Name
List<DataStoreSpecificMetaInfo> pMetaInfos

(29) GetPersistenceInfo

Request

Type Name
PID ownerId
Uint16 persistenceSlotId

Response

Type Name
DataStorePersistenceInfo pPersistenceInfo

(30) GetPersistenceInfos

Request

Type Name
PID ownerId
List<Uint16> persistenceSlotIds

Response

Type Name
List<DataStorePersistenceInfo> pPersistenceInfo
List<Result> pResults

(31) PerpetuateObject

Request

Type Name
Uint16 persistenceSlotId
Uint64 dataId
Bool deleteLastObject

Response

This method does not return anything.

(32) UnperpetuateObject

Request

Type Name
Uint16 persistenceSlotId
Bool deleteLastObject

Response

This method does not return anything.

(33) PrepareGetObjectOrMetaBinary

Request

Type Name
DataStorePrepareGetParam param

Response

Type Name
DataStoreReqGetInfo pReqGetInfo
DataStoreReqGetAdditionalMeta pReqGetAdditionalMeta

(34) GetPasswordInfo

Request

Type Name
Uint64 dataId

Response

Type Name
DataStorePasswordInfo pPasswordInfo

(35) GetPasswordInfos

Request

Type Name
List<Uint64> dataIds

Response

Type Name
List<DataStorePasswordInfo> pPasswordInfos
List<Result> pResults

(36) GetMetasMultipleParam

Request

Type Name
List<DataStoreGetMetaParam> params

Response

Type Name
List<DataStoreMetaInfo> pMetaInfo
List<Result> pResults

(37) CompletePostObjects

Request

Type Name
List<Uint64> dataIds

Response

This method does not return anything.

(38) ChangeMeta

Request

Type Name
DataStoreChangeMetaParam param

Response

This method does not return anything.

(39) ChangeMetas

Request

Type Name
List<Uint64> dataIds
List<DataStoreChangeMetaParam> params
Bool transactional

Response

Type Name
List<Result> pResults

(40) RateObjects

Request

Type Name
List<DataStoreRatingTarget> targets
List<DataStoreRateObjectParam> params
Bool transactional
Bool fetchRatings

Response

Type Name
List<DataStoreRatingInfo> pRatings
List<Result> pResults

(41) PostMetaBinaryWithDataId

Request

Type Name
Uint64 dataId
DataStorePreparePostParam param

Response

This method does not return anything.

(42) PostMetaBinariesWithDataId

Request

Type Name
List<Uint64> dataIds
List<DataStorePreparePostParam> params
Bool transactional

Response

Type Name
List<Result> pResults

(43) RateObjectWithPosting

Request

Type Name
DataStoreRatingTarget target
DataStoreRateObjectParam rateParam
DataStorePreparePostParam postParam
Bool fetchRatings

Response

Type Name
DataStoreRatingInfo pRating

(44) RateObjectsWithPosting

Request

Type Name
List<DataStoreRatingTarget> targets
List<DataStoreRateObjectParam> rateParams
List<DataStorePreparePostParam> postParams
Bool transactional
Bool fetchRatings

Response

Type Name
List<DataStoreRatingInfo> pRatings
List<Result> pResults

(45) GetObjectInfos

Request

Type Name
List<Uint64> dataIds

Response

Type Name
List<DataStoreReqGetInfo> pInfos
List<Result> pResults

(46) SearchObjectLight

Request

Type Name
DataStoreSearchParam param

Response

Type Name
DataStoreSearchResult pSearchResult

Types

DataStorePrepareGetParamV1 (Structure)

Type Name
Uint32 dataId
Uint32 lockId

DataStorePrepareGetParam (Structure)

Type Name
Uint64 dataId
Uint32 lockId
DataStorePersistenceTarget persistenceTarget
Uint64 accessPassword
List<String> extraData

DataStoreReqGetInfoV1 (Structure)

Type Name
String url
List<DataStoreKeyValue> requestHeaders
Uint32 size
Buffer rootCaCert

DataStoreReqGetInfo (Structure)

Type Name
String url
List<DataStoreKeyValue> requestHeaders
Uint32 size
Buffer rootCaCert
Uint64 dataId

DataStoreReqGetAdditionalMeta (Structure)

Type Name
PID ownerId
Uint16 dataType
Uint16 version
qBuffer metaBinary

DataStorePreparePostParamV1 (Structure)

Type Name
Uint32 size
String name
Uint16 dataType
qBuffer metaBinary
DataStorePermission permission
DataStorePermission delPermission
Uint32 flag
Uint16 period
Uint32 referDataId
List<String> tags
List<DataStoreRatingInitParamWithSlot> ratingInitParams

DataStorePreparePostParam (Structure)

Type Name
Uint32 size
String name
Uint16 dataType
qBuffer metaBinary
DataStorePermission permission
DataStorePermission delPermission
Uint32 flag
Uint16 period
Uint32 referDataId
List<String> tags
List<DataStoreRatingInitParamWithSlot> ratingInitParams
DataStorePersistenceInitParam persistenceInitParam
List<String> extraData

DataStoreReqPostInfoV1 (Structure)

Type Name
Uint32 dataId
String url
List<DataStoreKeyValue> requestHeaders
List<DataStoreKeyValue> formFields
Buffer rootCaCert

DataStoreReqPostInfo (Structure)

Type Name
Uint64 dataId
String url
List<DataStoreKeyValue> requestHeaders
List<DataStoreKeyValue> formFields
Buffer rootCaCert

DataStoreCompletePostParamV1 (Structure)

Type Name
Uint32 dataId
Bool isSuccess

DataStoreCompletePostParam (Structure)

Type Name
Uint64 dataId
Bool isSuccess

DataStoreDeleteParam (Structure)

Type Name
Uint64 dataId
Uint64 updatePassword

DataStoreChangeMetaParamV1 (Structure)

Type Name
Uint64 dataId
Uint32 modifiesFlag
String name
DataStorePermission permission
DataStorePermission delPermission
Uint16 period
qBuffer metaBinary
List<String> tags
Uint64 updatePassword

DataStoreChangeMetaParam (Structure)

Type Name
Uint64 dataId
Uint32 modifiesFlag
String name
DataStorePermission permission
DataStorePermission delPermission
Uint16 period
qBuffer metaBinary
List<String> tags
Uint64 updatePassword
Uint32 referredCnt
Uint16 dataType
Uint8 status
DataStoreChangeMetaCompareParam compareParam
DataStorePersistenceTarget persistenceTarget

DataStoreGetMetaParam (Structure)

Type Name
Uint64 dataId
DataStorePersistenceTarget persistenceTarget
Uint8 resultOption
Uint64 accessPassword

Result option flags:

Flag Field
0x4 metaBinary

DataStoreRatingInfo (Structure)

Type Name
Sint64 totalValue
Uint32 count
Sint64 initialValue

DataStoreRatingInfoWithSlot (Structure)

Type Name
Sint8 slot
DataStoreRatingInfo rating

DataStoreMetaInfo (Structure)

Type Name
Uint64 dataId
PID ownerId
Uint32 size
String name
Uint16 dataType
qBuffer metaBinary
DataStorePermission permission
DataStorePermission delPermission
DateTime createdTime
DateTime updatedTime
Uint16 period
Uint8 status
Uint32 referredCnt
Uint32 referDataId
Uint32 flag
DateTime referredTime
DateTime expireTime
List<String> tags
List<DataStoreRatingInfoWithSlot> ratings

DataStorePrepareUpdateParam (Structure)

Type Name
Uint64 dataId
Uint32 size
Uint64 updatePassword
List<String> extraData

DataStoreReqUpdateInfo (Structure)

Type Name
Uint32 version
String url
List<DataStoreKeyValue> requestHeaders
List<DataStoreKeyValue> formFields
Buffer rootCaCert

DataStoreCompleteUpdateParam (Structure)

Type Name
Uint64 dataId
Uint32 version
Bool isSuccess

DataStoreSearchParam (Structure)

Type Name
Uint8 searchTarget
List<PID> ownerIds
Uint8 ownerType
List<Uint64> destinationIds
Uint16 dataType
DateTime createdAfter
DateTime createdBefore
DateTime updatedAfter
DateTime updatedBefore
Uint32 referDataId
List<String> tags
Uint8 resultOrderColumn
Uint8 resultOrder
ResultRange resultRange
Uint8 resultOption
Uint32 minimalRatingFrequency
Bool useCache

Only present on Switch:

Type Name
Bool totalCountEnabled
List<Uint16> dataTypes

DataStoreSearchResult (Structure)

Type Name
Uint32 totalCount
List<DataStoreMetaInfo> result
Uint8 totalCountType

DataStoreGetNotificationUrlParam (Structure)

Type Name
String previousUrl

DataStoreReqGetNotificationUrlInfo (Structure)

Type Name
String url
String key
String query
Buffer rootCaCert

DataStoreGetNewArrivedNotificationsParam (Structure)

Type Name
Uint64 lastNotificationId
Uint16 limit

DataStoreNotificationV1 (Structure)

Type Name
Uint64 notificationId
Uint32 dataId

DataStoreNotification (Structure)

Type Name
Uint64 notificationId
Uint64 dataId

DataStoreRateObjectParam (Structure)

Type Name
Sint32 ratingValue
Uint64 accessPassword

DataStoreRatingTarget (Structure)

Type Name
Uint64 dataId
Sint8 slot

DataStoreGetSpecificMetaParamV1 (Structure)

Type Name
List<Uint32> dataIds

DataStoreGetSpecificMetaParam (Structure)

Type Name
List<Uint64> dataIds

DataStoreSpecificMetaInfoV1 (Structure)

Type Name
Uint32 dataId
PID ownerId
Uint32 size
Uint16 dataType
Uint16 version

DataStoreSpecificMetaInfo (Structure)

Type Name
Uint64 dataId
PID ownerId
Uint32 size
Uint16 dataType
Uint32 version

DataStoreTouchObjectParam (Structure)

Type Name
Uint64 dataId
Uint32 lockId
Uint64 accessPassword

DataStoreRatingLog (Structure)

Type Name
Bool isRated
PID pid
Sint32 ratingValue
DateTime lockExpirationTime

DataStorePersistenceInfo (Structure)

Type Name
PID ownerId
Uint16 persistenceSlotId
Uint64 dataId

DataStorePasswordInfo (Structure)

Type Name
Uint64 dataId
Uint64 accessPassword
Uint64 updatePassword

DataStorePersistenceTarget (Structure)

Type Name
PID ownerId
Uint16 persistenceSlotId

DataStoreKeyValue (Structure)

Type Name
String key
String value

DataStorePermission (Structure)

Type Name
Uint8 permission
List<PID> recipientIds

DataStoreRatingInitParamWithSlot (Structure)

Type Name
Sint8 slot
DataStoreRatingInitParam param

DataStorePersistenceInitParam (Structure)

Type Name
Uint16 persistenceSlotId
Bool deleteLastObject

DataStoreChangeMetaCompareParam (Structure)

Type Name
Uint32 comparisonFlag
String name
DataStorePermission permission
DataStorePermission delPermission
Uint16 period
qBuffer metaBinary
List<String> tags
Uint32 referredCnt
Uint16 dataType
Uint8 status

DataStoreRatingInitParam (Structure)

Type Name
Uint8 flag
Uint8 internalFlag
Uint8 lockType
Sint64 initialValue
Sint32 rangeMin
Sint32 rangeMax
Sint8 periodHour
Sint16 periodDuration
Clone this wiki locally