API Referentie
Perfectioneer je aim met precisie — integraar AimForge-conversies en pro-player data direct in je applicatie.
Endpoint-overzicht
AimForge biedt een RESTful API met JSON-responses. Alle endpoints vereisen een Bearer-token via de Authorization-header. Rate-limiting is ingesteld op 1.200 verzoeken per minuut per token.
GET /api/v1/convert/sensitivity
Converteert muisgevoeligheid tussen spellen. Voer een bron- en doelspel in en ontvang de exacte equivalentie met DPI-correctie. Ondersteunt 42 titels waaronder Valorant, CS2, Overwatch 2 en Apex Legends.
POST /api/v1/convert/batch
Bulk-conversie van meerdere gevoeligheidsprofielen in één verzoek. Accepteert een JSON-array met tot 50 objecten per call. Ideaal voor tools die volledige player-databases migreren.
GET /api/v1/players/{player_id}/sensitivity
Haalt de gepubliceerde muisinstellingen op van een pro-player. Retourneert in-game sensitivity, DPI, eDPI, poll rate en het spel waar de instelling voor geldt. Data wordt dagelijks gesynchroniseerd met openbare bronnen.
GET /api/v1/players/search
Doorzoekt de pro-player database op naam, team of spel. Query-parameters: q (zoekterm), game (filter op titel), team (filter op organisatie). Maximaal 20 resultaten per pagina.
GET /api/v1/teams/{team_slug}/roster
Retourneert de volledige actieve roster van een team met per speler de huidige sensitivity-configuratie. Teams zoals Sentinels, FaZe en NAVI zijn volledig gedekt.
GET /api/v1/games/list
Lijst alle ondersteunde spellen op met hun interne ID, display-naam en conversie-algoritme-versie. Nieuwe titels worden maandelijks toegevoegd op basis van community-aanvragen.
Code-snippets
Kopieer en plak deze voorbeelden om direct te beginnen. Alle voorbeelden gebruiken de AimForge sandbox-omgeving op https://sandbox.api.aimforge.dev.
Sensitiviteit converteren: CS2 → Valorant
const response = await fetch(
'https://api.aimforge.dev/api/v1/convert/sensitivity' +
'?from=cs2&to=valorant&sensitivity=2.5&dpi=800',
{ headers: { 'Authorization': 'Bearer af_live_8xK2mP9vQr' } }
);
const data = await response.json();
// { "target_sensitivity": 0.45, "edpi_source": 2000, "edpi_target": 360, "algorithm": "yaw-matched-v3" }
Pro-player opzoeken: TenZ
import requests
resp = requests.get(
'https://api.aimforge.dev/api/v1/players/search',
params={'q': 'TenZ', 'game': 'valorant'},
headers={'Authorization': 'Bearer af_live_8xK2mP9vQr'}
)
player = resp.json()['results'][0]
print(player['player_id'], player['team'])
# vf_00421 "Sentinels"
Bulk-conversie: 3 profielen in één call
curl -X POST https://api.aimforge.dev/api/v1/convert/batch \
-H "Authorization: Bearer af_live_8xK2mP9vQr" \
-H "Content-Type: application/json" \
-d '[
{"from":"ow2","to":"cs2","sensitivity":6.0,"dpi":400},
{"from":"apex","to":"valorant","sensitivity":0.4,"dpi":1600},
{"from":"cs2","to":"r6","sensitivity":1.8,"dpi":800}
]'
Roster ophalen: FaZe Clan (Valorant)
const response = await fetch(
'https://api.aimforge.dev/api/v1/teams/faze/roster',
{ headers: { 'Authorization': 'Bearer af_live_8xK2mP9vQr' } }
);
const roster = await response.json();
roster.players.forEach(p => {
console.log(`${p.name} → ${p.sensitivity} @ ${p.dpi} DPI`);
});
// "brokenshield → 0.032 @ 800 DPI"
// "FNS → 0.028 @ 800 DPI"
Authenticatie & limieten
Elk verzoek moet een geldig API-token bevatten in de Authorization-header. Tokens worden gegenereerd via het developer-dashboard en zijn gekoppeld aan je accountplan.
100 verzoeken / minuut
Toegang tot conversie-endpoints en spelers-zoekopdrachten. Geen batch-conversie. Sandbox-toegang inbegrepen.
1.200 verzoeken / minuut
Volledige endpoint-toegang inclusief batch-conversie en team-roster data. Live-production omgeving. Prioriteit-support via Slack.
Op maat
Onbeperkte rate-limits, dedicated endpoint-URL, SLA-afspraken en wekelijkse data-dumps in CSV/Parquet-formaat. Neem contact op via enterprise@aimforge.dev.