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.

Conversie

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.

Conversie

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.

Pro-Stats

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.

Pro-Stats

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.

Pro-Stats

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.

Conversie

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.

JavaScript / Fetch

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" }

Python / requests

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"

cURL

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}
  ]'

JavaScript / Fetch

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.

Free

100 verzoeken / minuut

Toegang tot conversie-endpoints en spelers-zoekopdrachten. Geen batch-conversie. Sandbox-toegang inbegrepen.

Pro

1.200 verzoeken / minuut

Volledige endpoint-toegang inclusief batch-conversie en team-roster data. Live-production omgeving. Prioriteit-support via Slack.

Enterprise

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.