skill: document /spells ?aura= filter (69 absorb, 354 heal-to-absorb proc, 301 heal-absorb)

This commit is contained in:
Florian Andrew George Berthold 2026-06-10 02:17:43 +02:00
parent 61972baa78
commit a299ffff75

View file

@ -45,7 +45,7 @@ quality color (`q0` poor … `q4` epic, `q5` legendary, `q6` artifact).
| `GET /api/v1/spells/{id}` | spell detail |
| `GET /api/v1/npcs/{id}` | NPC detail |
| `GET /api/v1/quests/{id}` | quest detail |
| `GET /api/v1/spells?mechanic=&effect_mechanic=&dispel_type=&limit=&cursor=` | filterable spell catalogue (keyset-paginated; `cursor` = last id seen, `limit` 11000 default 200) |
| `GET /api/v1/spells?mechanic=&effect_mechanic=&aura=&dispel_type=&limit=&cursor=` | filterable spell catalogue (keyset-paginated; `cursor` = last id seen, `limit` 11000 default 200) |
| `GET /api/v1/changes` | newest-first change_event log |
| `GET /api/v1/health` | `{status, version, database}` (200 even in fixtures-only mode; data endpoints return 503 if `database=false`) |
@ -73,8 +73,16 @@ not yet catalogued). `description` can contain `@…@`-wrapped flavour tags
curl -s 'https://db.exil.es/api/v1/spells?mechanic=15&limit=1000'
# every Poison-dispellable aura (dispel_type 4)
curl -s 'https://db.exil.es/api/v1/spells?dispel_type=4'
# every damage-absorb shield (aura 69 = SCHOOL_ABSORB)
curl -s 'https://db.exil.es/api/v1/spells?aura=69&limit=1000'
```
The `aura` filter matches any effect whose applied aura equals the value:
69=SCHOOL_ABSORB (damage-absorb shield), 354=CoA heal→absorb proc,
301=SCHOOL_HEAL_ABSORB (anti-heal debuff). AND-combines with the other
filters. It is live on db.exil.es now; don't gate on the `/health` `version`
field, which currently lags the deployed feature set (reports 0.1.0).
Common codes: mechanic 15=Bleed, 1=Charm, 19=Disarm; dispel_type 1=Magic,
2=Curse, 3=Disease, 4=Poison.