royaleapi / cr-api Goto Github PK

Feature

[
  {
    "name_en": "Cannon Cart",
    "name_enum": "CANNON_CART",
    "image": "/cards/cannon_card.png",
    "id": 26000001,
    "rarity": "EPIC",
    "elixir": 4,
    "arenaid": 10,
    "type": "TROOP",
    "description": "blabla"
  },
  {
    "name_en": "Bandit",
    "name_enum": "BANDIT",
    "image": "/cards/bandit.png",
    "id": 26000000,
    "rarity": "LEGENDARY",
    "elixir": 3,
    "arenaid": 9,
    "type": "TROOP",
    "description": "blabla"
  }
]

Possibly include other details like: damage, health in additional fields.

easylink: http://cr-api.com/profile/8YYV89892
win streak is negative in api. if it is negative, does it indicate a loss streak?
it makes it 0 in the website tho

"description"

1. Arena appears twice
2. Experience, Level, Arena, etc. can also be colored
3. Can create a kind of metascore, that compares players base on all stats.

This is a very odd issue. The API currently fails to fetch specific profile tags even though I have verified that their tags are correct.

Example:
http://api.cr-api.com/profile/LVJCL0

This member is currently in Reddit Echo:
http://api.cr-api.com/clan/LGVV2CG

And the clan api also reported his tag:

{
    "arena": {
        "arena": "League 2",
        "arenaID": 13,
        "imageURL": "/arena/league2.png",
        "name": "Challenger II",
        "trophyLimit": 4300
    },
    "clanChestCrowns": 38,
    "currentRank": 29,
    "donations": 951,
    "expLevel": 12,
    "name": "Z3RO",
    "previousRank": 30,
    "role": 1,
    "roleName": "Member",
    "score": 4315,
    "tag": "LVJCL0",
    "trophies": 4315
}

He has also verified that it is indeed the same tag on his profile.

This just might be those unfixable bugs…

Some profiles have these two fields missing. Maybe because they have not unlocked the challenges yet.

"challengeMaxWins"
"challengeCardsWon"

Can these be put to 0, just like tournament keys?

Either:

• Return null for "clan"
• Return null for each of the fields in "clan"

Current output is:

    "clan": {
        "tag": "",
        "role": "Unknown type: alliance.roles.undefined",
        "badgeUrl": "/badge/Unknown type: badges.NaN.png"
    },

which is not desirable.

a: "legendTrophies" is shown twice
b: in "stats", what does the "level" value mean (in this case, 15)
c: add first 10* chests to "chestCycle" when you get around to it
d: maybe just delete the "seasonNumber" value of "prevSeasons" and make it a list
e: change "accountAgeInDays" to reflect the actual account age, or for the key to be changed from "accountAgeInDays" to something different to represent the actual value
f: change name of cards in "currentDeck" to be exactly what the names are in the https://github.com/smlbiobot/cr-emoji-servers/ repo made by SML, for example, the emoji is named "the_log" in the api, but "the-log" in the repo.
g: if possible, for arena, add "legendary arena" somewhere to the "arena" value because right now it just shows "League 3" and "Challenger III"

*10 is just suggested, can be 5, 10, 20, however many you want to put

Please use the card keys in this json: https://github.com/smlbiobot/cr-sanic/blob/master/cr/static/json/clashroyale.json

Also in the "id" field – I duplicated the two so I don‘t have to look for the id and then find stuff, but also sometimes I need to convert one format to another and having the field repeated is easier for me to deal with in that JSON file.

All discord issues are created by Selfish. Menation who actually used gh-bot

On my profile, http://api.cr-api.com/profile/C0G20PR2

Clan badge is mapped to Freeze_01.png but should in fact be A_Char_Rocket_02

Obtain the list of the cards that the player has unlocked, to be able to generate "random decks"

Example: http://cr-api.com/clan/family/immortal/clan/2R099R92
http://cr-api.com/clan/2R099R92 does work

Make some archers

A clan tag returned by /top/clans is invalid according to the API.

http://api.cr-api.com/top/clans

http://api.cr-api.com/top/clans

        {
            "badge": {
                "filename": "flag_c_03.png",
                "key": "flag_c_03",
                "url": "/badge/flag_c_03.png"
            },
            "memberCount": 48,
            "name": "ジェンコ・オリーブ商会",
            "previousRank": 23,
            "rank": 15,
            "region": {
                "isCountry": "true",
                "name": "Japan"
            },
            "tag": "V0U",
            "trophies": 54910
        },

http://api.cr-api.com/clan/V0U

http://api.cr-api.com/clan/V0U

{
    "error": true,
    "message": "invalid: tag too short"
}

The other tags are fine. Not sure if related to #10

P.S. I included both versions of URLs just for you 😉

multiline
crap
description

"description"

Am trying to use the new endpoints for fetching multiple profiles. However, even though the single profiles get returned successfully, the multiple profiles calls often result in an error. Worth looking into?

Example:

• http://api.cr-api.com/profile/8JP9VVUR,PVQV0GV2,L22UJ29R

returns

{
    "error": "Service Unavailable, but will be back shortly."
}

while

• http://api.cr-api.com/profile/8JP9VVUR
• http://api.cr-api.com/profile/PVQV0GV2
• http://api.cr-api.com/profile/L22UJ29R

all returns data successfully.

Given this, I will switch back to doing it manually but would love to switch to single call so as not to have to call multiple async requests

Is it possible to add to the API a way to request match details like: Players, Decks, CardPlayed, position of the card played, time of the play... ?

http://api.cr-api.com/clan/VJQ0GJ0

Returning:

......
{  
   "name":"Raiven",
   "arena":{  
      "imageURL":"/arena/arena8.png",
      "arena":"Arena 8",
      "arenaID":8,
      "name":"Frozen Peak",
      "trophyLimit":2300
   },
   "role":1,
   "expLevel":7,
   "trophies":2336,
   "donations":0,
   "currentRank":46,
   "previousRank":46,
   "clanChestCrowns":33,
   "tag":"8220RQ9Y",
   "roleName":"Member",
   "score":2336
},
......

Actual In game tag:

Refer to the wiki for tier amounts and all
Percent should also be 100 and not 1.

Currently

clanChest:
    clanChestCrowns: 1600
    clanChestCrownsPercent: 1
    clanChestCrownsRequired: 1600

Suggested

clanChest:
    clanChestCrowns: 1600
    clanChestCrownsPercent: __100__
    clanChestCrownsRequired: 1600
    __clanChestTier: 10__

Firefox nicely formats it for me so I didn't run a HTTP Request

xyz

If someone want to collect data for some kind of analysis you need a lot of users tags (especially from tops arenas). Could be an idea publish weekly a file that contains just users tags instead that everyone is trying to collect tags by himself. That will be also helping to reduce the work for the API server

Compltely missing when param not used

Not a priority, but if at all possible, can we fetch up to 5 profiles in one call, similar to what we do in clan API?

Same syntax would be fine, e.g. tag1,tag2,tag3

Avoid x,x,x,x, just cause it's stupid. :)

Always existing key with true value to identify good responses.

this is just a test

switch this:

"badge_url": :/badge/Lotus_02.png",

Into:

badge: {
    "url": "/badge/Lotus_02.png",
    "filename": "Lotus_02.png",
    "key": "Lotus_02"
},

It would be great if we can have a collection of sample error pages that will be returned by the API. Make them always available if possible.

.e.g. api.cr-api.com/error/tag-not-found

Or whatever you decide is best.

At the moment, there is no way for me to reliably test error handling except when it happens. And having these pages available would allow me to deal with every single scenario, e.g.

• profile tag not found
• clan tag not found
• api down
• etc etc

reported by tudorr in dm

You may have accidentally removed currentRank from the clan API:

http://api.cr-api.com/clan/2CCCP

     "members": [
        {
            "name": "cece",
            "arena": {
                "imageURL": "/arena/league5.png",
                "arena": "League 5",
                "arenaID": 16,
                "name": "Master II",
                "trophyLimit": 5200
            },
            "role": 3,
            "expLevel": 13,
            "trophies": 5201,
            "donations": 785,
            "previousRank": 1,
            "clanChestCrowns": 109,
            "tag": "UJPPP9UL",
            "roleName": "Elder",
            "score": 5201
        },

test

• experience (current / total required)
• expereince level
• tourney cads won
• donations

Appears that the https://docs.cr-api.com/#/clans/single_clan is not the latest update.

1. Ordering is different (look at description, and things around it)
2. New features aren't there (look at clan chest and region for some examples)

I am comparing with http://api.cr-api.com/clan/2CCCP
Firefox nicely formats it for me so I didn't run a HTTP Request

I know the profile API is WIP but I would like to point it out in case its forgotten

Current Data:

"chestCycle":{  
      "position":1175,
      "superMagicalPos":1295,
      "legendaryPos":1423,
      "epicPos":1483
   }

Would like to see these positions as well:

• Silver chest position
• Gold chest position
• Giant chest position
• Magical chest position

Need the other resource as well

Is it possible to parse the Clan name as well? If it is just an additional call to the other part of the API, I can do it myself, depending on which is more expensive.

I think that we only need clan name and clan role though. People would want the same, probably. So in fact it might not be a bad idea, if you can do it from the API side, to output:

"clan" {
    "name": "XYZ",
    "tag": "CCGPLU9",
    "role": "Leader"
}

A few clan badges are not mapped.

• 16000172
• 16000177

Values are:

{
    "16000169": "Freeze_02",
    "16000170": "Clover_01",
    "16000171": "Clover_02",
    "16000172": "flag_h_04",
    "16000173": "flag_e_02",
    "16000174": "flag_i_03",
    "16000175": "flag_e_01",
    "16000176": "flag_e_02",
    "16000177": "A_Char_Prince_03",
    "16000178": "A_Char_Bomb_01",
    "16000179": "A_Char_Bomb_02"
}