@api-emulator/setlistfm
v0.2.2
Published
setlist.fm provides artist, venue, city, country, user, and setlist lookup and search APIs.
Readme
@api-emulator/setlistfm
setlist.fm provides artist, venue, city, country, user, and setlist lookup and search APIs.
Use this emulator for local tests, CI, and offline agent runs. It keeps your tests separate from the production API.
Start the emulator
- Install the package.
npm install @api-emulator/setlistfm- From this registry, start the emulator.
npx -p api-emulator api --plugin ./providers/@setlistfm/api-emulator.mjs --service setlistfmThe emulator uses the local URL that api-emulator prints. Set your client base URL to this local URL.
Supported API
GET /1.0/artist/:mbidGET /1.0/artist/:mbid/setlistsGET /1.0/city/:geoIdGET /1.0/search/artistsGET /1.0/search/citiesGET /1.0/search/countriesGET /1.0/search/setlistsGET /1.0/search/venuesGET /1.0/setlist/version/:versionIdGET /1.0/setlist/:setlistIdGET /1.0/user/:userIdGET /1.0/user/:userId/attendedGET /1.0/user/:userId/editedGET /1.0/venue/:venueIdGET /1.0/venue/:venueId/setlistsGET /inspect/contractGET /inspect/state
Coverage
- Level:
smoke-only - Meaning: A smoke test starts the emulator and checks its main behavior.
- Evidence: a direct smoke test exists, but a conformance manifest does not exist.
Credentials
Use a fixed bearer token or API key in each test. The emulator does not send these credentials to the provider.
Test data
Add repeatable test data to the provider configuration.
setlistfm:
# Add provider-specific seed state here.