songtradr_api_client_ruby 1.12.24 → 1.13.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Gemfile.lock +2 -2
- data/README.md +6 -5
- data/docs/ApiKeyDTO.md +3 -3
- data/docs/CategoryMediumDTO.md +3 -3
- data/docs/FileSmallDTO.md +16 -16
- data/docs/MusicalFeaturesDTO.md +62 -62
- data/docs/PlaylistLargeDTO.md +3 -3
- data/docs/ProductMediumDTO.md +2 -2
- data/docs/RecordingApi.md +4 -0
- data/docs/RecordingGenrePredictionDTO.md +2 -2
- data/docs/RecordingMediumDTO.md +2 -0
- data/docs/TrackDTO.md +18 -0
- data/docs/TrackToMediumProductDTO.md +3 -3
- data/getspec.rb +34 -15
- data/lib/songtradr_api_client_ruby/api/allowed_values_api.rb +2 -2
- data/lib/songtradr_api_client_ruby/api/api_keys_api.rb +2 -2
- data/lib/songtradr_api_client_ruby/api/party_api.rb +2 -2
- data/lib/songtradr_api_client_ruby/api/playlist_api.rb +2 -2
- data/lib/songtradr_api_client_ruby/api/recording_api.rb +8 -2
- data/lib/songtradr_api_client_ruby/api/user_api.rb +2 -2
- data/lib/songtradr_api_client_ruby/api_client.rb +2 -2
- data/lib/songtradr_api_client_ruby/api_error.rb +2 -2
- data/lib/songtradr_api_client_ruby/configuration.rb +4 -4
- data/lib/songtradr_api_client_ruby/models/admin_api_user_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/api_key_dto.rb +22 -22
- data/lib/songtradr_api_client_ruby/models/category_medium_dto.rb +17 -17
- data/lib/songtradr_api_client_ruby/models/category_minimal_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/config_access_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/config_identifier_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/contributor_type_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/create_api_key_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/error_response.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/field_summary_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/file_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/file_list_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/file_minimal_with_url_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/file_small_dto.rb +64 -64
- data/lib/songtradr_api_client_ruby/models/file_upload_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/file_w_ith_url_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/files_summary_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/forgot_password_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/genre_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/genre_minimal_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/genres_summary_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/init_put_recording_audio_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/jwt_token_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/login_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/musical_features_dto.rb +498 -498
- data/lib/songtradr_api_client_ruby/models/p_line_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/party_large_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/party_small_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/playlist_large_dto.rb +15 -15
- data/lib/songtradr_api_client_ruby/models/product_medium_dto.rb +12 -12
- data/lib/songtradr_api_client_ruby/models/product_party_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/recording_for_similarity_search_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/recording_genre_prediction_dto.rb +19 -19
- data/lib/songtradr_api_client_ruby/models/recording_large_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/recording_list_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/recording_medium_dto.rb +14 -3
- data/lib/songtradr_api_client_ruby/models/recording_minimal_with_musical_features_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/recording_minimal_with_taggrams_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/recording_minimal_with_tagstrengths_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/recording_party_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/recording_playlist_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/recording_small_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/recording_tag_small_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/save_file_recording_dto.rb +14 -14
- data/lib/songtradr_api_client_ruby/models/save_playlist_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/save_recording_genre_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/save_recording_party_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/save_recording_playlist_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/save_recording_tag_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/save_referrer_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/save_taggrams_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/save_user_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/search_filter_values_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/search_recording_granular_abstraction_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/search_recording_granular_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/sign_up_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/tag_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/tag_small_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/taggram_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/tags_summary_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/tagstrength_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/title_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/token_request.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/track_dto.rb +215 -0
- data/lib/songtradr_api_client_ruby/models/track_to_medium_product_dto.rb +22 -22
- data/lib/songtradr_api_client_ruby/models/update_password_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/usage_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/user_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/version.rb +3 -3
- data/lib/songtradr_api_client_ruby.rb +3 -2
- data/openapi-generator-config.yaml +1 -1
- data/songtradr_api_client_ruby.gemspec +2 -2
- data/spec/api/allowed_values_api_spec.rb +2 -2
- data/spec/api/api_keys_api_spec.rb +2 -2
- data/spec/api/party_api_spec.rb +2 -2
- data/spec/api/playlist_api_spec.rb +2 -2
- data/spec/api/recording_api_spec.rb +4 -2
- data/spec/api/user_api_spec.rb +2 -2
- data/spec/api_client_spec.rb +2 -2
- data/spec/configuration_spec.rb +2 -2
- data/spec/models/admin_api_user_dto_spec.rb +2 -2
- data/spec/models/api_key_dto_spec.rb +5 -5
- data/spec/models/category_medium_dto_spec.rb +4 -4
- data/spec/models/category_minimal_dto_spec.rb +2 -2
- data/spec/models/config_access_dto_spec.rb +2 -2
- data/spec/models/config_identifier_dto_spec.rb +2 -2
- data/spec/models/contributor_type_dto_spec.rb +2 -2
- data/spec/models/create_api_key_dto_spec.rb +2 -2
- data/spec/models/error_response_spec.rb +2 -2
- data/spec/models/field_summary_dto_spec.rb +2 -2
- data/spec/models/file_dto_spec.rb +2 -2
- data/spec/models/file_list_dto_spec.rb +2 -2
- data/spec/models/file_minimal_with_url_dto_spec.rb +2 -2
- data/spec/models/file_small_dto_spec.rb +16 -16
- data/spec/models/file_upload_dto_spec.rb +2 -2
- data/spec/models/file_w_ith_url_dto_spec.rb +2 -2
- data/spec/models/files_summary_dto_spec.rb +2 -2
- data/spec/models/forgot_password_dto_spec.rb +2 -2
- data/spec/models/genre_dto_spec.rb +2 -2
- data/spec/models/genre_minimal_dto_spec.rb +2 -2
- data/spec/models/genres_summary_dto_spec.rb +2 -2
- data/spec/models/init_put_recording_audio_dto_spec.rb +2 -2
- data/spec/models/jwt_token_dto_spec.rb +2 -2
- data/spec/models/login_dto_spec.rb +2 -2
- data/spec/models/musical_features_dto_spec.rb +203 -203
- data/spec/models/p_line_dto_spec.rb +2 -2
- data/spec/models/party_large_dto_spec.rb +2 -2
- data/spec/models/party_small_dto_spec.rb +2 -2
- data/spec/models/playlist_large_dto_spec.rb +8 -8
- data/spec/models/product_medium_dto_spec.rb +5 -5
- data/spec/models/product_party_dto_spec.rb +2 -2
- data/spec/models/recording_for_similarity_search_dto_spec.rb +2 -2
- data/spec/models/recording_genre_prediction_dto_spec.rb +4 -4
- data/spec/models/recording_large_dto_spec.rb +2 -2
- data/spec/models/recording_list_dto_spec.rb +2 -2
- data/spec/models/recording_medium_dto_spec.rb +8 -2
- data/spec/models/recording_minimal_with_musical_features_dto_spec.rb +2 -2
- data/spec/models/recording_minimal_with_taggrams_dto_spec.rb +2 -2
- data/spec/models/recording_minimal_with_tagstrengths_dto_spec.rb +2 -2
- data/spec/models/recording_party_dto_spec.rb +2 -2
- data/spec/models/recording_playlist_dto_spec.rb +2 -2
- data/spec/models/recording_small_dto_spec.rb +2 -2
- data/spec/models/recording_tag_small_dto_spec.rb +2 -2
- data/spec/models/save_file_recording_dto_spec.rb +8 -8
- data/spec/models/save_playlist_dto_spec.rb +2 -2
- data/spec/models/save_recording_genre_dto_spec.rb +2 -2
- data/spec/models/save_recording_party_dto_spec.rb +2 -2
- data/spec/models/save_recording_playlist_dto_spec.rb +2 -2
- data/spec/models/save_recording_tag_dto_spec.rb +2 -2
- data/spec/models/save_referrer_dto_spec.rb +2 -2
- data/spec/models/save_taggrams_dto_spec.rb +2 -2
- data/spec/models/save_user_dto_spec.rb +2 -2
- data/spec/models/search_filter_values_dto_spec.rb +2 -2
- data/spec/models/search_recording_granular_abstraction_dto_spec.rb +2 -2
- data/spec/models/search_recording_granular_dto_spec.rb +2 -2
- data/spec/models/sign_up_dto_spec.rb +2 -2
- data/spec/models/tag_dto_spec.rb +2 -2
- data/spec/models/tag_small_dto_spec.rb +2 -2
- data/spec/models/taggram_dto_spec.rb +2 -2
- data/spec/models/tags_summary_dto_spec.rb +2 -2
- data/spec/models/tagstrength_dto_spec.rb +2 -2
- data/spec/models/title_dto_spec.rb +2 -2
- data/spec/models/token_request_spec.rb +2 -2
- data/spec/models/track_dto_spec.rb +34 -0
- data/spec/models/track_to_medium_product_dto_spec.rb +5 -5
- data/spec/models/update_password_dto_spec.rb +2 -2
- data/spec/models/usage_dto_spec.rb +2 -2
- data/spec/models/user_dto_spec.rb +2 -2
- data/spec/spec_helper.rb +2 -2
- metadata +62 -58
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: f398b0c9505f9f1ada01eb4af0c4c293a9d7d213ceb4398483b279924435a565
|
4
|
+
data.tar.gz: 494ef201383c2df8dd601720e588f2d0f75304bcbe3f91701bb9a1bdeef71b42
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 5bd83252845fc045724de9058a3ac2ced53b095e12a5868168d2f9b51b765db43649c537ae6d0f27cb66ac23dbca3c7bf1bff87291785d10d062bf4e32900c9c
|
7
|
+
data.tar.gz: d001eb479890cec8fd9292eef821966b823f53ee2ee38d444997b65c7e6b7ff569cdc25bbf738ef3d2c5618f522727c995d775932e11ee8a30e0e0ea86e50346
|
data/Gemfile.lock
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
PATH
|
2
2
|
remote: .
|
3
3
|
specs:
|
4
|
-
songtradr_api_client_ruby (1.
|
4
|
+
songtradr_api_client_ruby (1.13.1)
|
5
5
|
faraday (>= 1.0.1, < 3.0)
|
6
6
|
faraday-multipart
|
7
7
|
|
@@ -59,7 +59,7 @@ GEM
|
|
59
59
|
unicode-display_width (>= 1.4.0, < 1.6)
|
60
60
|
ruby-progressbar (1.13.0)
|
61
61
|
ruby2_keywords (0.0.5)
|
62
|
-
stringio (3.0.
|
62
|
+
stringio (3.0.8)
|
63
63
|
unicode-display_width (1.5.0)
|
64
64
|
|
65
65
|
PLATFORMS
|
data/README.md
CHANGED
@@ -33,8 +33,8 @@ You can either search the released music via the /public/recording endpoints or
|
|
33
33
|
|
34
34
|
This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
|
35
35
|
|
36
|
-
- API version: 1.
|
37
|
-
- Package version: 1.
|
36
|
+
- API version: 1.13.1
|
37
|
+
- Package version: 1.13.1
|
38
38
|
- Build package: org.openapitools.codegen.languages.RubyClientCodegen
|
39
39
|
For more information, please visit [https://songtradr.com](https://songtradr.com)
|
40
40
|
|
@@ -51,16 +51,16 @@ gem build songtradr_api_client_ruby.gemspec
|
|
51
51
|
Then either install the gem locally:
|
52
52
|
|
53
53
|
```shell
|
54
|
-
gem install ./songtradr_api_client_ruby-1.
|
54
|
+
gem install ./songtradr_api_client_ruby-1.13.1.gem
|
55
55
|
```
|
56
56
|
|
57
|
-
(for development, run `gem install --dev ./songtradr_api_client_ruby-1.
|
57
|
+
(for development, run `gem install --dev ./songtradr_api_client_ruby-1.13.1.gem` to install the development dependencies)
|
58
58
|
|
59
59
|
or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
|
60
60
|
|
61
61
|
Finally add this to the Gemfile:
|
62
62
|
|
63
|
-
gem 'songtradr_api_client_ruby', '~> 1.
|
63
|
+
gem 'songtradr_api_client_ruby', '~> 1.13.1'
|
64
64
|
|
65
65
|
### Install from Git
|
66
66
|
|
@@ -221,6 +221,7 @@ Class | Method | HTTP request | Description
|
|
221
221
|
- [SongtradrApiClientRuby::TagstrengthDTO](docs/TagstrengthDTO.md)
|
222
222
|
- [SongtradrApiClientRuby::TitleDTO](docs/TitleDTO.md)
|
223
223
|
- [SongtradrApiClientRuby::TokenRequest](docs/TokenRequest.md)
|
224
|
+
- [SongtradrApiClientRuby::TrackDTO](docs/TrackDTO.md)
|
224
225
|
- [SongtradrApiClientRuby::TrackToMediumProductDTO](docs/TrackToMediumProductDTO.md)
|
225
226
|
- [SongtradrApiClientRuby::UpdatePasswordDTO](docs/UpdatePasswordDTO.md)
|
226
227
|
- [SongtradrApiClientRuby::UsageDTO](docs/UsageDTO.md)
|
data/docs/ApiKeyDTO.md
CHANGED
@@ -5,9 +5,9 @@
|
|
5
5
|
| Name | Type | Description | Notes |
|
6
6
|
| ---- | ---- | ----------- | ----- |
|
7
7
|
| **name** | **String** | | |
|
8
|
+
| **id** | **String** | | |
|
8
9
|
| **last_used_at** | **Time** | | [optional] |
|
9
10
|
| **created_at** | **Time** | | |
|
10
|
-
| **id** | **String** | | |
|
11
11
|
|
12
12
|
## Example
|
13
13
|
|
@@ -16,9 +16,9 @@ require 'songtradr_api_client_ruby'
|
|
16
16
|
|
17
17
|
instance = SongtradrApiClientRuby::ApiKeyDTO.new(
|
18
18
|
name: null,
|
19
|
+
id: null,
|
19
20
|
last_used_at: null,
|
20
|
-
created_at: null
|
21
|
-
id: null
|
21
|
+
created_at: null
|
22
22
|
)
|
23
23
|
```
|
24
24
|
|
data/docs/CategoryMediumDTO.md
CHANGED
@@ -5,8 +5,8 @@
|
|
5
5
|
| Name | Type | Description | Notes |
|
6
6
|
| ---- | ---- | ----------- | ----- |
|
7
7
|
| **id** | **Integer** | | |
|
8
|
-
| **name** | **String** | | |
|
9
8
|
| **tags** | [**Array<TagSmallDTO>**](TagSmallDTO.md) | | [optional] |
|
9
|
+
| **name** | **String** | | |
|
10
10
|
|
11
11
|
## Example
|
12
12
|
|
@@ -15,8 +15,8 @@ require 'songtradr_api_client_ruby'
|
|
15
15
|
|
16
16
|
instance = SongtradrApiClientRuby::CategoryMediumDTO.new(
|
17
17
|
id: null,
|
18
|
-
|
19
|
-
|
18
|
+
tags: null,
|
19
|
+
name: null
|
20
20
|
)
|
21
21
|
```
|
22
22
|
|
data/docs/FileSmallDTO.md
CHANGED
@@ -8,17 +8,17 @@
|
|
8
8
|
| **id** | **Integer** | | |
|
9
9
|
| **extension** | **String** | extension of the file | |
|
10
10
|
| **error_message** | **String** | | [optional] |
|
11
|
-
| **
|
12
|
-
| **
|
13
|
-
| **
|
14
|
-
| **
|
11
|
+
| **folder** | **String** | | |
|
12
|
+
| **object_key** | **String** | | |
|
13
|
+
| **upload_start_time** | **Time** | | [optional] |
|
14
|
+
| **upload_end_time** | **Time** | | [optional] |
|
15
15
|
| **fingerprint_status** | **String** | status of the audio recognition | [optional] |
|
16
|
+
| **fingerprint_start_time** | **Time** | | [optional] |
|
17
|
+
| **fingerprint_end_time** | **Time** | | [optional] |
|
16
18
|
| **inference_status** | **String** | status of the auto-tagging | [optional] |
|
19
|
+
| **inference_start_time** | **Time** | | [optional] |
|
17
20
|
| **inference_end_time** | **Time** | | [optional] |
|
18
|
-
| **
|
19
|
-
| **upload_end_time** | **Time** | | [optional] |
|
20
|
-
| **upload_start_time** | **Time** | | [optional] |
|
21
|
-
| **object_key** | **String** | | |
|
21
|
+
| **error_time** | **Time** | | [optional] |
|
22
22
|
|
23
23
|
## Example
|
24
24
|
|
@@ -30,17 +30,17 @@ instance = SongtradrApiClientRuby::FileSmallDTO.new(
|
|
30
30
|
id: null,
|
31
31
|
extension: null,
|
32
32
|
error_message: null,
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
33
|
+
folder: null,
|
34
|
+
object_key: null,
|
35
|
+
upload_start_time: null,
|
36
|
+
upload_end_time: null,
|
37
37
|
fingerprint_status: null,
|
38
|
+
fingerprint_start_time: null,
|
39
|
+
fingerprint_end_time: null,
|
38
40
|
inference_status: null,
|
41
|
+
inference_start_time: null,
|
39
42
|
inference_end_time: null,
|
40
|
-
|
41
|
-
upload_end_time: null,
|
42
|
-
upload_start_time: null,
|
43
|
-
object_key: null
|
43
|
+
error_time: null
|
44
44
|
)
|
45
45
|
```
|
46
46
|
|
data/docs/MusicalFeaturesDTO.md
CHANGED
@@ -5,7 +5,30 @@
|
|
5
5
|
| Name | Type | Description | Notes |
|
6
6
|
| ---- | ---- | ----------- | ----- |
|
7
7
|
| **space** | **String** | Search for space | [optional] |
|
8
|
+
| **arousal** | **String** | Search for an arousal | [optional] |
|
8
9
|
| **language_of_performance** | **String** | | [optional] |
|
10
|
+
| **dominant_instrument** | **String** | Search for a dominant instrument | [optional] |
|
11
|
+
| **energy** | **String** | Search for energy | [optional] |
|
12
|
+
| **engagement** | **String** | Search for an engagement | [optional] |
|
13
|
+
| **groovyness** | **String** | Search for groovyness | [optional] |
|
14
|
+
| **harmony** | **String** | Search for a degree of harmoniousness | [optional] |
|
15
|
+
| **pleasantness** | **String** | Search for pleasantness | [optional] |
|
16
|
+
| **primary_mood_cluster** | **String** | Search for a language of the lyrics | [optional] |
|
17
|
+
| **primary_sound_character** | **String** | Search for a sound character | [optional] |
|
18
|
+
| **rhythm** | **String** | Search for rhythm | [optional] |
|
19
|
+
| **roughness** | **String** | Search for roughness | [optional] |
|
20
|
+
| **scale** | **String** | Search for a tonal scale | [optional] |
|
21
|
+
| **sound_generation** | **String** | Search for type of sound generation | [optional] |
|
22
|
+
| **tempo** | **String** | Search for tempo | [optional] |
|
23
|
+
| **texture** | **String** | Search for texture | [optional] |
|
24
|
+
| **timbre** | **String** | Search for timbre | [optional] |
|
25
|
+
| **tonality** | **String** | Search for tonality | [optional] |
|
26
|
+
| **valence** | **String** | Search for a valence | [optional] |
|
27
|
+
| **vocals** | **String** | Search for a vocal gender or instrumental songs | [optional] |
|
28
|
+
| **origin_decade** | **String** | Search for origin decade | [optional] |
|
29
|
+
| **curateability** | **String** | Search for curatebility | [optional] |
|
30
|
+
| **use_case** | **String** | Search for use case | [optional] |
|
31
|
+
| **channel_suitability** | **String** | Search for social media suitability | [optional] |
|
9
32
|
| **primary_mood_cluster_affinity** | **Float** | | [optional] |
|
10
33
|
| **secondary_mood_cluster** | **String** | Search for a language of the lyrics | [optional] |
|
11
34
|
| **secondary_mood_cluster_affinity** | **Float** | | [optional] |
|
@@ -49,46 +72,23 @@
|
|
49
72
|
| **use_case_affinity** | **Float** | | [optional] |
|
50
73
|
| **industry_suitability** | **String** | Search for Industry suitability | [optional] |
|
51
74
|
| **industry_suitability_affinity** | **Float** | | [optional] |
|
52
|
-
| **arousal** | **String** | Search for an arousal | [optional] |
|
53
|
-
| **dominant_instrument** | **String** | Search for a dominant instrument | [optional] |
|
54
|
-
| **energy** | **String** | Search for energy | [optional] |
|
55
|
-
| **engagement** | **String** | Search for an engagement | [optional] |
|
56
|
-
| **groovyness** | **String** | Search for groovyness | [optional] |
|
57
|
-
| **harmony** | **String** | Search for a degree of harmoniousness | [optional] |
|
58
|
-
| **pleasantness** | **String** | Search for pleasantness | [optional] |
|
59
|
-
| **primary_mood_cluster** | **String** | Search for a language of the lyrics | [optional] |
|
60
|
-
| **primary_sound_character** | **String** | Search for a sound character | [optional] |
|
61
|
-
| **rhythm** | **String** | Search for rhythm | [optional] |
|
62
|
-
| **roughness** | **String** | Search for roughness | [optional] |
|
63
|
-
| **scale** | **String** | Search for a tonal scale | [optional] |
|
64
|
-
| **sound_generation** | **String** | Search for type of sound generation | [optional] |
|
65
|
-
| **tempo** | **String** | Search for tempo | [optional] |
|
66
|
-
| **texture** | **String** | Search for texture | [optional] |
|
67
|
-
| **timbre** | **String** | Search for timbre | [optional] |
|
68
|
-
| **tonality** | **String** | Search for tonality | [optional] |
|
69
|
-
| **valence** | **String** | Search for a valence | [optional] |
|
70
75
|
| **audience_region** | **String** | | [optional] |
|
71
|
-
| **
|
72
|
-
| **
|
73
|
-
| **curateability** | **String** | Search for curatebility | [optional] |
|
74
|
-
| **use_case** | **String** | Search for use case | [optional] |
|
75
|
-
| **channel_suitability** | **String** | Search for social media suitability | [optional] |
|
76
|
-
| **key** | **String** | Search for a harmonic key | [optional] |
|
77
|
-
| **channel_suitability_affinity** | **Float** | | [optional] |
|
76
|
+
| **valence_affinity** | **Float** | | [optional] |
|
77
|
+
| **arousal_affinity** | **Float** | | [optional] |
|
78
78
|
| **pleasantness_affinity** | **Float** | | [optional] |
|
79
|
+
| **engagement_affinity** | **Float** | | [optional] |
|
80
|
+
| **energy_affinity** | **Float** | | [optional] |
|
79
81
|
| **tempo_affinity** | **Float** | | [optional] |
|
80
82
|
| **scale_affinity** | **Float** | | [optional] |
|
81
83
|
| **timbre_affinity** | **Float** | | [optional] |
|
82
|
-
| **
|
83
|
-
| **
|
84
|
+
| **roughness_affinity** | **Float** | | [optional] |
|
85
|
+
| **harmony_affinity** | **Float** | | [optional] |
|
84
86
|
| **texture_affinity** | **Float** | | [optional] |
|
85
87
|
| **groovyness_affinity** | **Float** | | [optional] |
|
86
|
-
| **valence_affinity** | **Float** | | [optional] |
|
87
|
-
| **arousal_affinity** | **Float** | | [optional] |
|
88
88
|
| **space_affinity** | **Float** | | [optional] |
|
89
89
|
| **key_affinity** | **Float** | | [optional] |
|
90
|
-
| **
|
91
|
-
| **
|
90
|
+
| **channel_suitability_affinity** | **Float** | | [optional] |
|
91
|
+
| **key** | **String** | Search for a harmonic key | [optional] |
|
92
92
|
|
93
93
|
## Example
|
94
94
|
|
@@ -97,7 +97,30 @@ require 'songtradr_api_client_ruby'
|
|
97
97
|
|
98
98
|
instance = SongtradrApiClientRuby::MusicalFeaturesDTO.new(
|
99
99
|
space: null,
|
100
|
+
arousal: null,
|
100
101
|
language_of_performance: null,
|
102
|
+
dominant_instrument: null,
|
103
|
+
energy: null,
|
104
|
+
engagement: null,
|
105
|
+
groovyness: null,
|
106
|
+
harmony: null,
|
107
|
+
pleasantness: null,
|
108
|
+
primary_mood_cluster: null,
|
109
|
+
primary_sound_character: null,
|
110
|
+
rhythm: null,
|
111
|
+
roughness: null,
|
112
|
+
scale: null,
|
113
|
+
sound_generation: null,
|
114
|
+
tempo: null,
|
115
|
+
texture: null,
|
116
|
+
timbre: null,
|
117
|
+
tonality: null,
|
118
|
+
valence: null,
|
119
|
+
vocals: null,
|
120
|
+
origin_decade: null,
|
121
|
+
curateability: null,
|
122
|
+
use_case: null,
|
123
|
+
channel_suitability: null,
|
101
124
|
primary_mood_cluster_affinity: null,
|
102
125
|
secondary_mood_cluster: null,
|
103
126
|
secondary_mood_cluster_affinity: null,
|
@@ -141,46 +164,23 @@ instance = SongtradrApiClientRuby::MusicalFeaturesDTO.new(
|
|
141
164
|
use_case_affinity: null,
|
142
165
|
industry_suitability: null,
|
143
166
|
industry_suitability_affinity: null,
|
144
|
-
arousal: null,
|
145
|
-
dominant_instrument: null,
|
146
|
-
energy: null,
|
147
|
-
engagement: null,
|
148
|
-
groovyness: null,
|
149
|
-
harmony: null,
|
150
|
-
pleasantness: null,
|
151
|
-
primary_mood_cluster: null,
|
152
|
-
primary_sound_character: null,
|
153
|
-
rhythm: null,
|
154
|
-
roughness: null,
|
155
|
-
scale: null,
|
156
|
-
sound_generation: null,
|
157
|
-
tempo: null,
|
158
|
-
texture: null,
|
159
|
-
timbre: null,
|
160
|
-
tonality: null,
|
161
|
-
valence: null,
|
162
167
|
audience_region: null,
|
163
|
-
|
164
|
-
|
165
|
-
curateability: null,
|
166
|
-
use_case: null,
|
167
|
-
channel_suitability: null,
|
168
|
-
key: null,
|
169
|
-
channel_suitability_affinity: null,
|
168
|
+
valence_affinity: null,
|
169
|
+
arousal_affinity: null,
|
170
170
|
pleasantness_affinity: null,
|
171
|
+
engagement_affinity: null,
|
172
|
+
energy_affinity: null,
|
171
173
|
tempo_affinity: null,
|
172
174
|
scale_affinity: null,
|
173
175
|
timbre_affinity: null,
|
174
|
-
|
175
|
-
|
176
|
+
roughness_affinity: null,
|
177
|
+
harmony_affinity: null,
|
176
178
|
texture_affinity: null,
|
177
179
|
groovyness_affinity: null,
|
178
|
-
valence_affinity: null,
|
179
|
-
arousal_affinity: null,
|
180
180
|
space_affinity: null,
|
181
181
|
key_affinity: null,
|
182
|
-
|
183
|
-
|
182
|
+
channel_suitability_affinity: null,
|
183
|
+
key: null
|
184
184
|
)
|
185
185
|
```
|
186
186
|
|
data/docs/PlaylistLargeDTO.md
CHANGED
@@ -7,7 +7,6 @@
|
|
7
7
|
| **name** | **String** | | |
|
8
8
|
| **state** | **String** | | [optional] |
|
9
9
|
| **usages** | [**Array<UsageDTO>**](UsageDTO.md) | | [optional] |
|
10
|
-
| **description** | **String** | | [optional] |
|
11
10
|
| **songtradr_playlist_guid** | **String** | | [optional] |
|
12
11
|
| **asset_url** | **String** | | [optional] |
|
13
12
|
| **pretzel_tier** | **String** | | [optional] |
|
@@ -15,6 +14,7 @@
|
|
15
14
|
| **tracks** | [**Array<RecordingPlaylistDTO>**](RecordingPlaylistDTO.md) | | [optional] |
|
16
15
|
| **created** | **Time** | | [optional] |
|
17
16
|
| **updated** | **Time** | | [optional] |
|
17
|
+
| **description** | **String** | | [optional] |
|
18
18
|
|
19
19
|
## Example
|
20
20
|
|
@@ -25,14 +25,14 @@ instance = SongtradrApiClientRuby::PlaylistLargeDTO.new(
|
|
25
25
|
name: null,
|
26
26
|
state: null,
|
27
27
|
usages: null,
|
28
|
-
description: null,
|
29
28
|
songtradr_playlist_guid: null,
|
30
29
|
asset_url: null,
|
31
30
|
pretzel_tier: null,
|
32
31
|
usage: null,
|
33
32
|
tracks: null,
|
34
33
|
created: null,
|
35
|
-
updated: null
|
34
|
+
updated: null,
|
35
|
+
description: null
|
36
36
|
)
|
37
37
|
```
|
38
38
|
|
data/docs/ProductMediumDTO.md
CHANGED
@@ -8,9 +8,9 @@
|
|
8
8
|
| **genres** | [**Array<GenreMinimalDTO>**](GenreMinimalDTO.md) | | [optional] |
|
9
9
|
| **titles** | [**Array<TitleDTO>**](TitleDTO.md) | | [optional] |
|
10
10
|
| **gtin** | **String** | | [optional] |
|
11
|
+
| **pline** | [**PLineDTO**](PLineDTO.md) | | [optional] |
|
11
12
|
| **grid** | **String** | | [optional] |
|
12
13
|
| **release_date** | **Time** | | [optional] |
|
13
|
-
| **pline** | [**PLineDTO**](PLineDTO.md) | | [optional] |
|
14
14
|
| **takedown_date** | **Time** | | [optional] |
|
15
15
|
| **parties** | [**Array<ProductPartyDTO>**](ProductPartyDTO.md) | | [optional] |
|
16
16
|
|
@@ -24,9 +24,9 @@ instance = SongtradrApiClientRuby::ProductMediumDTO.new(
|
|
24
24
|
genres: null,
|
25
25
|
titles: null,
|
26
26
|
gtin: null,
|
27
|
+
pline: null,
|
27
28
|
grid: null,
|
28
29
|
release_date: null,
|
29
|
-
pline: null,
|
30
30
|
takedown_date: null,
|
31
31
|
parties: null
|
32
32
|
)
|
data/docs/RecordingApi.md
CHANGED
@@ -566,6 +566,8 @@ opts = {
|
|
566
566
|
use_case: 'background', # String | Search for use case.
|
567
567
|
channel_suitability: 'Spotify', # String | Search for channel suitability.
|
568
568
|
songtradr_track_id: 'songtradr_track_id_example', # String | Search for Songtradr track id.
|
569
|
+
usage: 'usage_example', # String | Search for recording usage.
|
570
|
+
similar_to_songtradr_track_id: '1bF118m', # String | Search for songs similar to a recording by songtradr Track Id.
|
569
571
|
shuffled: 'true', # String | Sort the results randomly.
|
570
572
|
sort: 'popularityDesc', # String | Sort the results.
|
571
573
|
page: 56, # Integer | Zero-based page index (0..N)
|
@@ -637,6 +639,8 @@ end
|
|
637
639
|
| **use_case** | **String** | Search for use case. | [optional] |
|
638
640
|
| **channel_suitability** | **String** | Search for channel suitability. | [optional] |
|
639
641
|
| **songtradr_track_id** | **String** | Search for Songtradr track id. | [optional] |
|
642
|
+
| **usage** | **String** | Search for recording usage. | [optional] |
|
643
|
+
| **similar_to_songtradr_track_id** | **String** | Search for songs similar to a recording by songtradr Track Id. | [optional] |
|
640
644
|
| **shuffled** | **String** | Sort the results randomly. | [optional][default to 'false'] |
|
641
645
|
| **sort** | **String** | Sort the results. | [optional][default to 'popularityDesc'] |
|
642
646
|
| **page** | **Integer** | Zero-based page index (0..N) | [optional][default to 0] |
|
@@ -4,8 +4,8 @@
|
|
4
4
|
|
5
5
|
| Name | Type | Description | Notes |
|
6
6
|
| ---- | ---- | ----------- | ----- |
|
7
|
-
| **genre_type** | **String** | | |
|
8
7
|
| **probability** | **Float** | | |
|
8
|
+
| **genre_type** | **String** | | |
|
9
9
|
| **genre** | [**GenreMinimalDTO**](GenreMinimalDTO.md) | | |
|
10
10
|
|
11
11
|
## Example
|
@@ -14,8 +14,8 @@
|
|
14
14
|
require 'songtradr_api_client_ruby'
|
15
15
|
|
16
16
|
instance = SongtradrApiClientRuby::RecordingGenrePredictionDTO.new(
|
17
|
-
genre_type: null,
|
18
17
|
probability: null,
|
18
|
+
genre_type: null,
|
19
19
|
genre: null
|
20
20
|
)
|
21
21
|
```
|
data/docs/RecordingMediumDTO.md
CHANGED
@@ -10,6 +10,7 @@
|
|
10
10
|
| **language_of_performance** | **String** | | [optional] |
|
11
11
|
| **release_date** | **Time** | | [optional] |
|
12
12
|
| **titles** | [**Array<TitleDTO>**](TitleDTO.md) | | [optional] |
|
13
|
+
| **tracks** | [**Array<TrackDTO>**](TrackDTO.md) | | [optional] |
|
13
14
|
| **musical_features** | [**MusicalFeaturesDTO**](MusicalFeaturesDTO.md) | | [optional] |
|
14
15
|
| **tags** | [**Array<RecordingTagSmallDTO>**](RecordingTagSmallDTO.md) | | [optional] |
|
15
16
|
| **spotify_id** | **String** | | [optional] |
|
@@ -27,6 +28,7 @@ instance = SongtradrApiClientRuby::RecordingMediumDTO.new(
|
|
27
28
|
language_of_performance: null,
|
28
29
|
release_date: null,
|
29
30
|
titles: null,
|
31
|
+
tracks: null,
|
30
32
|
musical_features: null,
|
31
33
|
tags: null,
|
32
34
|
spotify_id: null,
|
data/docs/TrackDTO.md
ADDED
@@ -0,0 +1,18 @@
|
|
1
|
+
# SongtradrApiClientRuby::TrackDTO
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **songtradr_track_id** | **String** | | [optional] |
|
8
|
+
|
9
|
+
## Example
|
10
|
+
|
11
|
+
```ruby
|
12
|
+
require 'songtradr_api_client_ruby'
|
13
|
+
|
14
|
+
instance = SongtradrApiClientRuby::TrackDTO.new(
|
15
|
+
songtradr_track_id: null
|
16
|
+
)
|
17
|
+
```
|
18
|
+
|
@@ -4,9 +4,9 @@
|
|
4
4
|
|
5
5
|
| Name | Type | Description | Notes |
|
6
6
|
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **product** | [**ProductMediumDTO**](ProductMediumDTO.md) | | |
|
7
8
|
| **track_no** | **String** | | |
|
8
9
|
| **set_no** | **String** | | [optional] |
|
9
|
-
| **product** | [**ProductMediumDTO**](ProductMediumDTO.md) | | |
|
10
10
|
|
11
11
|
## Example
|
12
12
|
|
@@ -14,9 +14,9 @@
|
|
14
14
|
require 'songtradr_api_client_ruby'
|
15
15
|
|
16
16
|
instance = SongtradrApiClientRuby::TrackToMediumProductDTO.new(
|
17
|
+
product: null,
|
17
18
|
track_no: null,
|
18
|
-
set_no: null
|
19
|
-
product: null
|
19
|
+
set_no: null
|
20
20
|
)
|
21
21
|
```
|
22
22
|
|
data/getspec.rb
CHANGED
@@ -1,33 +1,52 @@
|
|
1
1
|
#!/usr/bin/env ruby
|
2
|
+
# frozen_string_literal: true
|
2
3
|
|
3
|
-
require
|
4
|
+
require 'json'
|
4
5
|
require 'net/http'
|
5
6
|
|
6
|
-
MAX_RETRIES =
|
7
|
-
DELAY_SECONDS =
|
7
|
+
MAX_RETRIES = 10
|
8
|
+
DELAY_SECONDS = 3
|
8
9
|
|
9
|
-
def fetch_gem_version(version)
|
10
|
-
|
10
|
+
def fetch_gem_version(version, retries = 0)
|
11
|
+
until retries > MAX_RETRIES
|
12
|
+
response = Net::HTTP.get_response(URI("https://rubygems.org/gems/songtradr_api_client_ruby/versions/#{version}"))
|
13
|
+
return response.code if response.code == '200' || response.code == '404'
|
14
|
+
|
15
|
+
retries += 1
|
16
|
+
sleep(DELAY_SECONDS)
|
17
|
+
end
|
18
|
+
puts 'Failed to fetch gem version'
|
19
|
+
# return the last response code. This will not be 200 or 404 if we've retried too many times and will be an error code
|
20
|
+
# This is fine.
|
11
21
|
response.code
|
12
22
|
end
|
13
23
|
|
14
|
-
def
|
15
|
-
retries
|
16
|
-
api_response = Net::HTTP.get_response(URI(ENV['SONGTRADR_API']))
|
17
|
-
|
18
|
-
until api_response.code == "200" || retries >= MAX_RETRIES
|
19
|
-
sleep(DELAY_SECONDS)
|
24
|
+
def fetch_api(retries = 0)
|
25
|
+
until retries > MAX_RETRIES
|
20
26
|
api_response = Net::HTTP.get_response(URI(ENV['SONGTRADR_API']))
|
27
|
+
return api_response if api_response.code == '200'
|
28
|
+
|
21
29
|
retries += 1
|
30
|
+
sleep(DELAY_SECONDS)
|
22
31
|
end
|
32
|
+
puts 'Failed to fetch API'
|
33
|
+
# return the last response. This will not be 200 if we've retried too many times and will be an error code.
|
34
|
+
# This is fine.
|
35
|
+
api_response
|
36
|
+
end
|
37
|
+
|
38
|
+
def fetch_api_version
|
39
|
+
api_response = fetch_api
|
40
|
+
|
41
|
+
return '0.0.0' if api_response.code != '200'
|
23
42
|
|
24
43
|
begin
|
25
44
|
json = JSON.parse(api_response.body)
|
26
|
-
version = json[
|
27
|
-
rescue
|
28
|
-
version =
|
45
|
+
version = json['info']['version']
|
46
|
+
rescue StandardError
|
47
|
+
version = '0.0.0'
|
29
48
|
end
|
30
|
-
fetch_gem_version(version) ==
|
49
|
+
fetch_gem_version(version) == '404' ? version : '0.0.0'
|
31
50
|
end
|
32
51
|
|
33
52
|
puts fetch_api_version
|
@@ -3,10 +3,10 @@
|
|
3
3
|
|
4
4
|
#This is the Songtradr API. Use it to retrieve deep music metadata and trigger processes like auto-tagging. You can also use the API to manage your account and musicube cloud data. **Authentication** 1. Reach out to support@songtradr.com to receive a free account or use your login data if you are already signed up. 2. To authenticate, you need to login via the POST /api/v1/user/login endpoint. 3. The endpoint responds with a jwtToken which you can use in all following API requests as a bearer token. **Rate Limiting** The current limit is 120 Requests per minute. Reach out to us via support@songtradr.com if you need to request more. **Getting Started with auto-tagging** 1. If you want to get your own files auto-tagged, use the POST /api/v1/user/file/{name}/initUpload endpoint. It responds with a presigned S3 link where you can upload your file. 2. You can check the processing status of your file via the GET /api/v1/user/file/{name}/filesStatus endpoint. 3. As soon as processing is done, you can request the generated data via the GET /api/v1/user/files endpoint. **Getting Started with search** You can either search the released music via the /public/recording endpoints or your own private uploaded music via the /user/file/ endpoints. 1. If you want to search the world's released music, a good starting point is the GET /api/v1/public/recording/search endpoint. Please find the extensive list of parameters that serve as semantic search filters. 2. If you want to search your own previously uploaded music, a good starting point is the GET GET /api/v1/user/files endpoint. It has the same extensive list of parameters that serve as semantic search filters.
|
5
5
|
|
6
|
-
The version of the OpenAPI document: 1.
|
6
|
+
The version of the OpenAPI document: 1.13.1
|
7
7
|
Contact: info@songtradr.com
|
8
8
|
Generated by: https://openapi-generator.tech
|
9
|
-
OpenAPI Generator version: 7.0.
|
9
|
+
OpenAPI Generator version: 7.0.1-SNAPSHOT
|
10
10
|
|
11
11
|
=end
|
12
12
|
|
@@ -3,10 +3,10 @@
|
|
3
3
|
|
4
4
|
#This is the Songtradr API. Use it to retrieve deep music metadata and trigger processes like auto-tagging. You can also use the API to manage your account and musicube cloud data. **Authentication** 1. Reach out to support@songtradr.com to receive a free account or use your login data if you are already signed up. 2. To authenticate, you need to login via the POST /api/v1/user/login endpoint. 3. The endpoint responds with a jwtToken which you can use in all following API requests as a bearer token. **Rate Limiting** The current limit is 120 Requests per minute. Reach out to us via support@songtradr.com if you need to request more. **Getting Started with auto-tagging** 1. If you want to get your own files auto-tagged, use the POST /api/v1/user/file/{name}/initUpload endpoint. It responds with a presigned S3 link where you can upload your file. 2. You can check the processing status of your file via the GET /api/v1/user/file/{name}/filesStatus endpoint. 3. As soon as processing is done, you can request the generated data via the GET /api/v1/user/files endpoint. **Getting Started with search** You can either search the released music via the /public/recording endpoints or your own private uploaded music via the /user/file/ endpoints. 1. If you want to search the world's released music, a good starting point is the GET /api/v1/public/recording/search endpoint. Please find the extensive list of parameters that serve as semantic search filters. 2. If you want to search your own previously uploaded music, a good starting point is the GET GET /api/v1/user/files endpoint. It has the same extensive list of parameters that serve as semantic search filters.
|
5
5
|
|
6
|
-
The version of the OpenAPI document: 1.
|
6
|
+
The version of the OpenAPI document: 1.13.1
|
7
7
|
Contact: info@songtradr.com
|
8
8
|
Generated by: https://openapi-generator.tech
|
9
|
-
OpenAPI Generator version: 7.0.
|
9
|
+
OpenAPI Generator version: 7.0.1-SNAPSHOT
|
10
10
|
|
11
11
|
=end
|
12
12
|
|
@@ -3,10 +3,10 @@
|
|
3
3
|
|
4
4
|
#This is the Songtradr API. Use it to retrieve deep music metadata and trigger processes like auto-tagging. You can also use the API to manage your account and musicube cloud data. **Authentication** 1. Reach out to support@songtradr.com to receive a free account or use your login data if you are already signed up. 2. To authenticate, you need to login via the POST /api/v1/user/login endpoint. 3. The endpoint responds with a jwtToken which you can use in all following API requests as a bearer token. **Rate Limiting** The current limit is 120 Requests per minute. Reach out to us via support@songtradr.com if you need to request more. **Getting Started with auto-tagging** 1. If you want to get your own files auto-tagged, use the POST /api/v1/user/file/{name}/initUpload endpoint. It responds with a presigned S3 link where you can upload your file. 2. You can check the processing status of your file via the GET /api/v1/user/file/{name}/filesStatus endpoint. 3. As soon as processing is done, you can request the generated data via the GET /api/v1/user/files endpoint. **Getting Started with search** You can either search the released music via the /public/recording endpoints or your own private uploaded music via the /user/file/ endpoints. 1. If you want to search the world's released music, a good starting point is the GET /api/v1/public/recording/search endpoint. Please find the extensive list of parameters that serve as semantic search filters. 2. If you want to search your own previously uploaded music, a good starting point is the GET GET /api/v1/user/files endpoint. It has the same extensive list of parameters that serve as semantic search filters.
|
5
5
|
|
6
|
-
The version of the OpenAPI document: 1.
|
6
|
+
The version of the OpenAPI document: 1.13.1
|
7
7
|
Contact: info@songtradr.com
|
8
8
|
Generated by: https://openapi-generator.tech
|
9
|
-
OpenAPI Generator version: 7.0.
|
9
|
+
OpenAPI Generator version: 7.0.1-SNAPSHOT
|
10
10
|
|
11
11
|
=end
|
12
12
|
|
@@ -3,10 +3,10 @@
|
|
3
3
|
|
4
4
|
#This is the Songtradr API. Use it to retrieve deep music metadata and trigger processes like auto-tagging. You can also use the API to manage your account and musicube cloud data. **Authentication** 1. Reach out to support@songtradr.com to receive a free account or use your login data if you are already signed up. 2. To authenticate, you need to login via the POST /api/v1/user/login endpoint. 3. The endpoint responds with a jwtToken which you can use in all following API requests as a bearer token. **Rate Limiting** The current limit is 120 Requests per minute. Reach out to us via support@songtradr.com if you need to request more. **Getting Started with auto-tagging** 1. If you want to get your own files auto-tagged, use the POST /api/v1/user/file/{name}/initUpload endpoint. It responds with a presigned S3 link where you can upload your file. 2. You can check the processing status of your file via the GET /api/v1/user/file/{name}/filesStatus endpoint. 3. As soon as processing is done, you can request the generated data via the GET /api/v1/user/files endpoint. **Getting Started with search** You can either search the released music via the /public/recording endpoints or your own private uploaded music via the /user/file/ endpoints. 1. If you want to search the world's released music, a good starting point is the GET /api/v1/public/recording/search endpoint. Please find the extensive list of parameters that serve as semantic search filters. 2. If you want to search your own previously uploaded music, a good starting point is the GET GET /api/v1/user/files endpoint. It has the same extensive list of parameters that serve as semantic search filters.
|
5
5
|
|
6
|
-
The version of the OpenAPI document: 1.
|
6
|
+
The version of the OpenAPI document: 1.13.1
|
7
7
|
Contact: info@songtradr.com
|
8
8
|
Generated by: https://openapi-generator.tech
|
9
|
-
OpenAPI Generator version: 7.0.
|
9
|
+
OpenAPI Generator version: 7.0.1-SNAPSHOT
|
10
10
|
|
11
11
|
=end
|
12
12
|
|