IodidDOCUMENTATION

api/summoner/refresh.mdx

/doc/api/summoner/refresh

PUBLIC DOCUMENTATION

Refresh profile

Force a profile refresh — 204 with 60s cooldown, background recomputation.

POST/api/lol/{shard}/profile/{puuid}/refresh

Force refresh

Path params

Request
https://api.safjnest.com/api/lol/EUW1/profile/{puuid}/refresh
curl -X POST "https://api.safjnest.com/api/lol/EUW1/profile/{puuid}/refresh"

Missing required: puuid

CORS enabled (*) — runs directly in your browser against https://api.safjnest.com

POST /api/lol/{shard}/profile/{puuid}/refresh

Force a profile refresh. Returns 204 immediately, work happens in background.

  • Controller: LolController.java:75 → SummonerService.find → 404 if not found → SummonerService.refresh(puuid,shard) + ProfileService.markManuallySeen(puuid) → 204
  • Cooldown: RedisKey.R4J_SUMMONER_REFRESH_COOLDOWN (src/main/java/com/safjnest/redis/RedisKey.java:19) pattern r4j:summoner:refresh:cooldown:%s:%s TTL 60s — SummonerService.refresh uses RedisClient.claim with nx().ex(); if claim fails the refresh is on cooldown
  • Effect: invalidates SUMMONER_OVERVIEW cache, schedules RiotScheduler for R4J fetch and ComputeScheduler for statistics recomputation
ParameterPositionRequiredValidation
shardpathyesrequiredShard
puuidpathyesrequiredText(puuid,"puuid")

curl

bash
curl -X POST "https://api.safjnest.com/api/lol/EUW1/profile/abc123-puuid/refresh" -i
# 204 No Content on success, 404 if puuid unknown, 400 if on cooldown (invalid_request)

Notes

  • Invalid shard → 400
  • Empty puuid → 400
  • Wrong method (GET) → 405 method_not_allowed