Endpunkt-Guthaben

Ein Endpunkt-Guthaben ist ein Aufruf eines Endpunkts, den dein Tarif nicht enthält. Jedes neue Konto startet mit 50 einmaligen Guthaben, die jeden Endpunkt bis Studio erreichen, damit du die Aufrufe eines bezahlten Tarifs ausprobieren kannst, bevor du dich entscheidest.

Willkommen
50Guthaben
Einmalig bei der Anmeldung. Wird nicht erneuert.
Einmal
Vergeben
Nie
Erneuert
Studio
Bis
62
Endpunkte
Stand prüfen
Vom Team
Auf Anfrage
Das Team kann einem Konto Guthaben geben, für einen Tarif oder eine Liste von Endpunkten.
Tarif/Liste
Umfang
Optional
Ende
Jederzeit
Rückzug
Auf Anfrage
Enterprise
Support fragen
Verbrauch
1Guthaben pro Aufruf
Verbraucht eines, beantwortet wie dieser Tarif.
Alle Felder
Antwort
Header
Markiert
Nie
Cache
Gelten
Limits
Was sie abdecken
Bei Fehlern
Zurück
Ein Fehler oder ein 304 verbraucht kein Guthaben.
Zurück
Fehler
Zurück
304
Ein Stand
Schlüssel
Dem Konto
Gehört
So wird verbraucht

Einmalig, nicht jeden Monat

Die Willkommensgutschrift ist ein Test, kein kleinerer Tarif. Sie kommt nicht am Monatsersten wieder.

Die Gutschrift wird beim Anlegen des Kontos vergeben, und es ist die einzige, die ein Konto von selbst erhält. Konten, die beim Start schon im kostenlosen Tarif waren, haben sie ebenfalls erhalten.
Sind die Guthaben verbraucht, liefert ein Aufruf eines Endpunkts oberhalb deines Tarifs 403 PLAN_REQUIRED, wie ohne sie. Um diese Endpunkte weiter zu nutzen, wechsle in einen Tarif, der sie enthält: siehe Limits und Tarife.
Das Team kann einem Konto mehr Guthaben geben, für eine benannte Liste von Endpunkten oder für alles bis zu einem Tarif, und ein Enddatum setzen. Frag über den Support nach, wenn du einen Anwendungsfall hast.
Eine Gutschrift kann zurückgezogen werden. Aufrufe, die sie schon bezahlt hat, bleiben verbraucht.

Wofür sie genutzt werden können

62 Endpunkte in 10 Referenzbereichen, jeder oberhalb des kostenlosen Tarifs und höchstens bis Studio. Die Liste wird aus den Zugriffsregeln der API selbst gelesen, sie zeigt also, wofür ein Guthaben heute ausgegeben werden kann.

62 Endpunkte in 10 Bereichen

✓ im Tarif enthalten mit Guthaben erreichbar

#		Endpunkt	Builder	Studio	Enterprise
Firearms27 Endpunkte
001	GET	`/v1/firearms/search` Search Firearms	✓	✓	✓
002	GET	`/v1/firearms/resolve` Resolve a Name	✓	✓	✓
003	POST	`/v1/firearms/resolve` Resolve Many Names		✓	✓
004	GET	`/v1/firearms/compare` Compare Firearms	✓	✓	✓
005	GET	`/v1/firearms/{id}` Get Firearm	✓	✓	✓
006	GET	`/v1/firearms/{id}/images/{imageId}` Get image asset	✓	✓	✓
007	GET	`/v1/firearms/{id}/media/{selector}` One asset	✓	✓	✓
008	GET	`/v1/firearms/{id}/schematics` Get Schematics		✓	✓
009	GET	`/v1/firearms/{id}/silhouette` Silhouette SVG	✓	✓	✓
010	GET	`/v1/firearms/{id}/model` Get 3D model	✓	✓	✓
011	GET	`/v1/firearms/{id}/game-profile` Game Profile	✓	✓	✓
012	GET	`/v1/firearms/{id}/dimensions` Dimensions	✓	✓	✓
013	GET	`/v1/firearms/{id}/family-tree` Get Family Tree	✓	✓	✓
014	GET	`/v1/firearms/{id}/adoption-map` Adoption Map		✓	✓
015	GET	`/v1/firearms/top` Top Firearms	✓	✓	✓
016	GET	`/v1/firearms/head-to-head` Head to Head	✓	✓	✓
017	GET	`/v1/firearms/game-meta` Find by Archetype	✓	✓	✓
018	GET	`/v1/firearms/by-feature` By Feature	✓	✓	✓
019	GET	`/v1/firearms/by-material` By Material	✓	✓	✓
020	GET	`/v1/firearms/by-designer` By Designer	✓	✓	✓
021	GET	`/v1/firearms/by-conflict` By Conflict		✓	✓
022	GET	`/v1/firearms/power-rating` Power Rating	✓	✓	✓
023	GET	`/v1/firearms/timeline` Timeline	✓	✓	✓
024	GET	`/v1/firearms/load-carriage` Compare the cost of marching with each firearm	✓	✓	✓
025	GET	`/v1/firearms/recoil` Compare the free recoil of each firearm	✓	✓	✓
026	GET	`/v1/firearms/point-blank` Compare the point-blank and supersonic range of each firearm	✓	✓	✓
027	GET	`/v1/firearms/ammo-load` Compare how much ammunition each firearm carries per kilogram	✓	✓	✓
Compatibility6 Endpunkte
028	GET	`/v1/firearms/{id}/interfaces` Get a firearm's mount interfaces		✓	✓
029	GET	`/v1/firearms/{id}/attachments` List attachments that fit a firearm		✓	✓
030	GET	`/v1/attachments/{id}/firearms` List firearms an attachment fits		✓	✓
031	GET	`/v1/interfaces/{id}/firearms` List firearms exposing a standard		✓	✓
032	GET	`/v1/platforms` List platforms		✓	✓
033	GET	`/v1/platforms/{id}` Get a platform		✓	✓
Manufacturers2 Endpunkte
034	GET	`/v1/manufacturers/{id}/timeline` Manufacturer Timeline		✓	✓
035	GET	`/v1/manufacturers/{id}/stats` Manufacturer Stats	✓	✓	✓
Calibers4 Endpunkte
036	GET	`/v1/calibers/compare` Compare Calibers	✓	✓	✓
037	GET	`/v1/calibers/ballistics` Ballistics Calculator	✓	✓	✓
038	GET	`/v1/calibers/{id}/parent-chain` Parent Cartridge Chain	✓	✓	✓
039	GET	`/v1/calibers/{id}/family` Caliber Family Tree	✓	✓	✓
Ammunition6 Endpunkte
040	GET	`/v1/firearms/{id}/calculate` Calculate Firearm Ballistics	✓	✓	✓
041	GET	`/v1/firearms/{id}/load` Load Firearm	✓	✓	✓
042	GET	`/v1/calibers/{id}/ammunition` Ammunition by Caliber	✓	✓	✓
043	GET	`/v1/ammunition` List Ammunition	✓	✓	✓
044	GET	`/v1/ammunition/{id}` Get Ammunition	✓	✓	✓
045	GET	`/v1/ammunition/{id}/ballistics` Ammunition Ballistics	✓	✓	✓
Game Stats Snapshots4 Endpunkte
046	GET	`/v1/firearms/{id}/game-stats` Get Game Stats (Live)	✓	✓	✓
047	GET	`/v1/game-stats/versions` List Snapshot Versions	✓	✓	✓
048	GET	`/v1/game-stats/versions/{version}/firearms` List Firearms in Version	✓	✓	✓
049	GET	`/v1/game-stats/versions/{version}/firearms/{id}` Get Firearm in Version	✓	✓	✓
Statistics & Analytics6 Endpunkte
050	GET	`/v1/stats/by-era` Stats by Era		✓	✓
051	GET	`/v1/stats/materials` Material Breakdown		✓	✓
052	GET	`/v1/stats/adoption/by-country` Adoption by Country		✓	✓
053	GET	`/v1/stats/adoption/by-type` Adoption by Type		✓	✓
054	GET	`/v1/stats/feature-frequency` Feature Frequency	✓	✓	✓
055	GET	`/v1/stats/caliber-popularity-by-era` Caliber Popularity by Era		✓	✓
Game Balance5 Endpunkte
056	GET	`/v1/game/balance-report` Balance Report		✓	✓
057	GET	`/v1/game/tier-list` Tier List	✓	✓	✓
058	GET	`/v1/game/matchups` Matchups	✓	✓	✓
059	GET	`/v1/game/role-roster` Role Roster	✓	✓	✓
060	GET	`/v1/game/stat-distribution` Stat Distribution		✓	✓
Countries1 Endpunkte
061	GET	`/v1/countries/{code}/arsenal` Country Arsenal	✓	✓	✓
Conflicts1 Endpunkte
062	GET	`/v1/conflicts` List Conflicts	✓	✓	✓

9 Endpunkte liegen oberhalb von Studio und sind nicht abgedeckt. Die Endpunkt-Zugriffstabelle zeigt jeden Endpunkt und welche Tarife ihn enthalten.

Was passiert, wenn du eines ausgibst

An der Anfrage ändert sich nichts. Rufe den Endpunkt so auf, wie du es in einem Tarif tätest, der ihn enthält.

Du rufst den Endpunkt auf
Sende die Anfrage genau so, wie du es in einem Tarif tätest, der den Endpunkt enthält.
Das Gate prüft deinen Tarif
Enthält dein Tarif den Endpunkt, wird nichts verbraucht. Enthält er ihn nicht und das Konto hat ein passendes Guthaben, wird eines verbraucht und der Aufruf geht durch.
Er wird wie dieser Tarif beantwortet
Ein Detailaufruf liefert den vollständigen Datensatz statt der Kurzfassung des kostenlosen Tarifs, mit der Seitentiefe dieses Tarifs. Die Antwort trägt X-Endpoint-Credit: spent und wird nie in einem gemeinsamen Cache gespeichert.
Deine Limits gelten weiter
Guthaben erweitern, welche Endpunkte du erreichst, nicht wie viel du senden darfst. Der Aufruf zählt wie jeder andere gegen dein Minutenlimit und dein Tageslimit.
Ein Fehler wird zurückgebucht
Schlägt der Aufruf fehl oder antwortet er auf ein If-None-Match mit 304 Not Modified, wird das Guthaben zurückgegeben.
Ohne Guthaben wird abgelehnt
Der Aufruf liefert PLAN_REQUIRED, wie ohne Guthaben.

1HTTP/2 2002X-Endpoint-Credit: spent3X-Daily-Limit: 504X-Daily-Remaining: 415Cache-Control: private, no-store

1HTTP/2 4032{3  "success": false,4  "error": {5    "code": "FORBIDDEN",6    "reason": "PLAN_REQUIRED",7    "message": "This endpoint requires 'builder' tier or above. Your tier: 'explorer'"8  }9}

Deinen Stand prüfen

Dein Stand steht auf der Nutzungsseite deines Kontos, sobald das Konto Guthaben hat. Dieselben Zahlen liefert GET /v1/me/usage unter endpointCredits.

Feld	Bedeutung
`endpointCredits.remaining`	Verbleibende Aufrufe über alle Guthaben, die noch ausgegeben werden können.
`credits[].source`	welcome für die einmalige Gutschrift jedes Kontos, staff für ein Guthaben, das dir das Team gegeben hat.
`credits[].operations / maxTier`	Die Operationen, die ein Guthaben abdeckt, oder der höchste Tarif, den es erreicht, wenn es alles bis zu einem Tarif abdeckt.
`credits[].callsGranted`	Aufrufe, mit denen das Guthaben vergeben wurde.
`credits[].callsUsed`	Bisher verbrauchte Aufrufe.
`credits[].callsRemaining`	Verbleibende Aufrufe. Null, sobald es verbraucht, abgelaufen oder zurückgezogen ist.
`credits[].status`	active, spent, expired oder revoked.
`credits[].expiresAt`	Wann es verfällt, oder null, wenn nicht.

Ein Guthaben-Aufruf zählt weiterhin gegen die Limits unter Limits und Tarife.