songtradr_api_client_ruby 2.0.0 → 2.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/Gemfile.lock +3 -3
- data/README.md +14 -9
- data/docs/FileSmallDTO.md +5 -5
- data/docs/MusicalFeaturesDTO.md +14 -14
- data/docs/RecordingApi.md +36 -36
- data/docs/RecordingMediumDTO.md +2 -2
- data/docs/RecordingSmallDTO.md +3 -3
- data/docs/UserApi.md +308 -0
- data/lib/songtradr_api_client_ruby/api/allowed_values_api.rb +2 -2
- data/lib/songtradr_api_client_ruby/api/recording_api.rb +30 -30
- data/lib/songtradr_api_client_ruby/api/user_api.rb +296 -2
- data/lib/songtradr_api_client_ruby/api_client.rb +4 -5
- data/lib/songtradr_api_client_ruby/api_error.rb +2 -2
- data/lib/songtradr_api_client_ruby/configuration.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/category_medium_dto.rb +2 -2
- 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/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_small_dto.rb +44 -44
- 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/image_recognition_response.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 +76 -76
- data/lib/songtradr_api_client_ruby/models/party_small_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 +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 +24 -24
- 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_small_dto.rb +27 -27
- data/lib/songtradr_api_client_ruby/models/recording_tag_small_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/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 +2 -2
- data/lib/songtradr_api_client_ruby/models/update_password_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/user_dto.rb +2 -2
- data/lib/songtradr_api_client_ruby/models/video_recognition_response.rb +2 -2
- data/lib/songtradr_api_client_ruby/version.rb +3 -3
- data/lib/songtradr_api_client_ruby.rb +2 -2
- data/openapi-generator-config.yaml +1 -1
- data/songtradr_api_client_ruby.gemspec +3 -3
- data/spec/api/allowed_values_api_spec.rb +2 -2
- data/spec/api/recording_api_spec.rb +10 -10
- data/spec/api/user_api_spec.rb +60 -2
- data/spec/models/category_medium_dto_spec.rb +2 -2
- 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/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_small_dto_spec.rb +18 -18
- 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/image_recognition_response_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 +32 -32
- data/spec/models/party_small_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 +2 -2
- data/spec/models/recording_list_dto_spec.rb +2 -2
- data/spec/models/recording_medium_dto_spec.rb +8 -8
- 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_small_dto_spec.rb +5 -5
- data/spec/models/recording_tag_small_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/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 +2 -2
- data/spec/models/update_password_dto_spec.rb +2 -2
- data/spec/models/user_dto_spec.rb +2 -2
- data/spec/models/video_recognition_response_spec.rb +2 -2
- data/spec/spec_helper.rb +2 -2
- metadata +42 -42
|
@@ -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: 2.
|
|
6
|
+
The version of the OpenAPI document: 2.1.0
|
|
7
7
|
Contact: info@songtradr.com
|
|
8
8
|
Generated by: https://openapi-generator.tech
|
|
9
|
-
|
|
9
|
+
Generator version: 7.5.0-SNAPSHOT
|
|
10
10
|
|
|
11
11
|
=end
|
|
12
12
|
|
|
@@ -781,6 +781,300 @@ module SongtradrApiClientRuby
|
|
|
781
781
|
return data, status_code, headers
|
|
782
782
|
end
|
|
783
783
|
|
|
784
|
+
# Similar recordings for a list of user recordings.
|
|
785
|
+
# @param ids [String] Comma seperated list of IDs. Can be ISRCs or proprietary IDs
|
|
786
|
+
# @param [Hash] opts the optional parameters
|
|
787
|
+
# @option opts [Boolean] :identical_only Whether a result list shall include only identical recordings. (default to false)
|
|
788
|
+
# @option opts [String] :usage Filter by recording usage.
|
|
789
|
+
# @return [Array<RecordingForSimilaritySearchDTO>]
|
|
790
|
+
def recordings_by_ids_with_similarities(ids, opts = {})
|
|
791
|
+
data, _status_code, _headers = recordings_by_ids_with_similarities_with_http_info(ids, opts)
|
|
792
|
+
data
|
|
793
|
+
end
|
|
794
|
+
|
|
795
|
+
# Similar recordings for a list of user recordings.
|
|
796
|
+
# @param ids [String] Comma seperated list of IDs. Can be ISRCs or proprietary IDs
|
|
797
|
+
# @param [Hash] opts the optional parameters
|
|
798
|
+
# @option opts [Boolean] :identical_only Whether a result list shall include only identical recordings. (default to false)
|
|
799
|
+
# @option opts [String] :usage Filter by recording usage.
|
|
800
|
+
# @return [Array<(Array<RecordingForSimilaritySearchDTO>, Integer, Hash)>] Array<RecordingForSimilaritySearchDTO> data, response status code and response headers
|
|
801
|
+
def recordings_by_ids_with_similarities_with_http_info(ids, opts = {})
|
|
802
|
+
if @api_client.config.debugging
|
|
803
|
+
@api_client.config.logger.debug 'Calling API: UserApi.recordings_by_ids_with_similarities ...'
|
|
804
|
+
end
|
|
805
|
+
# verify the required parameter 'ids' is set
|
|
806
|
+
if @api_client.config.client_side_validation && ids.nil?
|
|
807
|
+
fail ArgumentError, "Missing the required parameter 'ids' when calling UserApi.recordings_by_ids_with_similarities"
|
|
808
|
+
end
|
|
809
|
+
# resource path
|
|
810
|
+
local_var_path = '/api/v1/user/recording/{ids}/similarities'.sub('{' + 'ids' + '}', CGI.escape(ids.to_s))
|
|
811
|
+
|
|
812
|
+
# query parameters
|
|
813
|
+
query_params = opts[:query_params] || {}
|
|
814
|
+
query_params[:'identicalOnly'] = opts[:'identical_only'] if !opts[:'identical_only'].nil?
|
|
815
|
+
query_params[:'usage'] = opts[:'usage'] if !opts[:'usage'].nil?
|
|
816
|
+
|
|
817
|
+
# header parameters
|
|
818
|
+
header_params = opts[:header_params] || {}
|
|
819
|
+
# HTTP header 'Accept' (if needed)
|
|
820
|
+
header_params['Accept'] = @api_client.select_header_accept(['application/json'])
|
|
821
|
+
|
|
822
|
+
# form parameters
|
|
823
|
+
form_params = opts[:form_params] || {}
|
|
824
|
+
|
|
825
|
+
# http body (model)
|
|
826
|
+
post_body = opts[:debug_body]
|
|
827
|
+
|
|
828
|
+
# return_type
|
|
829
|
+
return_type = opts[:debug_return_type] || 'Array<RecordingForSimilaritySearchDTO>'
|
|
830
|
+
|
|
831
|
+
# auth_names
|
|
832
|
+
auth_names = opts[:debug_auth_names] || ['bearer-jwt']
|
|
833
|
+
|
|
834
|
+
new_options = opts.merge(
|
|
835
|
+
:operation => :"UserApi.recordings_by_ids_with_similarities",
|
|
836
|
+
:header_params => header_params,
|
|
837
|
+
:query_params => query_params,
|
|
838
|
+
:form_params => form_params,
|
|
839
|
+
:body => post_body,
|
|
840
|
+
:auth_names => auth_names,
|
|
841
|
+
:return_type => return_type
|
|
842
|
+
)
|
|
843
|
+
|
|
844
|
+
data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
|
|
845
|
+
if @api_client.config.debugging
|
|
846
|
+
@api_client.config.logger.debug "API called: UserApi#recordings_by_ids_with_similarities\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
|
|
847
|
+
end
|
|
848
|
+
return data, status_code, headers
|
|
849
|
+
end
|
|
850
|
+
|
|
851
|
+
# Timeseries of AI generated moods, musical features and more for a list of recordings.
|
|
852
|
+
# @param ids [String] Comma seperated list of IDs. Can be ISRCs or proprietary IDs
|
|
853
|
+
# @param [Hash] opts the optional parameters
|
|
854
|
+
# @option opts [String] :category_name Show only taggrams for one category.
|
|
855
|
+
# @option opts [String] :tag_name Show only taggrams for one tag.
|
|
856
|
+
# @option opts [String] :genre_name Show only taggrams for one genre.
|
|
857
|
+
# @option opts [Float] :from_timestamp Show only taggrams data starting from from this timestamp in seconds.
|
|
858
|
+
# @option opts [Float] :to_timestamp Show only taggrams data before this timestamp in seconds.
|
|
859
|
+
# @option opts [Boolean] :fill_with_zero If set to true, empty timeseries are filled with timeseries of 0.0 values.
|
|
860
|
+
# @return [Array<RecordingMinimalWithTaggramsDTO>]
|
|
861
|
+
def recordings_by_ids_with_taggrams(ids, opts = {})
|
|
862
|
+
data, _status_code, _headers = recordings_by_ids_with_taggrams_with_http_info(ids, opts)
|
|
863
|
+
data
|
|
864
|
+
end
|
|
865
|
+
|
|
866
|
+
# Timeseries of AI generated moods, musical features and more for a list of recordings.
|
|
867
|
+
# @param ids [String] Comma seperated list of IDs. Can be ISRCs or proprietary IDs
|
|
868
|
+
# @param [Hash] opts the optional parameters
|
|
869
|
+
# @option opts [String] :category_name Show only taggrams for one category.
|
|
870
|
+
# @option opts [String] :tag_name Show only taggrams for one tag.
|
|
871
|
+
# @option opts [String] :genre_name Show only taggrams for one genre.
|
|
872
|
+
# @option opts [Float] :from_timestamp Show only taggrams data starting from from this timestamp in seconds.
|
|
873
|
+
# @option opts [Float] :to_timestamp Show only taggrams data before this timestamp in seconds.
|
|
874
|
+
# @option opts [Boolean] :fill_with_zero If set to true, empty timeseries are filled with timeseries of 0.0 values.
|
|
875
|
+
# @return [Array<(Array<RecordingMinimalWithTaggramsDTO>, Integer, Hash)>] Array<RecordingMinimalWithTaggramsDTO> data, response status code and response headers
|
|
876
|
+
def recordings_by_ids_with_taggrams_with_http_info(ids, opts = {})
|
|
877
|
+
if @api_client.config.debugging
|
|
878
|
+
@api_client.config.logger.debug 'Calling API: UserApi.recordings_by_ids_with_taggrams ...'
|
|
879
|
+
end
|
|
880
|
+
# verify the required parameter 'ids' is set
|
|
881
|
+
if @api_client.config.client_side_validation && ids.nil?
|
|
882
|
+
fail ArgumentError, "Missing the required parameter 'ids' when calling UserApi.recordings_by_ids_with_taggrams"
|
|
883
|
+
end
|
|
884
|
+
allowable_values = ["instrument", "vocals", "energy", "soundGeneration", "rhythm", "songRating", "performanceRating", "productionRating", "moodCluster", "tonality", "arousal", "valence", "pleasantness", "engagement", "timbre", "roughness", "harmony", "texture", "groovyness", "space", "audienceAge", "audienceRegion", "audienceGender", "originRegion", "originDecade", "languageOfPerformance", "level1Genre", "level2Genre", "curateability", "useCase", "channelSuitability", "industrySuitability", "loudness"]
|
|
885
|
+
if @api_client.config.client_side_validation && opts[:'category_name'] && !allowable_values.include?(opts[:'category_name'])
|
|
886
|
+
fail ArgumentError, "invalid value for \"category_name\", must be one of #{allowable_values}"
|
|
887
|
+
end
|
|
888
|
+
# resource path
|
|
889
|
+
local_var_path = '/api/v1/user/recording/{ids}/taggrams'.sub('{' + 'ids' + '}', CGI.escape(ids.to_s))
|
|
890
|
+
|
|
891
|
+
# query parameters
|
|
892
|
+
query_params = opts[:query_params] || {}
|
|
893
|
+
query_params[:'categoryName'] = opts[:'category_name'] if !opts[:'category_name'].nil?
|
|
894
|
+
query_params[:'tagName'] = opts[:'tag_name'] if !opts[:'tag_name'].nil?
|
|
895
|
+
query_params[:'genreName'] = opts[:'genre_name'] if !opts[:'genre_name'].nil?
|
|
896
|
+
query_params[:'fromTimestamp'] = opts[:'from_timestamp'] if !opts[:'from_timestamp'].nil?
|
|
897
|
+
query_params[:'toTimestamp'] = opts[:'to_timestamp'] if !opts[:'to_timestamp'].nil?
|
|
898
|
+
query_params[:'fillWithZero'] = opts[:'fill_with_zero'] if !opts[:'fill_with_zero'].nil?
|
|
899
|
+
|
|
900
|
+
# header parameters
|
|
901
|
+
header_params = opts[:header_params] || {}
|
|
902
|
+
# HTTP header 'Accept' (if needed)
|
|
903
|
+
header_params['Accept'] = @api_client.select_header_accept(['application/json'])
|
|
904
|
+
|
|
905
|
+
# form parameters
|
|
906
|
+
form_params = opts[:form_params] || {}
|
|
907
|
+
|
|
908
|
+
# http body (model)
|
|
909
|
+
post_body = opts[:debug_body]
|
|
910
|
+
|
|
911
|
+
# return_type
|
|
912
|
+
return_type = opts[:debug_return_type] || 'Array<RecordingMinimalWithTaggramsDTO>'
|
|
913
|
+
|
|
914
|
+
# auth_names
|
|
915
|
+
auth_names = opts[:debug_auth_names] || ['bearer-jwt']
|
|
916
|
+
|
|
917
|
+
new_options = opts.merge(
|
|
918
|
+
:operation => :"UserApi.recordings_by_ids_with_taggrams",
|
|
919
|
+
:header_params => header_params,
|
|
920
|
+
:query_params => query_params,
|
|
921
|
+
:form_params => form_params,
|
|
922
|
+
:body => post_body,
|
|
923
|
+
:auth_names => auth_names,
|
|
924
|
+
:return_type => return_type
|
|
925
|
+
)
|
|
926
|
+
|
|
927
|
+
data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
|
|
928
|
+
if @api_client.config.debugging
|
|
929
|
+
@api_client.config.logger.debug "API called: UserApi#recordings_by_ids_with_taggrams\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
|
|
930
|
+
end
|
|
931
|
+
return data, status_code, headers
|
|
932
|
+
end
|
|
933
|
+
|
|
934
|
+
# Strengths as numerical representations for AI generated moods, musical features and more for recordings.
|
|
935
|
+
# @param ids [String] Comma seperated list of IDs. Can be ISRCs or proprietary IDs
|
|
936
|
+
# @param [Hash] opts the optional parameters
|
|
937
|
+
# @option opts [String] :category_name Show only taggrams for one category.
|
|
938
|
+
# @option opts [String] :tag_name Show only taggrams for one tag.
|
|
939
|
+
# @option opts [String] :genre_name Show only taggrams for one genre.
|
|
940
|
+
# @return [Array<RecordingMinimalWithTagstrengthsDTO>]
|
|
941
|
+
def recordings_by_ids_with_tagstrengths(ids, opts = {})
|
|
942
|
+
data, _status_code, _headers = recordings_by_ids_with_tagstrengths_with_http_info(ids, opts)
|
|
943
|
+
data
|
|
944
|
+
end
|
|
945
|
+
|
|
946
|
+
# Strengths as numerical representations for AI generated moods, musical features and more for recordings.
|
|
947
|
+
# @param ids [String] Comma seperated list of IDs. Can be ISRCs or proprietary IDs
|
|
948
|
+
# @param [Hash] opts the optional parameters
|
|
949
|
+
# @option opts [String] :category_name Show only taggrams for one category.
|
|
950
|
+
# @option opts [String] :tag_name Show only taggrams for one tag.
|
|
951
|
+
# @option opts [String] :genre_name Show only taggrams for one genre.
|
|
952
|
+
# @return [Array<(Array<RecordingMinimalWithTagstrengthsDTO>, Integer, Hash)>] Array<RecordingMinimalWithTagstrengthsDTO> data, response status code and response headers
|
|
953
|
+
def recordings_by_ids_with_tagstrengths_with_http_info(ids, opts = {})
|
|
954
|
+
if @api_client.config.debugging
|
|
955
|
+
@api_client.config.logger.debug 'Calling API: UserApi.recordings_by_ids_with_tagstrengths ...'
|
|
956
|
+
end
|
|
957
|
+
# verify the required parameter 'ids' is set
|
|
958
|
+
if @api_client.config.client_side_validation && ids.nil?
|
|
959
|
+
fail ArgumentError, "Missing the required parameter 'ids' when calling UserApi.recordings_by_ids_with_tagstrengths"
|
|
960
|
+
end
|
|
961
|
+
allowable_values = ["instrument", "vocals", "energy", "soundGeneration", "rhythm", "songRating", "performanceRating", "productionRating", "moodCluster", "tonality", "arousal", "valence", "pleasantness", "engagement", "timbre", "roughness", "harmony", "texture", "groovyness", "space", "audienceAge", "audienceRegion", "audienceGender", "originRegion", "originDecade", "languageOfPerformance", "level1Genre", "level2Genre", "curateability", "useCase", "channelSuitability", "industrySuitability", "loudness"]
|
|
962
|
+
if @api_client.config.client_side_validation && opts[:'category_name'] && !allowable_values.include?(opts[:'category_name'])
|
|
963
|
+
fail ArgumentError, "invalid value for \"category_name\", must be one of #{allowable_values}"
|
|
964
|
+
end
|
|
965
|
+
# resource path
|
|
966
|
+
local_var_path = '/api/v1/user/recording/{ids}/tagstrengths'.sub('{' + 'ids' + '}', CGI.escape(ids.to_s))
|
|
967
|
+
|
|
968
|
+
# query parameters
|
|
969
|
+
query_params = opts[:query_params] || {}
|
|
970
|
+
query_params[:'categoryName'] = opts[:'category_name'] if !opts[:'category_name'].nil?
|
|
971
|
+
query_params[:'tagName'] = opts[:'tag_name'] if !opts[:'tag_name'].nil?
|
|
972
|
+
query_params[:'genreName'] = opts[:'genre_name'] if !opts[:'genre_name'].nil?
|
|
973
|
+
|
|
974
|
+
# header parameters
|
|
975
|
+
header_params = opts[:header_params] || {}
|
|
976
|
+
# HTTP header 'Accept' (if needed)
|
|
977
|
+
header_params['Accept'] = @api_client.select_header_accept(['application/json'])
|
|
978
|
+
|
|
979
|
+
# form parameters
|
|
980
|
+
form_params = opts[:form_params] || {}
|
|
981
|
+
|
|
982
|
+
# http body (model)
|
|
983
|
+
post_body = opts[:debug_body]
|
|
984
|
+
|
|
985
|
+
# return_type
|
|
986
|
+
return_type = opts[:debug_return_type] || 'Array<RecordingMinimalWithTagstrengthsDTO>'
|
|
987
|
+
|
|
988
|
+
# auth_names
|
|
989
|
+
auth_names = opts[:debug_auth_names] || ['bearer-jwt']
|
|
990
|
+
|
|
991
|
+
new_options = opts.merge(
|
|
992
|
+
:operation => :"UserApi.recordings_by_ids_with_tagstrengths",
|
|
993
|
+
:header_params => header_params,
|
|
994
|
+
:query_params => query_params,
|
|
995
|
+
:form_params => form_params,
|
|
996
|
+
:body => post_body,
|
|
997
|
+
:auth_names => auth_names,
|
|
998
|
+
:return_type => return_type
|
|
999
|
+
)
|
|
1000
|
+
|
|
1001
|
+
data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
|
|
1002
|
+
if @api_client.config.debugging
|
|
1003
|
+
@api_client.config.logger.debug "API called: UserApi#recordings_by_ids_with_tagstrengths\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
|
|
1004
|
+
end
|
|
1005
|
+
return data, status_code, headers
|
|
1006
|
+
end
|
|
1007
|
+
|
|
1008
|
+
# Recordings by IDs with a medium sized response.
|
|
1009
|
+
# @param ids [String] Comma seperated list of IDs. Can be ISRCs or proprietary IDs
|
|
1010
|
+
# @param [Hash] opts the optional parameters
|
|
1011
|
+
# @option opts [Integer] :page Zero-based page index (0..N) (default to 0)
|
|
1012
|
+
# @option opts [Integer] :size The size of the page to be returned (default to 20)
|
|
1013
|
+
# @option opts [Array<String>] :sort Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.
|
|
1014
|
+
# @return [Array<RecordingMediumDTO>]
|
|
1015
|
+
def recordings_medium_by_ids(ids, opts = {})
|
|
1016
|
+
data, _status_code, _headers = recordings_medium_by_ids_with_http_info(ids, opts)
|
|
1017
|
+
data
|
|
1018
|
+
end
|
|
1019
|
+
|
|
1020
|
+
# Recordings by IDs with a medium sized response.
|
|
1021
|
+
# @param ids [String] Comma seperated list of IDs. Can be ISRCs or proprietary IDs
|
|
1022
|
+
# @param [Hash] opts the optional parameters
|
|
1023
|
+
# @option opts [Integer] :page Zero-based page index (0..N) (default to 0)
|
|
1024
|
+
# @option opts [Integer] :size The size of the page to be returned (default to 20)
|
|
1025
|
+
# @option opts [Array<String>] :sort Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.
|
|
1026
|
+
# @return [Array<(Array<RecordingMediumDTO>, Integer, Hash)>] Array<RecordingMediumDTO> data, response status code and response headers
|
|
1027
|
+
def recordings_medium_by_ids_with_http_info(ids, opts = {})
|
|
1028
|
+
if @api_client.config.debugging
|
|
1029
|
+
@api_client.config.logger.debug 'Calling API: UserApi.recordings_medium_by_ids ...'
|
|
1030
|
+
end
|
|
1031
|
+
# verify the required parameter 'ids' is set
|
|
1032
|
+
if @api_client.config.client_side_validation && ids.nil?
|
|
1033
|
+
fail ArgumentError, "Missing the required parameter 'ids' when calling UserApi.recordings_medium_by_ids"
|
|
1034
|
+
end
|
|
1035
|
+
# resource path
|
|
1036
|
+
local_var_path = '/api/v1/user/recording/{ids}'.sub('{' + 'ids' + '}', CGI.escape(ids.to_s))
|
|
1037
|
+
|
|
1038
|
+
# query parameters
|
|
1039
|
+
query_params = opts[:query_params] || {}
|
|
1040
|
+
query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
|
|
1041
|
+
query_params[:'size'] = opts[:'size'] if !opts[:'size'].nil?
|
|
1042
|
+
query_params[:'sort'] = @api_client.build_collection_param(opts[:'sort'], :multi) if !opts[:'sort'].nil?
|
|
1043
|
+
|
|
1044
|
+
# header parameters
|
|
1045
|
+
header_params = opts[:header_params] || {}
|
|
1046
|
+
# HTTP header 'Accept' (if needed)
|
|
1047
|
+
header_params['Accept'] = @api_client.select_header_accept(['application/json'])
|
|
1048
|
+
|
|
1049
|
+
# form parameters
|
|
1050
|
+
form_params = opts[:form_params] || {}
|
|
1051
|
+
|
|
1052
|
+
# http body (model)
|
|
1053
|
+
post_body = opts[:debug_body]
|
|
1054
|
+
|
|
1055
|
+
# return_type
|
|
1056
|
+
return_type = opts[:debug_return_type] || 'Array<RecordingMediumDTO>'
|
|
1057
|
+
|
|
1058
|
+
# auth_names
|
|
1059
|
+
auth_names = opts[:debug_auth_names] || ['bearer-jwt']
|
|
1060
|
+
|
|
1061
|
+
new_options = opts.merge(
|
|
1062
|
+
:operation => :"UserApi.recordings_medium_by_ids",
|
|
1063
|
+
:header_params => header_params,
|
|
1064
|
+
:query_params => query_params,
|
|
1065
|
+
:form_params => form_params,
|
|
1066
|
+
:body => post_body,
|
|
1067
|
+
:auth_names => auth_names,
|
|
1068
|
+
:return_type => return_type
|
|
1069
|
+
)
|
|
1070
|
+
|
|
1071
|
+
data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
|
|
1072
|
+
if @api_client.config.debugging
|
|
1073
|
+
@api_client.config.logger.debug "API called: UserApi#recordings_medium_by_ids\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
|
|
1074
|
+
end
|
|
1075
|
+
return data, status_code, headers
|
|
1076
|
+
end
|
|
1077
|
+
|
|
784
1078
|
# Sign up a new user.
|
|
785
1079
|
# @param save_user_dto [SaveUserDTO]
|
|
786
1080
|
# @param [Hash] opts the optional parameters
|
|
@@ -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: 2.
|
|
6
|
+
The version of the OpenAPI document: 2.1.0
|
|
7
7
|
Contact: info@songtradr.com
|
|
8
8
|
Generated by: https://openapi-generator.tech
|
|
9
|
-
|
|
9
|
+
Generator version: 7.5.0-SNAPSHOT
|
|
10
10
|
|
|
11
11
|
=end
|
|
12
12
|
|
|
@@ -17,7 +17,7 @@ require 'tempfile'
|
|
|
17
17
|
require 'time'
|
|
18
18
|
require 'faraday'
|
|
19
19
|
require 'faraday/multipart' if Gem::Version.new(Faraday::VERSION) >= Gem::Version.new('2.0')
|
|
20
|
-
require '
|
|
20
|
+
require 'marcel'
|
|
21
21
|
|
|
22
22
|
|
|
23
23
|
module SongtradrApiClientRuby
|
|
@@ -141,8 +141,7 @@ module SongtradrApiClientRuby
|
|
|
141
141
|
form_params.each do |key, value|
|
|
142
142
|
case value
|
|
143
143
|
when ::File, ::Tempfile
|
|
144
|
-
|
|
145
|
-
data[key] = Faraday::FilePart.new(value.path, filemagic.file(value.path, true))
|
|
144
|
+
data[key] = Faraday::FilePart.new(value.path, Marcel::MimeType.for(Pathname.new(value.path)))
|
|
146
145
|
when ::Array, nil
|
|
147
146
|
# let Faraday handle Array and nil parameters
|
|
148
147
|
data[key] = value
|
|
@@ -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: 2.
|
|
6
|
+
The version of the OpenAPI document: 2.1.0
|
|
7
7
|
Contact: info@songtradr.com
|
|
8
8
|
Generated by: https://openapi-generator.tech
|
|
9
|
-
|
|
9
|
+
Generator version: 7.5.0-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: 2.
|
|
6
|
+
The version of the OpenAPI document: 2.1.0
|
|
7
7
|
Contact: info@songtradr.com
|
|
8
8
|
Generated by: https://openapi-generator.tech
|
|
9
|
-
|
|
9
|
+
Generator version: 7.5.0-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: 2.
|
|
6
|
+
The version of the OpenAPI document: 2.1.0
|
|
7
7
|
Contact: info@songtradr.com
|
|
8
8
|
Generated by: https://openapi-generator.tech
|
|
9
|
-
|
|
9
|
+
Generator version: 7.5.0-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: 2.
|
|
6
|
+
The version of the OpenAPI document: 2.1.0
|
|
7
7
|
Contact: info@songtradr.com
|
|
8
8
|
Generated by: https://openapi-generator.tech
|
|
9
|
-
|
|
9
|
+
Generator version: 7.5.0-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: 2.
|
|
6
|
+
The version of the OpenAPI document: 2.1.0
|
|
7
7
|
Contact: info@songtradr.com
|
|
8
8
|
Generated by: https://openapi-generator.tech
|
|
9
|
-
|
|
9
|
+
Generator version: 7.5.0-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: 2.
|
|
6
|
+
The version of the OpenAPI document: 2.1.0
|
|
7
7
|
Contact: info@songtradr.com
|
|
8
8
|
Generated by: https://openapi-generator.tech
|
|
9
|
-
|
|
9
|
+
Generator version: 7.5.0-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: 2.
|
|
6
|
+
The version of the OpenAPI document: 2.1.0
|
|
7
7
|
Contact: info@songtradr.com
|
|
8
8
|
Generated by: https://openapi-generator.tech
|
|
9
|
-
|
|
9
|
+
Generator version: 7.5.0-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: 2.
|
|
6
|
+
The version of the OpenAPI document: 2.1.0
|
|
7
7
|
Contact: info@songtradr.com
|
|
8
8
|
Generated by: https://openapi-generator.tech
|
|
9
|
-
|
|
9
|
+
Generator version: 7.5.0-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: 2.
|
|
6
|
+
The version of the OpenAPI document: 2.1.0
|
|
7
7
|
Contact: info@songtradr.com
|
|
8
8
|
Generated by: https://openapi-generator.tech
|
|
9
|
-
|
|
9
|
+
Generator version: 7.5.0-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: 2.
|
|
6
|
+
The version of the OpenAPI document: 2.1.0
|
|
7
7
|
Contact: info@songtradr.com
|
|
8
8
|
Generated by: https://openapi-generator.tech
|
|
9
|
-
|
|
9
|
+
Generator version: 7.5.0-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: 2.
|
|
6
|
+
The version of the OpenAPI document: 2.1.0
|
|
7
7
|
Contact: info@songtradr.com
|
|
8
8
|
Generated by: https://openapi-generator.tech
|
|
9
|
-
|
|
9
|
+
Generator version: 7.5.0-SNAPSHOT
|
|
10
10
|
|
|
11
11
|
=end
|
|
12
12
|
|