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.
Files changed (118) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile.lock +3 -3
  3. data/README.md +14 -9
  4. data/docs/FileSmallDTO.md +5 -5
  5. data/docs/MusicalFeaturesDTO.md +14 -14
  6. data/docs/RecordingApi.md +36 -36
  7. data/docs/RecordingMediumDTO.md +2 -2
  8. data/docs/RecordingSmallDTO.md +3 -3
  9. data/docs/UserApi.md +308 -0
  10. data/lib/songtradr_api_client_ruby/api/allowed_values_api.rb +2 -2
  11. data/lib/songtradr_api_client_ruby/api/recording_api.rb +30 -30
  12. data/lib/songtradr_api_client_ruby/api/user_api.rb +296 -2
  13. data/lib/songtradr_api_client_ruby/api_client.rb +4 -5
  14. data/lib/songtradr_api_client_ruby/api_error.rb +2 -2
  15. data/lib/songtradr_api_client_ruby/configuration.rb +2 -2
  16. data/lib/songtradr_api_client_ruby/models/category_medium_dto.rb +2 -2
  17. data/lib/songtradr_api_client_ruby/models/category_minimal_dto.rb +2 -2
  18. data/lib/songtradr_api_client_ruby/models/config_access_dto.rb +2 -2
  19. data/lib/songtradr_api_client_ruby/models/config_identifier_dto.rb +2 -2
  20. data/lib/songtradr_api_client_ruby/models/contributor_type_dto.rb +2 -2
  21. data/lib/songtradr_api_client_ruby/models/error_response.rb +2 -2
  22. data/lib/songtradr_api_client_ruby/models/field_summary_dto.rb +2 -2
  23. data/lib/songtradr_api_client_ruby/models/file_dto.rb +2 -2
  24. data/lib/songtradr_api_client_ruby/models/file_list_dto.rb +2 -2
  25. data/lib/songtradr_api_client_ruby/models/file_small_dto.rb +44 -44
  26. data/lib/songtradr_api_client_ruby/models/file_upload_dto.rb +2 -2
  27. data/lib/songtradr_api_client_ruby/models/file_w_ith_url_dto.rb +2 -2
  28. data/lib/songtradr_api_client_ruby/models/files_summary_dto.rb +2 -2
  29. data/lib/songtradr_api_client_ruby/models/forgot_password_dto.rb +2 -2
  30. data/lib/songtradr_api_client_ruby/models/genre_dto.rb +2 -2
  31. data/lib/songtradr_api_client_ruby/models/genre_minimal_dto.rb +2 -2
  32. data/lib/songtradr_api_client_ruby/models/genres_summary_dto.rb +2 -2
  33. data/lib/songtradr_api_client_ruby/models/image_recognition_response.rb +2 -2
  34. data/lib/songtradr_api_client_ruby/models/init_put_recording_audio_dto.rb +2 -2
  35. data/lib/songtradr_api_client_ruby/models/jwt_token_dto.rb +2 -2
  36. data/lib/songtradr_api_client_ruby/models/login_dto.rb +2 -2
  37. data/lib/songtradr_api_client_ruby/models/musical_features_dto.rb +76 -76
  38. data/lib/songtradr_api_client_ruby/models/party_small_dto.rb +2 -2
  39. data/lib/songtradr_api_client_ruby/models/recording_for_similarity_search_dto.rb +2 -2
  40. data/lib/songtradr_api_client_ruby/models/recording_genre_prediction_dto.rb +2 -2
  41. data/lib/songtradr_api_client_ruby/models/recording_list_dto.rb +2 -2
  42. data/lib/songtradr_api_client_ruby/models/recording_medium_dto.rb +24 -24
  43. data/lib/songtradr_api_client_ruby/models/recording_minimal_with_musical_features_dto.rb +2 -2
  44. data/lib/songtradr_api_client_ruby/models/recording_minimal_with_taggrams_dto.rb +2 -2
  45. data/lib/songtradr_api_client_ruby/models/recording_minimal_with_tagstrengths_dto.rb +2 -2
  46. data/lib/songtradr_api_client_ruby/models/recording_party_dto.rb +2 -2
  47. data/lib/songtradr_api_client_ruby/models/recording_small_dto.rb +27 -27
  48. data/lib/songtradr_api_client_ruby/models/recording_tag_small_dto.rb +2 -2
  49. data/lib/songtradr_api_client_ruby/models/save_user_dto.rb +2 -2
  50. data/lib/songtradr_api_client_ruby/models/search_filter_values_dto.rb +2 -2
  51. data/lib/songtradr_api_client_ruby/models/sign_up_dto.rb +2 -2
  52. data/lib/songtradr_api_client_ruby/models/tag_dto.rb +2 -2
  53. data/lib/songtradr_api_client_ruby/models/tag_small_dto.rb +2 -2
  54. data/lib/songtradr_api_client_ruby/models/taggram_dto.rb +2 -2
  55. data/lib/songtradr_api_client_ruby/models/tags_summary_dto.rb +2 -2
  56. data/lib/songtradr_api_client_ruby/models/tagstrength_dto.rb +2 -2
  57. data/lib/songtradr_api_client_ruby/models/title_dto.rb +2 -2
  58. data/lib/songtradr_api_client_ruby/models/token_request.rb +2 -2
  59. data/lib/songtradr_api_client_ruby/models/track_dto.rb +2 -2
  60. data/lib/songtradr_api_client_ruby/models/update_password_dto.rb +2 -2
  61. data/lib/songtradr_api_client_ruby/models/user_dto.rb +2 -2
  62. data/lib/songtradr_api_client_ruby/models/video_recognition_response.rb +2 -2
  63. data/lib/songtradr_api_client_ruby/version.rb +3 -3
  64. data/lib/songtradr_api_client_ruby.rb +2 -2
  65. data/openapi-generator-config.yaml +1 -1
  66. data/songtradr_api_client_ruby.gemspec +3 -3
  67. data/spec/api/allowed_values_api_spec.rb +2 -2
  68. data/spec/api/recording_api_spec.rb +10 -10
  69. data/spec/api/user_api_spec.rb +60 -2
  70. data/spec/models/category_medium_dto_spec.rb +2 -2
  71. data/spec/models/category_minimal_dto_spec.rb +2 -2
  72. data/spec/models/config_access_dto_spec.rb +2 -2
  73. data/spec/models/config_identifier_dto_spec.rb +2 -2
  74. data/spec/models/contributor_type_dto_spec.rb +2 -2
  75. data/spec/models/error_response_spec.rb +2 -2
  76. data/spec/models/field_summary_dto_spec.rb +2 -2
  77. data/spec/models/file_dto_spec.rb +2 -2
  78. data/spec/models/file_list_dto_spec.rb +2 -2
  79. data/spec/models/file_small_dto_spec.rb +18 -18
  80. data/spec/models/file_upload_dto_spec.rb +2 -2
  81. data/spec/models/file_w_ith_url_dto_spec.rb +2 -2
  82. data/spec/models/files_summary_dto_spec.rb +2 -2
  83. data/spec/models/forgot_password_dto_spec.rb +2 -2
  84. data/spec/models/genre_dto_spec.rb +2 -2
  85. data/spec/models/genre_minimal_dto_spec.rb +2 -2
  86. data/spec/models/genres_summary_dto_spec.rb +2 -2
  87. data/spec/models/image_recognition_response_spec.rb +2 -2
  88. data/spec/models/init_put_recording_audio_dto_spec.rb +2 -2
  89. data/spec/models/jwt_token_dto_spec.rb +2 -2
  90. data/spec/models/login_dto_spec.rb +2 -2
  91. data/spec/models/musical_features_dto_spec.rb +32 -32
  92. data/spec/models/party_small_dto_spec.rb +2 -2
  93. data/spec/models/recording_for_similarity_search_dto_spec.rb +2 -2
  94. data/spec/models/recording_genre_prediction_dto_spec.rb +2 -2
  95. data/spec/models/recording_list_dto_spec.rb +2 -2
  96. data/spec/models/recording_medium_dto_spec.rb +8 -8
  97. data/spec/models/recording_minimal_with_musical_features_dto_spec.rb +2 -2
  98. data/spec/models/recording_minimal_with_taggrams_dto_spec.rb +2 -2
  99. data/spec/models/recording_minimal_with_tagstrengths_dto_spec.rb +2 -2
  100. data/spec/models/recording_party_dto_spec.rb +2 -2
  101. data/spec/models/recording_small_dto_spec.rb +5 -5
  102. data/spec/models/recording_tag_small_dto_spec.rb +2 -2
  103. data/spec/models/save_user_dto_spec.rb +2 -2
  104. data/spec/models/search_filter_values_dto_spec.rb +2 -2
  105. data/spec/models/sign_up_dto_spec.rb +2 -2
  106. data/spec/models/tag_dto_spec.rb +2 -2
  107. data/spec/models/tag_small_dto_spec.rb +2 -2
  108. data/spec/models/taggram_dto_spec.rb +2 -2
  109. data/spec/models/tags_summary_dto_spec.rb +2 -2
  110. data/spec/models/tagstrength_dto_spec.rb +2 -2
  111. data/spec/models/title_dto_spec.rb +2 -2
  112. data/spec/models/token_request_spec.rb +2 -2
  113. data/spec/models/track_dto_spec.rb +2 -2
  114. data/spec/models/update_password_dto_spec.rb +2 -2
  115. data/spec/models/user_dto_spec.rb +2 -2
  116. data/spec/models/video_recognition_response_spec.rb +2 -2
  117. data/spec/spec_helper.rb +2 -2
  118. 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.0.0
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
- OpenAPI Generator version: 7.4.0-SNAPSHOT
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.0.0
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
- OpenAPI Generator version: 7.4.0-SNAPSHOT
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 'filemagic'
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
- filemagic = FileMagic.new(FileMagic::MAGIC_MIME)
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.0.0
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
- OpenAPI Generator version: 7.4.0-SNAPSHOT
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.0.0
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
- OpenAPI Generator version: 7.4.0-SNAPSHOT
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.0.0
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
- OpenAPI Generator version: 7.4.0-SNAPSHOT
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.0.0
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
- OpenAPI Generator version: 7.4.0-SNAPSHOT
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.0.0
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
- OpenAPI Generator version: 7.4.0-SNAPSHOT
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.0.0
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
- OpenAPI Generator version: 7.4.0-SNAPSHOT
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.0.0
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
- OpenAPI Generator version: 7.4.0-SNAPSHOT
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.0.0
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
- OpenAPI Generator version: 7.4.0-SNAPSHOT
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.0.0
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
- OpenAPI Generator version: 7.4.0-SNAPSHOT
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.0.0
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
- OpenAPI Generator version: 7.4.0-SNAPSHOT
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.0.0
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
- OpenAPI Generator version: 7.4.0-SNAPSHOT
9
+ Generator version: 7.5.0-SNAPSHOT
10
10
 
11
11
  =end
12
12