The following includes the details of how to interface with the artist version records through the API.
Record field format
| Name | Type | Details |
|---|
| [code]id[/code] | integer | >0 |
| [code]artist_id[/code] | integer | >0 |
| [code]name[/code] | string | |
| [code]urls[/code] | array | |
| [code]other_names[/code] | array | |
| [code]group_name[/code] | string | |
| [code]is_banned[/code] | boolean | |
| [code]updater_id[/code] | integer | >0 |
| [code]created_at[/code] | timestamp | |
| [code]updated_at[/code] | timestamp | |
| [code]updater_addr_ip[/code] | inet | Limited to Moderator+ |
Associated attributes
| Name | Type | Number | Availability | Details |
|---|
| [code]artist[/code] | artist | single | required | |
| [code]updater[/code] | user | single | required | |
Nomenclature
- Plural form: "artist_versions"
- Used in the URL pathname
- Singular form: "artist_version"
- Unused
- Version of: API:Artists
Actions
These are the various actions that can be done with artist version records.
Index
| HTTP Method | GET |
| Base URL | [code]/artist_versions.json[/code] |
| Type | read request |
| Description | The default order is ID descending. |
All of the following are standard attributes with all of their available formats and qualifiers.
- [code]order[/code] - Sets the order of results.
- [code]name[/code] - Alphabetical on the name field.
Show
| HTTP Method | GET |
| Base URL | [code]/artist_versions/$id.json[/code] |
| Type | read request |
| Description | [code]$id[/code] is the artist version ID. |
See also
External links
| Controller | <https://github.com/danbooru/danbooru/blob/master/app/controllers/artists_versions_controller.rb> | |
| Model | <https://github.com/danbooru/danbooru/blob/master/app/models/artist_version.rb> |
| Policy | <https://github.com/danbooru/danbooru/blob/master/app/policies/artist_version_policy.rb> |