gods unchained api Download - gods unchained api -Quellcode herunterladen

Gods Unchained-API

Öffentliche Entwickler-API-Dokumentation für Gods Unchained, ein Sammelkartenspiel auf der Ethereum-Blockchain.

Diese Version der API ( v0 ) befindet sich in einer eingeschränkten öffentlichen Betaversion: Wenn Sie einen Fehler entdecken oder die API Ergebnisse zurückgibt, die der Spezifikation widersprechen, melden Sie dies hier. Fehlerspezifikationen werden in Kürze hinzugefügt.

Projekte

Hier sind einige Tools von Drittanbietern, die mit diesen APIs erstellt wurden. Fragen Sie unbedingt auf unserem Discord-Server nach, wenn Sie Hilfe suchen oder sich fragen, was Sie erstellen sollen.

GUDecks

Allgemein

Basis-URL

Die Basis-URL für alle Anfragen lautet:

 https://api.godsunchained.com

An diese URL muss die angeforderte Version angehängt werden (aktuelle Version: v0 ).

 https://api.godsunchained.com/v0/

Doppelte Argumente

Wir unterstützen Anfragen der folgenden Form:

 https://api.godsunchained.com/v0/card?god=nature&god=death

Doppelte Argumentschlüssel werden disjunktiv interpretiert: Diese Abfrage gibt Karten zurück, bei denen der Gott entweder Natur ODER Tod ist.

Pagination

Alle Anfragen, die mehrere Objekte zurückgeben können, können durch die Parameter page und perPage geformt werden.

 https://api.godsunchained.com/v0/proto?page=3&perPage=20

Alle paginierten Endpunkte geben Daten im folgenden Format zurück:

 {
    total: number
    page: number
    perPage: number
    records: Array<any>
}

Dabei ist total die Anzahl der von dieser Abfrage entdeckten Datensätze.

Sortierung

Sortierungen werden mithilfe der Abfrageparameter sort und order auf paginierte Endpunkte angewendet:

 https://api.godsunchained.com/v0/card?sort=mana&order=asc

Bereichs- und Zahlentypen können nach order=asc und order=desc sortiert werden, standardmäßig ist asc .

In einer Abfrage können mehrere Sortierparameter angewendet werden, und zwar in der folgenden Reihenfolge:

 https://api.godsunchained.com/v0/card?sort=mana&order=asc&sort=health&order=desc

Bei Abfragen ohne exakte Paarungen von Sortier- und Reihenfolgeparametern (bei denen mehrere Parameter angewendet werden) muss die Reihenfolge als null markiert werden:

 https://api.godsunchained.com/v0/card?sort=mana&order=asc&sort=god&order=null&sort=health&order=desc

Ratenbeschränkungen

Derzeit gilt für alle Endpunkte eine Geschwindigkeitsbegrenzung von 5 pro Sekunde (5/s). Dies kann sich in Zukunft ändern.

Typen

Allgemeine Typen:

Typ	Beschreibung
	Eine URL-codierte Zeichenfolge.
	Eine Dezimalzahl.
	`true` oder `false`

Benutzerdefinierte API-Typen:

Typ	Beschreibung
	Eine hexadezimale Ethereum-Adresse, ohne Berücksichtigung der Groß- und Kleinschreibung.
	Eine bestimmte Zahl `1000` , ein Bereich `1000-2000` , ein Minimum `1000-` oder ein Maximum `-2000` .

Die gültigen Optionen für die Aufzählungstypen in verschiedenen APIs sind unten aufgeführt:

Typ	Optionen
	Licht, Tod, Natur, Krieg, Magie, Täuschung
	selten, episch, legendär, glänzend
	häufig, selten, episch, legendär, mythisch
	Kreatur, Zauber, Waffe
	Nether, Äther, atlantisch, Wikinger, olympisch, Anubian, Amazonas
	schlicht, Schatten, Gold, Diamant
	voll, Karte

Konzepte

Es gibt verschiedene Kartentypen in Gods Unchained:

Token : Eine vollständige ERC721-Token-Karte, die „aktiviert“ wurde.
Modell : Der häufigste Kartentyp: gesperrt, im Frontend angezeigt, aber noch nicht in einen ERC721-Token umgewandelt, um Benzin zu sparen.
Zentralisiert : Karten, die nicht auf der Blockchain gehandelt werden können (Teil des Kernsatzes oder eine nicht handelbare Aktionskarte).

Einige dieser Endpunkte geben eine Kombination der oben genannten Werte zurück, andere nicht: Dies wird von den einzelnen Endpunkten dokumentiert. Im Allgemeinen werden standardmäßig nur Karten zurückgegeben, die zu ERC721-Tokens werden können (d. h. Token- und Modellkarten).

Prototypkarten oder Protos enthalten die zugrunde liegenden Statistiken für eine Kartenklasse.

Zusammenfassung

Verfahren	Beschreibung	Status
`/card/{id}`	Karte besorgen
`/card`	Karten auflisten
`/proto/{id}`	Holen Sie sich einen Prototyp
`/proto`	Protos auflisten
`/factory/{address}`	Holen Sie sich die Fabrik
`/factory`	Holen Sie sich eine Liste der Fabriken
`/factory/{address}/purchase/{id}`	Holen Sie sich den Kauf
`/purchase`	Fabriken auflisten
`/factory/{address}/purchase/{id}/pack/{index}`	Pack ein
`/pack`	Pakete auflisten
`/referral`	Holen Sie sich eine Empfehlungsliste
`/image/{id}`	Bild abrufen
`/user/{address}`	Benutzer abrufen
`/ranking`	Listen Sie die Benutzer nach Kartenbesitz auf
`/rarity`	Erhalten Sie Seltenheitsstatistiken
`/user/{address}/inventory`	Rufen Sie das Inventar eines Benutzers ab
`/deck`	Kodieren Sie ein Deck in einen Deck-String
`/deck/{string}`	Dekodieren Sie ein Deck aus einer Deck-Zeichenfolge

Kern-API

GET /card/{id}

Parameter

Name	Typ	Beschreibung
Ausweis		ERC721-ID der Karte

Gibt die Token-Karte mit der ID id und den entsprechenden Metadaten zurück. Entspricht derzeit sowohl den generischen als auch den Apollo-Metadatenspezifikationen.

GET /card

Gibt eine Liste von Token- und Modellkarten zurück.

Parameter

Name	Typ	Beschreibung
`user`		Holen Sie sich Karten, die einer bestimmten Adresse gehören
`rarity`		Holen Sie sich Karten mit einer bestimmten Seltenheit
`quality`		Holen Sie sich Karten mit einer bestimmten Qualität
`god`		Holen Sie sich Karten mit einem bestimmten Gott
`type`		Holen Sie sich Karten mit einem bestimmten Typ
`tribe`		Holen Sie sich Karten mit einem bestimmten Stamm
`purity`		Erhalten Sie Karten mit einer bestimmten Reinheit
`mana`		Erhalte Karten mit einem bestimmten Mana
`health`		Holen Sie sich Karten mit einer bestimmten Gesundheit
`attack`		Holen Sie sich Karten mit einem bestimmten Angriff
`proto`		Holen Sie sich Karten mit einer bestimmten Prototyp-ID

Antwortformat

 {
    "total": 1000,
    "page": 1,
    "perPage": 1,
    "records": [
        {
            "id": {
                "Int64": 0,
                "Valid": false,
            }
            "proto": 319,
            "purity": 59,
            "user": "0xCb3562Dd15807e2BCF35092B1e873971AF0a51da"
        }
    ]
}

GET /proto/{id}

Gibt die Prototypkarte mit der ID id zurück.

Parameter

Name	Typ	Beschreibung
`id`		ID der Prototypkarte

Antwortformat

 {
    "id":300,
    "name":"Guerilla Sabotage",
    "effect":"Deal 4 damage to a random enemy creature. Draw a card.",
    "god":"Nature",
    "rarity":"Common",
    "tribe":{"String":"","Valid":false},
    "mana":4,
    "attack":{"Int64":0,"Valid":false},
    "health":{"Int64":0,"Valid":false},
    "type":"Spell"
}

GET /proto

Gibt eine Liste von Prototypkarten zurück.

Parameter

Name	Typ	Beschreibung
`god`		Holen Sie sich Protos mit einem bestimmten Gott
`rarity`		Erhalte Protos mit einer bestimmten Seltenheit
`type`		Holen Sie sich Prototypen mit einem bestimmten Typ
`tribe`		Holen Sie sich Protos mit einem bestimmten Stamm
`set`		Holen Sie sich Protos mit einem bestimmten Satz
`collectable`		Holen Sie sich Protos, die sammelbar sind oder nicht
`mana`		Erhalte Protos mit einem bestimmten Mana
`health`		Holen Sie sich Protos mit einer bestimmten Gesundheit
`attack`		Holen Sie sich Protos mit einem bestimmten Angriff

Antwortformat

 {
    "total": 380,
    "page": 1,
    "perPage: 1,
    "records": [
        {
            "id":300,
            "name":"Guerilla Sabotage",
            "effect":"Deal 4 damage to a random enemy creature. Draw a card.",
            "god":"Nature",
            "rarity":"Common",
            "tribe":{"String":"","Valid":false},
            "mana":4,
            "attack":{"Int64":0,"Valid":false},
            "health":{"Int64":0,"Valid":false},
            "type":"Spell"
        }
    ]
}

GET /factory/{address}

Sendet das Paket an die address zurück.

Parameter

Name	Typ	Beschreibung
`address`		Adresse der Fabrik

Antwortformat

 {
    "address":"0x0777f76d195795268388789343068e4fcd286919",
    "type":"rare"
}

GET /factory

Gibt eine Liste der Paketfabriken zurück.

Parameter

Name	Typ	Beschreibung
`type`		Art der Packung

Antwortformat

 {
    "total": 4,
    "page": 1,
    "perPage: 1,
    "records": [
        {
            "address":"0x0777f76d195795268388789343068e4fcd286919",
            "type":"rare"
        }
    ]
}

GET /factory/{address}/purchase/{id}

Gibt die Kauf- id von der Pack-Fabrik an address zurück.

Parameter

Name	Typ	Beschreibung
`address`		Adresse der Fabrik
`id`		ID des Kaufs im Werk

Antwortformat

 {
    "id":0,
    "user":"0x3882C6ba6475165aC5257Ddc1D8d7782E7805c28",
    "count":1,
    "remaining":0,
    "factory":"0x000983ba1A675327F0940b56c2d49CD9c042DFBF",
    "txhash":"0xda2b2956588bd642bed4b0aa8f63c979f4893662dd31c237aa58b173bf4eb223",
    "type":"shiny"
}

ERHALTEN/kaufen

Gibt eine Liste der Käufe zurück.

Parameter

Name	Typ	Beschreibung
`type`		Erhalten Sie Käufe aus einem bestimmten Pakettyp
`user`		Erhalten Sie Einkäufe, die von einem bestimmten Benutzer getätigt wurden
`factory`		Einkäufe in einer bestimmten Fabrik tätigen lassen
`remaining`		Anzahl der Pakete, die von diesem Kauf noch aktiviert werden müssen
`count`		Anzahl der bei diesem Kauf gekauften Packungen

Antwortformat

 {
    "total": 1000,
    "page": 1,
    "perPage: 1,
    "records": [
        {
            "id":0,
            "user":"0x3882C6ba6475165aC5257Ddc1D8d7782E7805c28",
            "count":1,
            "remaining":0,
            "factory":"0x000983ba1A675327F0940b56c2d49CD9c042DFBF",
            "txhash":"0xda2b2956588bd642bed4b0aa8f63c979f4893662dd31c237aa58b173bf4eb223",
            "type":"shiny"
        }
    ]
}

GET /factory/{address}/purchase/{id}/pack/{index}

Gibt das Paket mit dem index von der Kauf- id der Paketfabrik mit der address zurück.

Parameter

Name	Typ	Beschreibung
`address`		Adresse der Verpackungsfabrik
`id`		ID des Kaufs
`index`		Index der Packung innerhalb des Kaufs

Antwortformat

 {
    "purchaseid":11665,
    "purchaseindex":0,
    "purchaseindices":[0,1,2,3,4],
    "user":"0x62ed0960478Cd1aAA29e9e94928107D7b1E2Cef8",
    "factory":"0x0777F76D195795268388789343068e4fCd286919",
    "opened":true,
    "cards":[
        {"proto":264,"purity":600},
        {"proto":38,"purity":990},
        {"proto":299,"purity":549},
        {"proto":347,"purity":275},
        {"proto":291,"purity":850}
    ],
    "type":"rare"
}

GET /pack

Gibt eine Liste von Paketen zurück.

Parameter

Name	Typ	Beschreibung
`type`		Holen Sie sich Pakete eines bestimmten Typs
`user`		Holen Sie sich Pakete, die von einem bestimmten Benutzer gekauft wurden
`factory`		Holen Sie sich Pakete, die von einer bestimmten Fabrik erstellt wurden
`purchase`		Holen Sie sich Pakete, die in einem bestimmten Kauf erstellt wurden
`opened`		ob diese Packungen geöffnet wurden
`fill`		ob sie diese Pakete mit ihren Karten füllen sollen

Antwortformat

 {
    "total": 1000,
    "page": 1,
    "perPage: 1,
    "records": [
        {
            "purchaseid":11665,
            "purchaseindex":0,
            "purchaseindices":[0,1,2,3,4],
            "user":"0x62ed0960478Cd1aAA29e9e94928107D7b1E2Cef8",
            "factory":"0x0777F76D195795268388789343068e4fCd286919",
            "opened":true,
            "cards":[
                {"proto":264,"purity":600},
                {"proto":38,"purity":990},
                {"proto":299,"purity":549},
                {"proto":347,"purity":275},
                {"proto":291,"purity":850}
            ],
            "type":"rare"
        }
    ]
}

GET /Referral

Gibt eine Liste von Verweisen zurück.

Parameter

Name	Typ	Beschreibung
`type`		Erhalten Sie Empfehlungen mit einer bestimmten Seltenheit
`referrer`		Erhalten Sie Empfehlungen von einem bestimmten Benutzer
`purchaser`		Erhalten Sie Empfehlungen für einen bestimmten Benutzer
`factory`		Erhalten Sie Empfehlungen, die in einer bestimmten Fabrik erstellt wurden

Antwortformat

 {
    "total": 1000,
    "page": 1,
    "perPage: 1,
    "records": [
        {
            "id":0,
            "referrer":"0xb08F95dbC639621DbAf48A472AE8Fce0f6f56a6e",
            "purchaser":"0xE4a8dfcA175cDcA4Ae370f5b7aaff24bD1C9C8eF",
            "factory":"0x1e891C587b345ab02A31b57c1F926fB08913d10D",
            "value":1746000000000000000,
            "count":0,
            "type":"shiny"
        }
    ]
}

GET /image/{id}

Gibt ein Bild basierend auf dem Kartenprototyp mit der ID id zurück. Um ein Bild in Kartenform zu erhalten, verwenden Sie die format und quality .

Parameter

Name	Typ	Beschreibung
`format`		das Format, in dem das Bild präsentiert werden soll
`h`		die Höhe, auf die die Größe des Bildes geändert wird
`w`		die Breite, auf die die Größe des Bildes geändert wird
`quality`		die Qualität der Karte

GET /user/{address}

Holen Sie sich einen Benutzer.

Parameter

Name	Typ	Beschreibung
`address`		die Ethereum-Adresse des Benutzers

Antwortformat

 {
    "username": "ender",
    "address": "0xC257274276a4E539741Ca11b590B9447B26A8051",
    "nonce": 0
}

Hilfs-APIs

Um die Entwicklung effektiverer Anwendungen für unser Ökosystem zu unterstützen, stellen wir auch einige hilfreiche API-Endpunkte bereit. Diese Endpunkte werden in zukünftigen Versionen möglicherweise nicht mehr unterstützt, da sie aus vorhandenen Endpunkten zusammengesetzt werden können, aber eine praktische Schnittstelle während der Entwicklung neuer GU-fokussierter Anwendungen bieten.

GET /ranking

Gibt eine geordnete Liste der Benutzer mit den meisten Karten zurück, die bestimmte Bedingungen erfüllen.

Parameter

Name	Typ	Beschreibung
`rarity`		Ermitteln Sie den Rang von Karten mit einer bestimmten Seltenheit
`quality`		Ermitteln Sie den Rang von Karten mit einer bestimmten Qualität
`god`		Ermitteln Sie den Kartenrang eines bestimmten Gottes
`type`		Ermitteln Sie den Rang von Karten mit einem bestimmten Typ
`tribe`		Ermitteln Sie den Kartenrang eines bestimmten Stammes
`purity`		Ermitteln Sie den Kartenrang mit einer Mindestreinheitsgrenze
`mana`		Ermitteln Sie den Rang von Karten mit einem bestimmten Mana
`health`		Ermitteln Sie den Rang von Karten mit einer bestimmten Gesundheit
`attack`		Ermitteln Sie den Kartenrang mit einem bestimmten Angriff
`proto`		Ermitteln Sie den Rang von Karten mit einer bestimmten Prototyp-ID

Antwortformat

 {
    "total": 10000,
    "page": 1,
    "perPage": 1,
    "records": [
        {
            "user": "0xa012623C2d4EB0cfe921Bd283bb1823370Ae2737",
            "count": 1585
        }
    ]
}

GET /rarity

Gibt Informationen zur Seltenheit von Protos zurück.

Parameter

Name	Typ	Beschreibung
`user`		Erhalten Sie Seltenheitsinformationen zu Karten, die einer bestimmten Adresse gehören
`rarity`		Erhalten Sie Seltenheitsinformationen zu Karten mit einer bestimmten Seltenheit
`quality`		Erhalten Sie Seltenheitsinformationen zu Karten mit einer bestimmten Qualität
`god`		Erhalten Sie Informationen zur Seltenheit von Karten mit einem bestimmten Gott
`type`		Erhalten Sie Seltenheitsinformationen zu Karten eines bestimmten Typs
`tribe`		Erhalten Sie Seltenheitsinformationen zu Karten mit einem bestimmten Stamm
`purity`		Erhalten Sie Seltenheitsinformationen zu Karten innerhalb eines Reinheitsbereichs
`mana`		Erhalte Informationen zur Seltenheit von Karten innerhalb eines Manabereichs
`health`		Erhalten Sie Seltenheitsinformationen zu Karten innerhalb eines Gesundheitsbereichs
`attack`		Erhalten Sie Seltenheitsinformationen zu Karten mit Angriffsreichweite
`proto`	`	Erhalten Sie Seltenheitsinformationen zu Karten mit einer bestimmten Prototyp-ID

Sortieroptionen

proto , plain , shadow , gold , diamond

Antwortformat

 {
    "total": 380,
    "page": 1,
    "perPage": 1,
    "records": [
        {
            "proto": 1,
            "plain": 1325,
            "shadow": 72,
            "gold": 20,
            "diamond": 3
        }
    ]
}

GET /user/{address}/inventory

Gibt den Bestand des Benutzers mit der address zurück, einschließlich Token, Schatten- und zentralisierten Karten.

Parameter

Name	Typ	Beschreibung
`rarity`		Holen Sie sich Karten mit einer bestimmten Seltenheit
`quality`		Holen Sie sich Karten mit einer bestimmten Qualität
`god`		Holen Sie sich Karten mit einem bestimmten Gott
`type`		Holen Sie sich Karten mit einem bestimmten Typ
`tribe`		Holen Sie sich Karten mit einem bestimmten Stamm
`purity`		Erhalten Sie Karten innerhalb eines Reinheitsbereichs
`mana`		Erhalte Karten innerhalb einer Manareichweite
`health`		Erhalte Karten innerhalb eines Gesundheitsbereichs
`attack`		Holen Sie sich Karten mit einer Angriffsreichweite
`proto`		Holen Sie sich Karten mit einer bestimmten Prototyp-ID

Antwortformat

 {
    "total": 380,
    "page": 1,
    "perPage": 1,
    "records": [
        {
            "proto": 1,
            "purities": [
                "100", "200", "300", "2999"
            ]
        }
    ]
}

DeckString-APIs

DeckStrings sind ein praktischer Standard, der es Anwendungen ermöglicht, Decks zu importieren und zu exportieren. Die folgenden APIs bieten eine praktische Schnittstelle für grundlegende Deck-String-Operationen.

POST /Deck

Kodiert ein Deck in einen Deck-String.

Anforderungstext

 {
    "version": 1,
    "god": "deception",
    "protos": [
        290, 17, 201, 201, 80, 80, 93, 93, 64, 64, 185, 185, 55, 55, 97, 331, 281, 281, 252, 252, 330,
		330, 280, 202, 202, 265, 265, 37, 94, 94
    ]
}

Antwortformat

 AQYBBhElYZgCogLLAgIMN0BQXV65AckBygH8AYkCmQLKAg==

GET /deck/{string}

Dekodiert ein Deck aus einer Deck-Zeichenfolge.

Parameter

Antwortformat

 {
    "version": 1,
    "god": "deception",
    "protos": [
        290, 17, 201, 201, 80, 80, 93, 93, 64, 64, 185, 185, 55, 55, 97, 331, 281, 281, 252, 252, 330,
		330, 280, 202, 202, 265, 265, 37, 94, 94
    ]
}

GET /mode

Listet die Spielmodi mit einigen Eigenschaften auf.

Antwortformat

 [
 {
  "id": 2,
  "name": "Constructed",
  "description": "Classic Contructed",
  "live": true,
  "required_level": 0,
  "properties": {
   "type": 4,
   "image_url": "https://images.godsunchained.com/misc/classic_constructed.webp"
  }
 }
]

GET /match

Zeigen Sie die Spielergebnisse an

Parameter

Name	Typ	Beschreibung
`start_time`		Startzeit des Spiels (UNIX-Epochenformat)
`end_time`		Endzeit des Spiels (UNIX-Epochenformat)
`player_won`		user_id eines Spielers
`player_lost`		user_id eines Spielers
`game_mode`		game_mode-Kennung

Wichtig : Das Feld „total_turns“ wird bei einem späteren Update in „total_rounds“ umbenannt. Wir werden es weiterhin unterstützen, während wir sicherstellen, dass unsere Community den neuen Feldnamen verwendet.

Antwortformat

 {
 "total": 1447,
 "page": 1,
 "perPage": 20,
 "records": [
  {
   "player_won": 9127,
   "player_lost": 6008,
   "game_mode": 2,
   "game_id": "b64865e2-682b-4a23-af11-20aad0cfd47c",
   "start_time": 1560734177,
   "end_time": 1560734355,
   "player_info": [{"god":"nature","cards":[301,121,68,237,976,1000,973,523,910,385,494,467,905,519,907,507,919,916,906,442,386,537,471,928,475,906,454,909,945,920],"global":false,"health":30,"status":"connected","user_id":9127},{"god":"Magic","cards":[401,401,404,404,908,908,455,455,535,535,467,467,926,926,981,981,402,402,504,504,396,396,406,406,983,983,407,407,1002,1002],"global":true,"health":0,"status":"connected","user_id":6008}],
   "total_turns": 6, 
   "total_rounds": 6
  }
 ]
}

GET /rank

Zeigt den Rang eines Spielers pro Spielmodus an.

Parameter

Name	Typ	Beschreibung
`user_id`		Apollo-ID des Benutzers
`game_mode`		Spielmodus des Rangs

Antwortformat

 {
 "total": 543,
 "page": 1,
 "perPage": 20,
 "records": [
  {
   "user_id": 9115,
   "game_mode": 1,
   "rating": 952,
   "rank_level": 1,
   "win_points": 82.849302,
   "loss_points": 86.586029
  },
  {
   "user_id": 2317,
   "game_mode": 2,
   "rating": 875.627936,
   "rank_level": 1,
   "win_points": 48.249483,
   "loss_points": 89.55682
  }
 ]
}

GET /properties

Zeigen Sie die Eigenschaften der Spieler an.

Parameter

Name	Typ	Beschreibung
`user_id`		Apollo-ID des Benutzers

Antwortformat

 {
 "total": 8298,
 "page": 1,
 "perPage": 20,
 "records": [
  {
   "user_id": 612,
   "xp_level": 0,
   "total_xp": 0,
   "xp_to_next": 25,
   "won_matches": 0,
   "lost_matches": 0,
   "username": "bestplayer"
  },
  {
   "user_id": 706,
   "xp_level": 36,
   "total_xp": 25850,
   "xp_to_next": 350,
   "won_matches": 51,
   "lost_matches": 40,
   "username": "broken_player"
  }
 ]
}

GET /vorhersagen

Berechnet die Wahrscheinlichkeit eines Spiels basierend auf der Bewertung der Spieler (unter Verwendung des Elo-Bewertungsalgorithmus).

Parameter

Name	Typ	Beschreibung
`user_id`		Apollo-ID des Benutzers
`opponent_id`		Apollo-ID des Gegners
`game_mode`		der Spielmodus des Spiels

Antwortformat

 0.6717130465747431

Hochwertige APIs

Die Qualitäts-APIs liefern Daten über die Qualitäten und deren visuelle Zusammensetzung, die von öffentlichen Systemen verwendet werden.

GET /Qualität

Zeigt alle aktiven Qualitätsklassendefinitionen und zugehörige Informationen an. Wird hauptsächlich von unterstützenden Systemen wie Namens- und ID-Beziehungen oder Metadatenüberschreibungen verwendet.

Antwortformat

 [
    {
        "class_key": "quality",
        "class_value": "2",
        "class_properties": {
            "name": "gold"
        },
        "class_type": "card",
        "game_id": 1
    },
    ...
]

GET /quality/{quality}

Zeigt die angegebene Qualitätsklassendefinition und zugehörige Informationen an. Wird hauptsächlich von unterstützenden Systemen wie Namens- und ID-Beziehungen oder Metadatenüberschreibungen verwendet.

Parameter

Name	Typ	Beschreibung
`quality`		Qualitäts-ID

Antwortformat

 {
 "class_key": "quality",
 "class_value": "2",
 "class_properties": {
  "name": "gold"
 },
 "class_type": "card",
 "game_id": 1
}

GET /composition

Zeigt alle grafischen Kompositionsdaten an, die zum Generieren von Bildern für die angegebenen Proto- und Qualitätskombinationen für die in Gods Unchained verwendete NFT-Kunst erforderlich sind. Derzeit werden nur Kartengrafiken unterstützt.

Parameter

Name	Typ	Beschreibung	Beispiel
`pairs`		Proto und Qualität werden mit einem `@` -Trennzeichen definiert	`1234@5`

Antwortformat

 [
 {
  "id": 1234,
  "name": "Born Again",
  "effect": "Pull a creature from your void to your hand. Give it +5/+5 and ward.",
  "god": "light",
  "rarity": "epic",
  "tribe": { "String": "", "Valid": false },
  "mana": 6,
  "attack": { "Int64": 0, "Valid": false },
  "health": { "Int64": 0, "Valid": false },
  "type": "spell",
  "set": "core",
  "collectable": true,
  "live": "true",
  "art_id": "C448",
  "lib_id": "L2-235",
  "composition": {
   "illustration": [
    "1234"
   ],
   "frame": [
    "spell",
    "spell_plain"
   ],
   "rosette": [
    "light",
    "light_plain"
   ],
   "gems": [
    "rarity_epic"
   ],
   "wreath": [],
   "lock": [
    "lock_plain"
   ],
   "tribe_bar": [],
   "set": [
    "core"
   ]
  }
 }
]

Expandieren