PmWiki | APIMethods / cc.cardsets.levels.sync

Synchronizes card levels from a set and returns more recent levels when exist.

Authentication

This method requires authentication with write permission.

Notice: This method requires an HTTP POST request.

Arguments

api_key (Required)

          Your API key. See here for more details.

set_id (Required)

          The ID of the set to sync card levels with.

levels (Required)

          A comma delimited list of card ID, level and last learned unix timestamp concatenated with a colon.
          Format: card_id:level:unix_timestamp
          Example: 123a45b:1:1256832426,9f75d3:6:1256715239,1928374:4:1249985321

Example Response

<levels>
     <card id="123a45b" new_level="2" last_learned="1302524198" />
     <card id="9f75d3" new_level="5" last_learned="1295803642" />
</levels>

Notice: This method returns only new levels when the levels on the server are more recent. Otherwise the response is empty.
Notice: (level)
1 = Not known
2 = Level 1
3 = Level 2
4 = Level 3
5 = Level 4
6 = Half known
Notice: last_learned is an unix timestamp.

Error Codes

1: Invalid set ID

          The specified set ID was not valid.

40: Levels is empty

          The passed levels parameter is empty.

98: Login failed / Invalid auth token

          The auth token passed were invalid or expired.

99: Insufficient permissions

          The authenticated method call did not have the required permissions.

100: Invalid API Key

          The API key passed was not valid.

101: Invalid signature

          The signature is missing or was not valid.

110: Format "xxx" not found

          The requested response format was not found.

120: Method "xxx" not found

          The requested method was not found.

130: HTTPS required

          The API Key passed requires HTTPS.