wordnik 4.06.05 → 4.06.06

data/.rspec

@@ -0,0 +1 @@
+--colour

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    wordnik (4.06.05)
+    wordnik (4.06.06)
       activemodel (>= 3.0.3)
       addressable (>= 2.2.4)
       htmlentities (>= 4.2.4)
@@ -12,40 +12,46 @@ PATH
 GEM
   remote: http://rubygems.org/
   specs:
-    activemodel (3.0.9)
-      activesupport (= 3.0.9)
+    ZenTest (4.6.2)
+    activemodel (3.0.10)
+      activesupport (= 3.0.10)
       builder (~> 2.1.2)
       i18n (~> 0.5.0)
-    activesupport (3.0.9)
-    addressable (2.2.4)
+    activesupport (3.0.10)
+    addressable (2.2.6)
+    autotest (4.4.6)
+      ZenTest (>= 4.4.1)
+    autotest-rails-pure (4.1.2)
     builder (2.1.2)
     crack (0.1.8)
-    diff-lcs (1.1.2)
+    diff-lcs (1.1.3)
     htmlentities (4.3.0)
     i18n (0.5.0)
     json (1.5.3)
     mime-types (1.16)
     nokogiri (1.5.0)
-    rspec (2.5.0)
-      rspec-core (~> 2.5.0)
-      rspec-expectations (~> 2.5.0)
-      rspec-mocks (~> 2.5.0)
-    rspec-core (2.5.1)
-    rspec-expectations (2.5.0)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
       diff-lcs (~> 1.1.2)
-    rspec-mocks (2.5.0)
+    rspec-mocks (2.6.0)
     typhoeus (0.2.4)
       mime-types
       mime-types
-    vcr (1.5.1)
-    webmock (1.6.2)
-      addressable (>= 2.2.2)
+    vcr (1.11.2)
+    webmock (1.7.5)
+      addressable (~> 2.2, > 2.2.5)
       crack (>= 0.1.7)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
+  autotest
+  autotest-rails-pure
   rspec (>= 2.5.0)
   vcr (>= 1.5.1)
   webmock (>= 1.6.2)

data/Rakefile

@@ -9,178 +9,41 @@ RSpec::Core::RakeTask.new('spec')
 # If you want to make this the default task
 task :default => :spec
 
-desc 'Download the latest API docs and build out resource methods'
-task :abracadabra do
-  Rake::Task['fetch_api_docs'].invoke
-  # Rake::Task['write_resource_methods'].invoke
-  # Rake::Task['generate_usage_docs'].invoke  
-end
-
-desc 'Download the API docs to disk'
-task :fetch_api_docs do
-  
-  puts "\nFetch API Docs"
-  puts "--------------\n"
-
-  puts "\nEnter the base path (leave blank to default to beta.wordnik.com/v4): "
-  base_uri = STDIN.gets.chomp.sub('http://', '').sub('https://', '')
-  base_uri = 'beta.wordnik.com/v4' if base_uri.blank?
-  
-  puts "\nEnter a space-delimited list of resource names (optional): "
-  resource_names = STDIN.gets.chomp.split(" ")
+desc 'Download the latest swagger API docs and build out resource methods'
+task :swagger do
+  
+  # Configure default input values..
+  settings = {
+    :scheme => 'http',
+    :host => 'localhost:8001',
+    :base_path => "/admin/api",
+    :api_key => 'b39ee8d5f05d0f566a0080b4c310ceddf5dc5f7606a616f53',
+  }
+
+  # Ask user for each setting, using the defaults where user input is blank
+  settings.each do |name, default_value|
+    puts "\nEnter the #{name} (default is '#{default_value}'): "
+    input = STDIN.gets.chomp
+    settings[name.to_sym] = input unless input.blank?
+  end
   
-  puts "\nEnter API key (leave blank to fetch publically available resources): "
-  api_key = STDIN.gets.chomp
-    
   # Configure Wordnik, but tell it not to attempt to build resources
   # (there aren't any JSON docs yet.. a chicken/egg thing.)
-  Wordnik.configure(false) do |c|
-    c.base_uri = base_uri
-    c.resource_names = resource_names unless resource_names.blank?
-    c.api_key = api_key unless api_key.blank?
+  Wordnik.configure(false) do |config|
+    config.scheme = settings[:scheme]
+    config.host = settings[:host]
+    config.base_path = settings[:base_path]
+    config.api_key = settings[:api_key] unless settings[:api_key].blank?
   end
 
-  puts "\nCleanup"
-  puts "-------\n"
-  
-  `rm api_docs/*.json`
-  `rm lib/wordnik/resource_modules/*.rb`
+  puts "\nDownloading resource descriptions"
+  Wordnik.download_resource_descriptions
   
-  Wordnik.configuration.resource_names.each do |resource_name|
-    request = Wordnik::Request.new(:get, "#{resource_name}.json")
-    filename = "api_docs/#{resource_name}.json"
-    File.open(filename, 'w') {|f| f.write(request.response.raw.body) }
-  end
-  
-  puts "\nWrite Resource Methods"
-  puts "----------------------\n"
-  
-  Wordnik.build_resources
-  
-  Wordnik.resources.each_pair do |resource_name, resource|
-
-    next unless resource.endpoints.present?
-    
-    filename = "lib/wordnik/resource_modules/#{resource_name}.rb"
-    puts filename
-    file = File.new(filename, "w")
-    lines = []
-
-    lines << "# HEY HACKER! THIS IS AN AUTO-GENERATED FILE."
-    lines << "# So don't bother editing it. To see how it's built, take a look at the Rakefile\n"
-    
-    lines << "module #{resource_name.to_s.camelize}Methods\n"
-    
-    resource.endpoints.each do |endpoint|
-      endpoint.operations.each do |operation|
-        
-        next if operation.nickname.blank?
-
-        # Comment about the operation
-        lines << "  # #{operation.summary}" if operation.summary.present?
-        lines << "  # #{operation.notes}" if operation.notes.present?
-        lines << "  #" if operation.summary.present?
-        
-        # Start writing the method
-        lines << "  def #{operation.nickname}(#{[operation.positional_parameter_names, '*args'].flatten.join(', ')})"
+  Wordnik.instantiate_resources
 
-        # HTTP Method
-        lines << "    http_method = :#{operation.http_method}"
-
-        # Path
-        lines << "    path = '#{endpoint.path.sub(".{format}", "")}'"
-        operation.positional_parameter_names.each do |param|
-          # `body` positional params don't get injected into the path will be dealt with separately
-          next if param.to_s == 'body' 
-          lines << "    path.sub!('\{#{param}\}', #{param}.to_s)"
-        end
-
-        lines << "\n    # Ruby turns all key-value arguments at the end into a single hash"
-        lines << "    # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')"
-        lines << "    # becomes {:limit => 10, :part_of_speech => 'verb'}"
-        lines << "    last_arg = args.pop if args.last.is_a?(Hash)"
-        lines << "    last_arg = args.pop if args.last.is_a?(Array)"
-        lines << "    last_arg ||= {}\n"
-        
-        lines << "    # Look for a kwarg called :request_only, whose presence indicates"
-        lines << "    # that we want the request itself back, not the response body"
-        lines << "    if last_arg.is_a?(Hash) && last_arg[:request_only].present?"
-        lines << "      request_only = true"
-        lines << "      last_arg.delete(:request_only)"
-        lines << "    end\n"
-        
-        lines << "    params = last_arg"
-        lines << "    body ||= {}"
-        
-        lines << "    request = Wordnik::Request.new(http_method, path, :params => params, :body => body)"
-        lines << "    request_only ? request : request.response.body"
-        lines << "  end\n"
-        
-        # case response.valueType
-        # when 'wordObject'
-        #   Wordnik::Word.new(response.body)
-        # when 'List[definition]'
-        #   response.body.map do |definition_data|
-        #     Wordnik::Definition.new(definition_data)
-        #   end
-        # end
-        
-      end      
-    end
-
-    lines << "end"
-    file.write lines.join("\n")
-    file.close
-    
+  puts "\nWriting convenience methods"
+  Wordnik.resources.each_pair do |name, resource|
+    resource.write_convenience_methods
   end
   
-  
-end
-
-desc 'Iterate over resource > endpoint > operation nicknames, generating markdown documentation.'
-task :generate_usage_docs do
-  Wordnik.configure
-  filename = "USAGE.md"
-  file = File.new(filename, "w")
-  
-  puts "\nGenerate Documentation"
-  puts "----------------------\n"
-  
-  Wordnik.resources.each_pair do |resource_name, resource|
-
-    next unless resource.endpoints.present?
-    file.write "\n#{resource_name}\n#{"=" * resource_name.size}\n\n"
-    
-    resource.endpoints.each do |endpoint|
-      endpoint.operations.each do |operation|
-        
-        docs_url = "http://developer.wordnik.com/docs/#!/#{resource.name}/#{operation.nickname}"
-        
-        puts "Wordnik.#{resource_name}.#{operation.nickname}"
-        
-        # Method name
-        file.write "[Wordnik.#{resource_name}.#{operation.nickname}(#{operation.positional_parameter_names.join(', ')})](#{docs_url})\n"
-        
-        # Required kwargs
-        operation.required_kwargs.each do |parameter|
-          file.write "    :#{parameter.name.to_s.underscore}* #{' ' * (29-parameter.name.to_s.underscore.size)} #{parameter.description}\n"
-        end
-
-        # Optional kwargs
-        operation.optional_kwargs.each do |parameter|
-          file.write "    :#{parameter.name.to_s.underscore} #{' ' * (30-parameter.name.to_s.underscore.size)} #{parameter.description}\n"
-        end
-      end
-      
-      file.write "\n"
-    end
-  end
-
-  file.close
-end
-
-
-# desc 'Iterate over each resource, generating a ruby module with operation methods for each.'
-# task :write_resource_methods do
-# 
-# end
+end

data/api_docs/account.json

@@ -1 +1 @@
-{"endPoints":[{"path":"/account.{format}/authenticate/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"A confirmed Wordnik username","required":true,"dataType":"string","paramType":"path"},{"name":"password","description":"The user's password","required":true,"dataType":"string","paramType":"query"}],"response":[{"valueType":"AuthenticationToken","errorResponses":[{"reason":"Account not available.","code":403},{"reason":"User not found.","code":404}],"condition":"any"}],"category":"Authentication","summary":"Authenticates a User","suggestedName":"authenticate","deprecated":false,"open":false,"httpMethod":"GET"},{"parameters":[{"name":"username","description":"A confirmed Wordnik username","required":true,"dataType":"string","paramType":"path"},{"description":"The user's password","required":true,"dataType":"string","paramType":"body"}],"response":[{"valueType":"AuthenticationToken","errorResponses":[{"reason":"Account not available.","code":403},{"reason":"User not found.","code":404}],"condition":"any"}],"category":"Authentication","summary":"Authenticates a user","suggestedName":"authenticatePost","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/account.{format}/logout","description":"","operations":[{"parameters":[{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","paramType":"header"}],"response":[{"valueType":"void","condition":"any"}],"category":"Authentication","summary":"Logs out a user","suggestedName":"logout","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/account","description":"","operations":[{"response":[{"valueType":"doc","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Help","summary":"Returns information about API parameters","suggestedName":"getHelp","deprecated":false,"open":true,"httpMethod":"GET"}]},{"path":"/account.{format}/wordLists","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","paramType":"header"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[wordList]","errorResponses":[{"reason":"Not authenticated.","code":403},{"reason":"User account not found.","code":404}],"condition":"any"}],"category":"WordLists","summary":"Fetches WordList objects for the logged-in user.","suggestedName":"getWordListsForCurrentUser","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/account.{format}/forgotPassword/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"Username","required":true,"dataType":"string","paramType":"path"}],"response":[{"valueType":"String","errorResponses":[{"reason":"User is Facebook Connected","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"AccountManagement","summary":"Authenticates a User","suggestedName":"getForgotPassword","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/account.{format}/resetPassword/{hashcode}","description":"","operations":[{"parameters":[{"name":"hashcode","description":"Password reset code","required":true,"dataType":"string","paramType":"path"}],"response":[{"valueType":"user","errorResponses":[{"reason":"Invalid code supplied.","code":400},{"reason":"User not found or code invalid.","code":404}],"condition":"any"}],"category":"AccountManagement","summary":"Fetches a User by code","suggestedName":"resetPassword","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/account.{format}/apiAccountApplication","description":"","operations":[{"parameters":[{"description":"API Application Info","required":true,"dataType":"apiApplication","paramType":"body"}],"response":[{"valueType":"ApiResponse","errorResponses":[{"reason":"Account not available.","code":403},{"reason":"User not found.","code":404}],"condition":"any"}],"category":"ApiAccount","summary":"Creates an API account application.","suggestedName":"createApiAccount","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/account.{format}/regenerateApiToken","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","paramType":"header"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid token supplied.","code":400}],"condition":"any"}],"category":"ApiAccount","summary":"Regenerates an API Token.  Currently not supported or tested.","suggestedName":"createApiAccount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/account.{format}/apiTokenStatus","description":"","operations":[{"parameters":[{"name":"api_key","description":"Wordnik authentication token","required":true,"dataType":"string","paramType":"header"},{"name":"api_key","description":"Wordnik authentication token","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"ApiTokenStatus","errorResponses":[{"reason":"No token supplied.","code":400},{"reason":"No API account with supplied token.","code":404}],"condition":"any"}],"category":"ApiAccount","summary":"Returns usage statistics for the API account.","suggestedName":"getApiTokenStatus","deprecated":false,"open":true,"httpMethod":"GET"}]},{"path":"/account.{format}/logVisit","description":"","operations":[{"parameters":[{"name":"userId","description":"User ID to track data for","required":false,"dataType":"string","paramType":"query"},{"name":"userGuid","description":"User's persistent GUID","required":false,"dataType":"string","paramType":"query"},{"name":"userSessionId","description":"User's session ID","required":false,"dataType":"string","paramType":"query"},{"name":"userIpAddress","description":"User IP address","required":false,"dataType":"string","paramType":"query"},{"name":"serverIp","description":"Server IP address","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"String","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"No activation code available.","code":404}],"condition":"any"}],"category":"Activity","summary":"Logs a VisitAction for the user","suggestedName":"logVisitForUser","deprecated":false,"open":false,"notes":"Requires a valid auth_token to be set.","httpMethod":"POST"}]},{"path":"/account.{format}/activationCode/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"Username","required":true,"dataType":"string","paramType":"path"}],"response":[{"valueType":"String","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"No activation code available.","code":404}],"condition":"any"}],"category":"Activation","summary":"Returns an activation code given a username","suggestedName":"getActivationCodeForUser","deprecated":false,"open":false,"notes":"If an activation code is not available, will return null.","httpMethod":"GET"}]},{"path":"/account.{format}/activate","description":"","operations":[{"parameters":[{"description":"Activation Code","required":true,"dataType":"string","paramType":"body"}],"response":[{"valueType":"user","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"No activation code found.","code":404}],"condition":"any"}],"category":"Activation","summary":"Activates an account.","suggestedName":"activateUser","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/account.{format}/usernameAvailable/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"Username","required":true,"dataType":"string","paramType":"path"}],"response":[{"valueType":"ApiResponse","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"No activation code available.","code":404}],"condition":"any"}],"category":"Activation","summary":"Returns an ApiResponse indicating whether or not a username is available","suggestedName":"getUsernameAvailable","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/account.{format}/user","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","paramType":"header"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","paramType":"header"}],"response":[{"valueType":"user","errorResponses":[{"reason":"Not logged in.","code":403},{"reason":"User not found.","code":404}],"condition":"any"}],"category":"UserInfo","summary":"Returns the logged-in User","suggestedName":"getLoggedInUser","deprecated":false,"open":false,"notes":"Requires a valid auth_token to be set.","httpMethod":"GET"}]},{"path":"/account.{format}/profile","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","paramType":"header"}],"response":[{"valueType":"UserProfile","errorResponses":[{"reason":"Not logged in.","code":403},{"reason":"User not found.","code":404}],"condition":"any"}],"category":"UserInfo","summary":"Returns profile info for the logged-in user","suggestedName":"getLoggedInUserProfile","deprecated":false,"open":false,"notes":"Requires a valid auth_token to be set.","httpMethod":"GET"}]},{"path":"/account.{format}/settings","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","paramType":"header"}],"response":[{"valueType":"UserSettings","errorResponses":[{"reason":"Not logged in.","code":403},{"reason":"User not found.","code":404}],"condition":"any"}],"category":"UserInfo","summary":"Returns logged-in User Settings","suggestedName":"getLoggedInUserSettings","deprecated":false,"open":false,"notes":"Requires a valid auth_token to be set.","httpMethod":"GET"}]},{"path":"/account.{format}/trackingInfo","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","paramType":"header"}],"response":[{"valueType":"UserTrackingInfo","errorResponses":[{"reason":"Not logged in.","code":403},{"reason":"User not found.","code":404}],"condition":"any"}],"category":"UserInfo","summary":"Returns logged-in User TrackingInfo.","suggestedName":"getLoggedInUserTrackingInfo","deprecated":false,"open":false,"notes":"Requires a valid auth_token to be set.","httpMethod":"GET"}]}],"models":[{"name":"error","fields":[{"name":"reason","required":false,"paramType":"string"},{"name":"code","required":false,"paramType":"int"}]},{"name":"UserHandle","fields":[{"name":"webService","required":false,"paramType":"int"},{"name":"handle","required":false,"paramType":"string"}]},{"name":"object","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"fields","required":false,"paramType":"List[parameter]"},{"name":"uniqueFieldName","required":false,"paramType":"string"}]},{"name":"UserTrackingInfo","fields":[{"name":"userId","required":false,"paramType":"long"},{"name":"signupIPAddress","required":false,"paramType":"string"},{"name":"noOfLogins","required":false,"paramType":"int"},{"name":"signupDate","required":false,"paramType":"Date"},{"name":"lastUpdatedDate","required":false,"paramType":"Date"},{"name":"lastLoginDate","required":false,"paramType":"Date"}]},{"name":"ApiResponse","fields":[{"name":"message","required":false,"paramType":"string"},{"name":"type","required":false,"paramType":"string"}]},{"name":"UserProfile","fields":[{"name":"location","required":false,"paramType":"string"},{"name":"userId","required":false,"paramType":"long"},{"name":"firstName","required":false,"paramType":"string"},{"name":"lastName","required":false,"paramType":"string"},{"name":"bio","required":false,"paramType":"string"},{"name":"siteUrl","required":false,"paramType":"string"},{"name":"leastFavoriteWord","required":false,"paramType":"string"},{"name":"mostFavoriteWord","required":false,"paramType":"string"},{"name":"onomaTopoeiaWord","required":false,"paramType":"string"},{"name":"seekingWord","required":false,"paramType":"string"},{"name":"youWord","required":false,"paramType":"string"},{"name":"userHandles","required":false,"paramType":"List[UserHandle]"},{"name":"siteName","required":false,"paramType":"string"}]},{"name":"response","fields":[{"name":"valueType","required":false,"paramType":"string"},{"name":"errorResponses","required":false,"paramType":"List[error]"},{"name":"occurs","required":false,"paramType":"string"},{"name":"condition","required":false,"paramType":"string"}]},{"name":"parameter","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"defaultValue","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"required","required":false,"paramType":"boolean"},{"name":"dataType","required":false,"paramType":"string"},{"name":"allowableValues","required":false,"paramType":"string"},{"name":"wrapperName","required":false,"paramType":"string"},{"name":"internalDescription","required":false,"paramType":"string"},{"name":"paramAccess","required":false,"paramType":"string"},{"name":"paramType","required":false,"paramType":"string"}]},{"name":"wordList","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"long"},{"name":"type","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"userId","required":false,"paramType":"long"},{"name":"permalink","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"username","required":false,"paramType":"string"},{"name":"updatedAt","required":false,"paramType":"Date"},{"name":"numberWordsInList","required":false,"paramType":"long"}]},{"name":"doc","fields":[{"name":"endPoints","required":false,"paramType":"List[endpoint]"},{"name":"models","required":false,"paramType":"List[object]"}]},{"name":"UserSettings","fields":[{"name":"userId","required":false,"paramType":"long"},{"name":"bossURL","required":false,"paramType":"string"}]},{"name":"ApiTokenStatus","fields":[{"name":"token","required":false,"paramType":"string"},{"name":"expiresInMillis","required":false,"paramType":"long"},{"name":"totalRequests","required":false,"paramType":"long"},{"name":"remainingCalls","required":false,"paramType":"long"},{"name":"resetsInMillis","required":false,"paramType":"long"}]},{"name":"AuthenticationToken","fields":[{"name":"token","required":false,"paramType":"string"},{"name":"userId","required":false,"paramType":"long"}]},{"name":"operation","fields":[{"name":"parameters","required":false,"paramType":"List[parameter]"},{"name":"response","required":false,"paramType":"List[response]"},{"name":"category","required":false,"paramType":"string"},{"name":"summary","required":false,"paramType":"string"},{"name":"suggestedName","required":false,"paramType":"string"},{"name":"deprecated","required":false,"paramType":"boolean"},{"name":"open","required":false,"paramType":"boolean"},{"name":"notes","required":false,"paramType":"string"},{"name":"httpMethod","required":false,"paramType":"string"}]},{"name":"endpoint","fields":[{"name":"path","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"operations","required":false,"paramType":"List[operation]"}]},{"name":"user","fields":[{"name":"id","description":"Unique idenitifier for a user","required":false,"paramType":"long"},{"name":"displayName","description":"Display name","required":false,"paramType":"string"},{"name":"status","description":"Account status","required":false,"allowableValues":"0,1,2,3","paramType":"int"},{"name":"password","required":false,"paramType":"string"},{"name":"userName","description":"User name","required":false,"paramType":"string"},{"name":"email","description":"Email address","required":false,"paramType":"string"},{"name":"faceBookId","description":"Facebook ID","required":false,"paramType":"string"}]}]}
+{"resourcePath":"/account","models":{"ApiTokenStatus":{"properties":{"token":{"type":"string","required":false,"uniqueItems":false},"resetsInMillis":{"type":"long","required":false,"uniqueItems":false},"remainingCalls":{"type":"long","required":false,"uniqueItems":false},"expiresInMillis":{"type":"long","required":false,"uniqueItems":false},"totalRequests":{"type":"long","required":false,"uniqueItems":false}},"id":"ApiTokenStatus","type":"any","required":false,"uniqueItems":false},"AuthenticationToken":{"properties":{"token":{"type":"string","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"userSignature":{"type":"string","required":false,"uniqueItems":false}},"id":"AuthenticationToken","type":"any","required":false,"uniqueItems":false},"ApiResponse":{"properties":{"message":{"type":"string","required":false,"uniqueItems":false},"type":{"type":"string","required":false,"uniqueItems":false}},"id":"ApiResponse","type":"any","required":false,"uniqueItems":false},"UserHandle":{"properties":{"webService":{"type":"int","required":false,"uniqueItems":false},"handle":{"type":"string","required":false,"uniqueItems":false}},"id":"UserHandle","type":"any","required":false,"uniqueItems":false},"UserSettings":{"properties":{"bossURL":{"type":"string","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false}},"id":"UserSettings","type":"any","required":false,"uniqueItems":false},"UserTrackingInfo":{"properties":{"signupDate":{"type":"Date","required":false,"uniqueItems":false},"lastLoginDate":{"type":"Date","required":false,"uniqueItems":false},"noOfLogins":{"type":"int","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"lastUpdatedDate":{"type":"Date","required":false,"uniqueItems":false},"signupIPAddress":{"type":"string","required":false,"uniqueItems":false}},"id":"UserTrackingInfo","type":"any","required":false,"uniqueItems":false},"UserProfile":{"properties":{"lastName":{"type":"string","required":false,"uniqueItems":false},"mostFavoriteWord":{"type":"string","required":false,"uniqueItems":false},"location":{"type":"string","required":false,"uniqueItems":false},"seekingWord":{"type":"string","required":false,"uniqueItems":false},"leastFavoriteWord":{"type":"string","required":false,"uniqueItems":false},"onomaTopoeiaWord":{"type":"string","required":false,"uniqueItems":false},"siteUrl":{"type":"string","required":false,"uniqueItems":false},"bio":{"type":"string","required":false,"uniqueItems":false},"userHandles":{"type":"array","required":false,"items":{"$ref":"UserHandle","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"youWord":{"type":"string","required":false,"uniqueItems":false},"firstName":{"type":"string","required":false,"uniqueItems":false},"siteName":{"type":"string","required":false,"uniqueItems":false}},"id":"UserProfile","type":"any","required":false,"uniqueItems":false},"apiApplication":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"userName":{"type":"string","required":false,"uniqueItems":false},"approvalState":{"type":"ApiApprovalState","required":false,"uniqueItems":false},"comment":{"type":"string","required":false,"uniqueItems":false}},"id":"apiApplication","type":"any","required":false,"uniqueItems":false},"ApiApprovalState":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"ApiApprovalState","type":"any","required":false,"uniqueItems":false},"user":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"email":{"type":"string","required":false,"uniqueItems":false},"status":{"type":"int","required":false,"uniqueItems":false},"faceBookId":{"type":"string","required":false,"uniqueItems":false},"userName":{"type":"string","required":false,"uniqueItems":false},"displayName":{"type":"string","required":false,"uniqueItems":false},"password":{"type":"string","required":false,"uniqueItems":false}},"id":"user","type":"any","required":false,"uniqueItems":false},"wordList":{"properties":{"updatedAt":{"type":"Date","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"username":{"type":"string","required":false,"uniqueItems":false},"permalink":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false},"numberWordsInList":{"type":"long","required":false,"uniqueItems":false},"type":{"type":"string","required":false,"uniqueItems":false}},"id":"wordList","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/account.{format}/authenticate/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"A confirmed Wordnik username","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"password","description":"The user's password","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Authenticates a User","httpMethod":"GET","errorResponses":[{"reason":"Account not available.","code":403},{"reason":"User not found.","code":404}],"nickname":"authenticate","responseClass":"AuthenticationToken"},{"parameters":[{"name":"username","description":"A confirmed Wordnik username","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"The user's password","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Authenticates a user","httpMethod":"POST","errorResponses":[{"reason":"Account not available.","code":403},{"reason":"User not found.","code":404}],"nickname":"authenticatePost","responseClass":"AuthenticationToken"}]},{"path":"/account.{format}/logout","description":"","operations":[{"parameters":[{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"}],"summary":"Logs out a user","httpMethod":"GET","nickname":"logout","responseClass":"ok"}]},{"path":"/account.{format}/wordLists","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordList objects for the logged-in user.","httpMethod":"GET","errorResponses":[{"reason":"Not authenticated.","code":403},{"reason":"User account not found.","code":404}],"nickname":"getWordListsForCurrentUser","responseClass":"List[wordList]"}]},{"path":"/account.{format}/forgotPassword/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"Username","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Authenticates a User","httpMethod":"GET","errorResponses":[{"reason":"User is Facebook Connected","code":400},{"reason":"User not found","code":404}],"nickname":"getForgotPassword","responseClass":"String"}]},{"path":"/account.{format}/resetPassword/{hashcode}","description":"","operations":[{"parameters":[{"name":"hashcode","description":"Password reset code","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches a User by code","httpMethod":"GET","errorResponses":[{"reason":"Invalid code supplied","code":400},{"reason":"User not found or code invalid.","code":404}],"nickname":"resetPassword","responseClass":"user"}]},{"path":"/account.{format}/apiAccountApplication","description":"","operations":[{"parameters":[{"description":"API Application Info","required":true,"dataType":"apiApplication","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Creates an API account application.","httpMethod":"POST","errorResponses":[{"reason":"Account not available.","code":403},{"reason":"User not found.","code":404}],"nickname":"createApiAccount","responseClass":"ApiResponse"}]},{"path":"/account.{format}/regenerateApiToken","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"}],"summary":"Regenerates an API Token.  Currently not supported or tested.","httpMethod":"GET","errorResponses":[{"reason":"Invalid token supplied.","code":400}],"nickname":"createApiAccount","responseClass":"ok"}]},{"path":"/account.{format}/apiTokenStatus","description":"","operations":[{"parameters":[{"name":"api_key","description":"Wordnik authentication token","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"},{"name":"api_key","description":"Wordnik authentication token","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns usage statistics for the API account.","httpMethod":"GET","errorResponses":[{"reason":"No token supplied.","code":400},{"reason":"No API account with supplied token.","code":404}],"nickname":"getApiTokenStatus","responseClass":"ApiTokenStatus"}]},{"path":"/account.{format}/logVisit","description":"","operations":[{"parameters":[{"name":"userId","description":"User ID to track data for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"userGuid","description":"User's persistent GUID","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"userSessionId","description":"User's session ID","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"userIpAddress","description":"User IP address","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"serverIp","description":"Server IP address","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Logs a VisitAction for the user","httpMethod":"POST","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"logVisitForUser","responseClass":"Stirng","notes":"Requires a valid auth_token to be set."}]},{"path":"/account.{format}/activationCode/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"Username","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns an activation code given a username","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getActivationCodeForUser","responseClass":"String","notes":"If an activation code is not available, will return null."}]},{"path":"/account.{format}/activate","description":"","operations":[{"parameters":[{"description":"Activation Code","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Activates an account.","httpMethod":"POST","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"No activation code found.","code":404}],"nickname":"activateUser","responseClass":"user"}]},{"path":"/account.{format}/usernameAvailable/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"Username","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns an ApiResponse indicating whether or not a username is available","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getUsernameAvailable","responseClass":"ApiResponse"}]},{"path":"/account.{format}/user","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"}],"summary":"Returns the logged-in User","httpMethod":"GET","errorResponses":[{"reason":"Not logged in.","code":403},{"reason":"User not found.","code":404}],"nickname":"getLoggedInUser","responseClass":"user","notes":"Requires a valid auth_token to be set."}]},{"path":"/account.{format}/profile","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"}],"summary":"Returns profile info for the logged-in user","httpMethod":"GET","errorResponses":[{"reason":"Not logged in.","code":403},{"reason":"User not found.","code":404}],"nickname":"getLoggedInUserProfile","responseClass":"UserProfile","notes":"Requires a valid auth_token to be set."}]},{"path":"/account.{format}/settings","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"}],"summary":"Returns logged-in User Settings","httpMethod":"GET","errorResponses":[{"reason":"Not logged in.","code":403},{"reason":"User not found.","code":404}],"nickname":"getLoggedInUserSettings","responseClass":"UserSettings","notes":"Requires a valid auth_token to be set."}]},{"path":"/account.{format}/trackingInfo","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"}],"summary":"Returns logged-in User TrackingInfo.","httpMethod":"GET","errorResponses":[{"reason":"Not logged in.","code":403},{"reason":"User not found.","code":404}],"nickname":"getLoggedInUserTrackingInfo","responseClass":"UserTrackingInfo","notes":"Requires a valid auth_token to be set."}]}],"models1":[{"name":"ApiResponse","fields":[{"name":"message","required":false,"allowMultiple":false,"paramType":"string"},{"name":"type","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"UserProfile","fields":[{"name":"location","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"firstName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"lastName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"bio","required":false,"allowMultiple":false,"paramType":"string"},{"name":"siteUrl","required":false,"allowMultiple":false,"paramType":"string"},{"name":"leastFavoriteWord","required":false,"allowMultiple":false,"paramType":"string"},{"name":"mostFavoriteWord","required":false,"allowMultiple":false,"paramType":"string"},{"name":"onomaTopoeiaWord","required":false,"allowMultiple":false,"paramType":"string"},{"name":"seekingWord","required":false,"allowMultiple":false,"paramType":"string"},{"name":"youWord","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userHandles","required":false,"allowMultiple":false,"paramType":"List[UserHandle]"},{"name":"siteName","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"ApiApprovalState","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"wordList","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"type","required":false,"allowMultiple":false,"paramType":"string"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"permalink","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"username","required":false,"allowMultiple":false,"paramType":"string"},{"name":"updatedAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"numberWordsInList","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"UserHandle","fields":[{"name":"webService","required":false,"allowMultiple":false,"paramType":"int"},{"name":"handle","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"UserSettings","fields":[{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"bossURL","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"ApiTokenStatus","fields":[{"name":"token","required":false,"allowMultiple":false,"paramType":"string"},{"name":"expiresInMillis","required":false,"allowMultiple":false,"paramType":"long"},{"name":"totalRequests","required":false,"allowMultiple":false,"paramType":"long"},{"name":"remainingCalls","required":false,"allowMultiple":false,"paramType":"long"},{"name":"resetsInMillis","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"UserTrackingInfo","fields":[{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"noOfLogins","required":false,"allowMultiple":false,"paramType":"int"},{"name":"signupDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"signupIPAddress","required":false,"allowMultiple":false,"paramType":"string"},{"name":"lastUpdatedDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"lastLoginDate","required":false,"allowMultiple":false,"paramType":"Date"}]},{"name":"apiApplication","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"comment","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"userName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"approvalState","required":false,"allowMultiple":false,"paramType":"ApiApprovalState"}]},{"name":"AuthenticationToken","fields":[{"name":"token","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"userSignature","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"user","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"displayName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"status","required":false,"allowMultiple":false,"paramType":"int"},{"name":"password","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"email","required":false,"allowMultiple":false,"paramType":"string"},{"name":"faceBookId","required":false,"allowMultiple":false,"paramType":"string"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/api_docs/analytics.json

@@ -0,0 +1 @@
+{"resourcePath":"/analytics","models":{"wordHitsCollection":{"properties":{"wordHitsList":{"type":"array","required":false,"items":{"$ref":"wordHits","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"wordHitsCollection","type":"any","required":false,"uniqueItems":false},"wordHits":{"properties":{"timeMillis":{"type":"long","required":false,"uniqueItems":false}},"id":"wordHits","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/analytics.{format}/top","description":"","operations":[{"parameters":[{"name":"namespace","defaultValue":"site.word","description":"The namespace for which to return hits","required":false,"dataType":"string","allowableValues":["site.word"],"allowMultiple":false,"paramType":"query"},{"name":"year","description":"Year","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"month","description":"Month","required":false,"dataType":"string","allowableValues":["1","2","3","4","5","6","7","8","9","10","11","12"],"allowMultiple":false,"paramType":"query"},{"name":"week","description":"Week","required":false,"dataType":"string","allowableValues":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52"],"allowMultiple":false,"paramType":"query"},{"name":"day","description":"Day","required":false,"dataType":"string","allowableValues":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31"],"allowMultiple":false,"paramType":"query"},{"name":"hour","description":"Hour","required":false,"dataType":"string","allowableValues":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24"],"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Number of results to skip by","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"50","description":"Number of results to fetch","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns top hits over a year, month, week, day or hour","httpMethod":"GET","errorResponses":[{"reason":"Invalid time resolution specified","code":400}],"nickname":"getTopHits","responseClass":"wordHitsCollection","notes":"If no time resolution parameters are passed, it returns top hits for this week. To fetch top hits for a year, pass only the year. To fetch top hits for a month, pass (year and month). To fetch top hits for a week, pass (year and week). To fetch top hits for a day, pass (year, month and day). To fetch top hits for an hour, pass (year, month, day and hour)."}]},{"path":"/analytics.{format}/trending","description":"","operations":[{"parameters":[{"name":"namespace","defaultValue":"site.word","description":"The namespace for which to return hits","required":false,"dataType":"string","allowableValues":["site.word"],"allowMultiple":false,"paramType":"query"},{"name":"year","description":"Year","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"month","description":"Month","required":false,"dataType":"string","allowableValues":["1","2","3","4","5","6","7","8","9","10","11","12"],"allowMultiple":false,"paramType":"query"},{"name":"week","description":"Week","required":false,"dataType":"string","allowableValues":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52"],"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Number of results to skip by","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"50","description":"Number of results to fetch","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns words which were trending on a given week or month","httpMethod":"GET","errorResponses":[{"reason":"Invalid time resolution specified","code":400}],"nickname":"getTrendingHits","responseClass":"wordHitsCollection","notes":"If no time resolution parameters are passed, it returns trending hits for this week.\nTo fetch trending hits for a month, pass (year and month). To fetch trending hits for a week, pass (year and week)."}]},{"path":"/analytics.{format}/word/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"Word","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"namespace","defaultValue":"site.word","description":"The namespace for which to return hits","required":false,"dataType":"string","allowableValues":["site.word"],"allowMultiple":false,"paramType":"query"},{"name":"year","description":"Year","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"month","description":"Month","required":false,"dataType":"string","allowableValues":["1","2","3","4","5","6","7","8","9","10","11","12"],"allowMultiple":false,"paramType":"query"},{"name":"week","description":"Week","required":false,"dataType":"string","allowableValues":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44","45","46","47","48","49","50","51","52"],"allowMultiple":false,"paramType":"query"},{"name":"day","description":"Day","required":false,"dataType":"string","allowableValues":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31"],"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Number of results to skip by","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"50","description":"Number of results to fetch","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns hits a word received in a given year, month, week or day","httpMethod":"GET","errorResponses":[{"reason":"Invalid time resolution specified","code":400}],"nickname":"getWordHits","responseClass":"wordHitsCollection","notes":"If no time resolution parameters are passed, it returns hits the word received this week. To fetch word hits for a year, pass only the year. To fetch word hits for a month, pass (year and month). To fetch word hits for a week, pass (year and week). To fetch word hits for a day, pass (year, month and day)"}]}],"models1":[{"name":"wordHits","fields":[{"name":"timeMillis","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"wordHitsCollection","fields":[{"name":"wordHitsList","required":false,"wrapperName":"wordHitsList","allowMultiple":false,"paramType":"List[wordHits]"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/api_docs/corpus.json

@@ -1 +1 @@
-{"endPoints":[{"path":"/corpus.{format}/recentViews","description":"","operations":[{"parameters":[{"name":"limit","description":"Limits results","required":false,"dataType":"string","paramType":"query"},{"name":"humanOnly","description":"Returns results only from human visitors","required":false,"dataType":"string","paramType":"query"},{"name":"sortByFrequency","description":"Sorts results by frequency","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[wordResult]","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"RecentViews","summary":"Fetches recent views from the website.","suggestedName":"getRecentViews","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/corpus.{format}/words/{statsType}/{object}","description":"","operations":[{"parameters":[{"name":"statsType","description":"Stats type to fetch","required":false,"dataType":"string","paramType":"path"},{"name":"object","description":"Object identifier","required":false,"dataType":"string","paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[wordFrequency]","errorResponses":[{"reason":"Invalid dimension for WordFrequency data or Object Identifier not found.","code":400}],"condition":"any"}],"category":"Stats","summary":"Gets WordFrequency data","suggestedName":"getWordFrequencies","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/corpus.{format}/dictionaryStats","description":"","operations":[{"parameters":[{"name":"sourceDictionary","description":"Dictionary name to fetch stats for","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"dictionaryStats","errorResponses":[{"reason":"Invalid dictionary name supplied.","code":404}],"condition":"any"}],"category":"Stats","summary":"Gets Dictionary Statistics data","suggestedName":"getWordFrequencies","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/corpus.{format}/firstUsed","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[basicWordUsage]","errorResponses":[{"reason":"No data found for corpus.","code":404}],"condition":"any"}],"category":"Stats","summary":"Gets Dictionary Statistics data","suggestedName":"getWordFrequencies","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/corpus","description":"","operations":[{"response":[{"valueType":"doc","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Help","summary":"Returns information about API parameters","suggestedName":"getHelp","deprecated":false,"open":true,"httpMethod":"GET"}]},{"path":"/corpus.{format}/totalDocumentCount","description":"","operations":[{"response":[{"valueType":"long","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"CorpusCounters","summary":"Returns the count of documents in the Corpus.","suggestedName":"getTotalDocumentCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/corpus.{format}/processText","description":"","operations":[{"parameters":[{"description":"Text body to process.","required":false,"dataType":"string","paramType":"body"},{"name":"split","description":"Tells the processor to split multiple sentences from the input.  Default is true.","required":false,"dataType":"string","paramType":"query"},{"name":"rank","description":"Flag to invoke the ranking logic.  Default is false.","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"List[sentence]","errorResponses":[{"reason":"Invalid text supplied.","code":400}],"condition":"any"}],"category":"TextProcessing","summary":"Processes text input.","suggestedName":"processText","deprecated":false,"open":false,"notes":"Returns tagged and processed text based on the input string.","httpMethod":"POST"}]},{"path":"/corpus.{format}/punctuationFactor","description":"","operations":[{"response":[{"valueType":"punctuationFactor","errorResponses":[{"reason":"No data available.","code":404}],"condition":"any"}],"category":"TextProcessing","summary":"Returns corpus-wide PunctuationFactor.","suggestedName":"getPunctuationFactor","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/corpus.{format}/phraseFeedback","description":"","operations":[{"parameters":[{"description":"Phrase to store.","required":false,"dataType":"string","paramType":"body"}],"response":[{"valueType":"List[sentence]","errorResponses":[{"reason":"Invalid phrase supplied.","code":400}],"condition":"any"}],"category":"TextProcessing","summary":"Receives info on phrases which should be captured","suggestedName":"getPunctuationFactor","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/corpus.{format}/documentStats","description":"","operations":[{"parameters":[{"name":"documentStatsType","description":"Type of statistics to return","required":false,"dataType":"string","paramType":"query"},{"name":"id","description":"ID of statistics type to return.","required":false,"dataType":"string","paramType":"query"},{"name":"split","description":"Flag to invoke the ranking logic.  Default is false.","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"basicDocumentStats","errorResponses":[{"reason":"Invalid stats type supplied.","code":400}],"condition":"any"}],"category":"Stats","summary":"Returns document-level stats.","suggestedName":"getDocumentStats","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/corpus.{format}/words","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[wordFrequency]","errorResponses":[{"reason":"No corpus frequency data available.","code":400}],"condition":"any"}],"category":"Stats","summary":"Gets corpus-level WordFrequency","suggestedName":"getCorpusWordFrequencies","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/corpus.{format}/dymInternal/{wordstring}","description":"","operations":[{"parameters":[{"name":"wordstring","description":"Returns results only from human visitors","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"relationshipMap","errorResponses":[{"reason":"No data available.","code":404},{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"Unused","summary":"Returns word relationships.","suggestedName":"getDym","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/corpus.{format}/recentListedWords","description":"","operations":[{"parameters":[{"name":"limit","description":"Maximun results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[wordListingHistory]","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"RecentListedWords","summary":"Returns recently listed words.","suggestedName":"getRecentListedWords","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/corpus.{format}/contextualLookup","description":"","operations":[{"parameters":[{"name":"word","description":"Word of interest","required":false,"dataType":"string","paramType":"query"},{"name":"contextString","description":"Sentence word appears in","required":false,"dataType":"string","paramType":"query"},{"name":"title","description":"Word of interest","required":false,"dataType":"string","paramType":"query"},{"name":"metadataId","description":"Word of interest","required":false,"dataType":"string","paramType":"query"},{"name":"partnerId","description":"Partner Id","required":false,"dataType":"string","paramType":"query"},{"name":"sourceUrl","description":"Document source URL","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"contextualLookupResponse","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"ContextualLookup","summary":"Mock method to return Contextual Lookup info.","suggestedName":"getMockContextualLookupInfo","deprecated":false,"open":false,"notes":"Internal Only","httpMethod":"GET"},{"parameters":[{"name":"category","description":"Filters response by category","required":false,"dataType":"contextualLookupRequest","paramType":"query"}],"response":[{"valueType":"contextualLookupResponse","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"ContextualLookup","summary":"Fetches ContextualLookup info.","suggestedName":"getContextualLookupInfo","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/corpus.{format}/totalWordCount","description":"","operations":[{"response":[{"valueType":"long","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"CorpusCounters","summary":"Returns the count of tokens in the Corpus.","suggestedName":"getTotalTokensCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/corpus.{format}/sentenceCount","description":"","operations":[{"response":[{"valueType":"long","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"CorpusCounters","summary":"Returns the count of sentences in the Corpus.","suggestedName":"getTotalSentencesCount","deprecated":false,"open":false,"httpMethod":"GET"}]}],"models":[{"name":"sentence","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"scoredWord","required":false,"wrapperName":"scoredWords","paramType":"List[scoredWord]"},{"name":"display","required":false,"paramType":"string"},{"name":"documentMetadataId","required":false,"paramType":"long"},{"name":"rating","required":false,"paramType":"int"}]},{"name":"wordFrequency","fields":[{"name":"count","required":false,"paramType":"long"},{"name":"wordstring","required":false,"paramType":"string"}]},{"name":"error","fields":[{"name":"reason","required":false,"paramType":"string"},{"name":"code","required":false,"paramType":"int"}]},{"name":"relationshipMap","fields":[{"name":"sourceWordstring","required":false,"paramType":"string"},{"name":"suggestion","required":false,"wrapperName":"suggestions","paramType":"List[suggestion]"}]},{"name":"punctuationFactor","fields":[{"name":"totalCount","required":false,"paramType":"long"},{"name":"wordId","required":false,"paramType":"long"},{"name":"periodCount","required":false,"paramType":"long"},{"name":"exclamationPointCount","required":false,"paramType":"long"},{"name":"questionMarkCount","required":false,"paramType":"long"}]},{"name":"lookupExample","fields":[{"name":"uRL","required":false,"paramType":"string"},{"name":"sourceName","required":false,"paramType":"string"},{"name":"exampleString","required":false,"paramType":"string"}]},{"name":"long","fields":[{"name":"value","required":false,"paramType":"long"}]},{"name":"object","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"fields","required":false,"paramType":"List[parameter]"},{"name":"uniqueFieldName","required":false,"paramType":"string"}]},{"name":"basicWordUsage","fields":[{"name":"year","required":false,"paramType":"integer"},{"name":"wordstring","required":false,"paramType":"string"},{"name":"documentId","required":false,"paramType":"long"},{"name":"sentenceId","required":false,"paramType":"long"}]},{"name":"wordListingHistory","fields":[{"name":"wordString","required":false,"paramType":"string"},{"name":"wordId","required":false,"paramType":"long"},{"name":"listingCount","required":false,"paramType":"long"}]},{"name":"dictionaryStats","fields":[{"name":"dictionaryName","required":false,"paramType":"string"},{"name":"wordCount","required":false,"paramType":"int"},{"name":"defintionCount","required":false,"paramType":"int"},{"name":"exampleCount","required":false,"paramType":"int"},{"name":"textPronunciationCount","required":false,"paramType":"int"},{"name":"wordsWithRelationship","required":false,"paramType":"Map[string,integer]"},{"name":"relationshipLinks","required":false,"paramType":"Map[string,integer]"}]},{"name":"response","fields":[{"name":"valueType","required":false,"paramType":"string"},{"name":"errorResponses","required":false,"paramType":"List[error]"},{"name":"occurs","required":false,"paramType":"string"},{"name":"condition","required":false,"paramType":"string"}]},{"name":"parameter","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"defaultValue","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"required","required":false,"paramType":"boolean"},{"name":"dataType","required":false,"paramType":"string"},{"name":"allowableValues","required":false,"paramType":"string"},{"name":"wrapperName","required":false,"paramType":"string"},{"name":"internalDescription","required":false,"paramType":"string"},{"name":"paramAccess","required":false,"paramType":"string"},{"name":"paramType","required":false,"paramType":"string"}]},{"name":"wordResult","fields":[{"name":"count","required":false,"paramType":"long"},{"name":"wordstring","required":false,"paramType":"string"}]},{"name":"doc","fields":[{"name":"endPoints","required":false,"paramType":"List[endpoint]"},{"name":"models","required":false,"paramType":"List[object]"}]},{"name":"scoredWord","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"wordType","required":false,"paramType":"string"},{"name":"position","required":false,"paramType":"int"},{"name":"word","required":false,"paramType":"string"},{"name":"score","required":false,"paramType":"float"},{"name":"sentenceId","required":false,"paramType":"long"},{"name":"partOfSpeech","required":false,"paramType":"string"}]},{"name":"contextualLookupResponse","fields":[{"name":"examples","required":false,"wrapperName":"lookupExamples","paramType":"List[lookupExample]"},{"name":"wordstring","required":false,"paramType":"string"}]},{"name":"basicDocumentStats","fields":[{"name":"key","required":false,"paramType":"string"},{"name":"type","required":false,"paramType":"string"},{"name":"sentencesCount","required":false,"paramType":"long"},{"name":"documentsCount","required":false,"paramType":"long"},{"name":"tokensCount","required":false,"paramType":"long"},{"name":"uniqueWordsCount","required":false,"paramType":"long"},{"name":"wordsCount","required":false,"paramType":"long"},{"name":"firstUsedWordsCount","required":false,"paramType":"long"},{"name":"viableSentencesCount","required":false,"paramType":"long"},{"name":"uniqueBiGramsCount","required":false,"paramType":"long"}]},{"name":"suggestion","fields":[{"name":"type","required":false,"paramType":"int"},{"name":"wordstring","required":false,"paramType":"string"}]},{"name":"endpoint","fields":[{"name":"path","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"operations","required":false,"paramType":"List[operation]"}]},{"name":"operation","fields":[{"name":"parameters","required":false,"paramType":"List[parameter]"},{"name":"response","required":false,"paramType":"List[response]"},{"name":"category","required":false,"paramType":"string"},{"name":"summary","required":false,"paramType":"string"},{"name":"suggestedName","required":false,"paramType":"string"},{"name":"deprecated","required":false,"paramType":"boolean"},{"name":"open","required":false,"paramType":"boolean"},{"name":"notes","required":false,"paramType":"string"},{"name":"httpMethod","required":false,"paramType":"string"}]}]}
+{"resourcePath":"/corpus","models":{"wordView":{"properties":{"id":{"type":"long","required":true,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false}},"id":"wordView","type":"any","required":false,"uniqueItems":false},"basicWordUsage":{"properties":{"sentenceId":{"type":"long","required":false,"uniqueItems":false},"year":{"type":"integer","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false},"documentId":{"type":"long","required":false,"uniqueItems":false}},"id":"basicWordUsage","type":"any","required":false,"uniqueItems":false},"dictionaryStats":{"properties":{"dictionaryName":{"type":"string","required":false,"uniqueItems":false},"exampleCount":{"type":"int","required":false,"uniqueItems":false},"defintionCount":{"type":"int","required":false,"uniqueItems":false},"relationshipLinks":{"type":"Map[string,integer]","required":false,"uniqueItems":false},"textPronunciationCount":{"type":"int","required":false,"uniqueItems":false},"wordCount":{"type":"int","required":false,"uniqueItems":false},"wordsWithRelationship":{"type":"Map[string,integer]","required":false,"uniqueItems":false}},"id":"dictionaryStats","type":"any","required":false,"uniqueItems":false},"punctuationFactor":{"properties":{"periodCount":{"type":"long","required":false,"uniqueItems":false},"exclamationPointCount":{"type":"long","required":false,"uniqueItems":false},"wordId":{"type":"long","required":false,"uniqueItems":false},"questionMarkCount":{"type":"long","required":false,"uniqueItems":false},"totalCount":{"type":"long","required":false,"uniqueItems":false}},"id":"punctuationFactor","type":"any","required":false,"uniqueItems":false},"wordListingHistory":{"properties":{"wordId":{"type":"long","required":false,"uniqueItems":false},"listingCount":{"type":"long","required":false,"uniqueItems":false},"wordString":{"type":"string","required":false,"uniqueItems":false}},"id":"wordListingHistory","type":"any","required":false,"uniqueItems":false},"sentence":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"display":{"type":"string","required":false,"uniqueItems":false},"rating":{"type":"int","required":false,"uniqueItems":false},"documentMetadataId":{"type":"long","required":false,"uniqueItems":false},"scoredWord":{"type":"array","required":false,"items":{"$ref":"scoredWord","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"sentence","type":"any","required":false,"uniqueItems":false},"long":{"properties":{"value":{"type":"long","required":false,"uniqueItems":false}},"id":"long","type":"any","required":false,"uniqueItems":false},"basicDocumentStats":{"properties":{"uniqueBiGramsCount":{"type":"long","required":false,"uniqueItems":false},"wordsCount":{"type":"long","required":false,"uniqueItems":false},"documentsCount":{"type":"long","required":false,"uniqueItems":false},"firstUsedWordsCount":{"type":"long","required":false,"uniqueItems":false},"tokensCount":{"type":"long","required":false,"uniqueItems":false},"sentencesCount":{"type":"long","required":false,"uniqueItems":false},"viableSentencesCount":{"type":"long","required":false,"uniqueItems":false},"type":{"type":"string","required":false,"uniqueItems":false},"uniqueWordsCount":{"type":"long","required":false,"uniqueItems":false},"key":{"type":"string","required":false,"uniqueItems":false}},"id":"basicDocumentStats","type":"any","required":false,"uniqueItems":false},"scoredWord":{"properties":{"position":{"type":"int","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"wordType":{"type":"string","required":false,"uniqueItems":false},"score":{"type":"float","required":false,"uniqueItems":false},"sentenceId":{"type":"long","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"partOfSpeech":{"type":"string","required":false,"uniqueItems":false}},"id":"scoredWord","type":"any","required":false,"uniqueItems":false},"wordResult":{"properties":{"count":{"type":"long","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false}},"id":"wordResult","type":"any","required":false,"uniqueItems":false},"lookupExample":{"properties":{"sourceName":{"type":"string","required":false,"uniqueItems":false},"uRL":{"type":"string","required":false,"uniqueItems":false},"exampleString":{"type":"string","required":false,"uniqueItems":false}},"id":"lookupExample","type":"any","required":false,"uniqueItems":false},"suggestion":{"properties":{"type":{"type":"int","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false}},"id":"suggestion","type":"any","required":false,"uniqueItems":false},"contextualLookupResponse":{"properties":{"examples":{"type":"array","required":false,"items":{"$ref":"lookupExample","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false}},"id":"contextualLookupResponse","type":"any","required":false,"uniqueItems":false},"wordFrequency":{"properties":{"count":{"type":"long","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false}},"id":"wordFrequency","type":"any","required":false,"uniqueItems":false},"relationshipMap":{"properties":{"sourceWordstring":{"type":"string","required":false,"uniqueItems":false},"suggestion":{"type":"array","required":false,"items":{"$ref":"suggestion","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"relationshipMap","type":"any","required":false,"uniqueItems":false},"contextualLookupRequest":{"properties":{"partnerId":{"type":"string","required":false,"uniqueItems":false},"documentTitle":{"type":"string","required":false,"uniqueItems":false},"contextString":{"type":"string","required":false,"uniqueItems":false},"sourceUrl":{"type":"string","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false},"metadataId":{"type":"string","required":false,"uniqueItems":false}},"id":"contextualLookupRequest","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/corpus.{format}/recentViews","description":"","operations":[{"parameters":[{"name":"limit","description":"Limits results","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"humanOnly","description":"Returns results only from human visitors","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"sortByFrequency","description":"Sorts results by frequency","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches recent views from the website.","httpMethod":"GET","nickname":"getRecentViews","responseClass":"List[wordResult]"}]},{"path":"/corpus.{format}/words/{statsType}/{object}","description":"","operations":[{"parameters":[{"name":"statsType","description":"Stats type to fetch","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"object","description":"Object identifier","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Gets WordFrequency data","httpMethod":"GET","errorResponses":[{"reason":"Invalid dimension for WordFrequency data or Object Identifier not found.","code":400}],"nickname":"getWordFrequencies","responseClass":"List[wordFrequency]"}]},{"path":"/corpus.{format}/dictionaryStats","description":"","operations":[{"parameters":[{"name":"sourceDictionary","description":"Dictionary name to fetch stats for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Gets Dictionary Statistics data","httpMethod":"GET","errorResponses":[{"reason":"Invalid dictionary name supplied.","code":404}],"nickname":"getWordFrequencies","responseClass":"dictionaryStats"}]},{"path":"/corpus.{format}/firstUsed","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Gets Dictionary Statistics data","httpMethod":"GET","errorResponses":[{"reason":"No data found for corpus.","code":404}],"nickname":"getWordFrequencies","responseClass":"List[basicWordUsage]"}]},{"path":"/corpus.{format}/totalDocumentCount","description":"","operations":[{"summary":"Returns the count of documents in the Corpus.","httpMethod":"GET","nickname":"getTotalDocumentCount","responseClass":"long"}]},{"path":"/corpus.{format}/processText","description":"","operations":[{"parameters":[{"description":"Text body to process.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"body"},{"name":"split","description":"Tells the processor to split multiple sentences from the input.  Default is true.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"rank","description":"Flag to invoke the ranking logic.  Default is false.","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Processes text input.","httpMethod":"POST","errorResponses":[{"reason":"Invalid text supplied.","code":400}],"nickname":"processText","responseClass":"List[sentence]","notes":"Returns tagged and processed text based on the input string."}]},{"path":"/corpus.{format}/punctuationFactor","description":"","operations":[{"summary":"Returns corpus-wide PunctuationFactor.","httpMethod":"GET","errorResponses":[{"reason":"No data available.","code":404}],"nickname":"getPunctuationFactor","responseClass":"punctuationFactor"}]},{"path":"/corpus.{format}/phraseFeedback","description":"","operations":[{"parameters":[{"description":"Phrase to store.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Receives info on phrases which should be captured","httpMethod":"POST","errorResponses":[{"reason":"Invalid phrase supplied.","code":400}],"nickname":"getPunctuationFactor","responseClass":"List[sentence]"}]},{"path":"/corpus.{format}/documentStats","description":"","operations":[{"parameters":[{"name":"documentStatsType","description":"Type of statistics to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"id","description":"ID of statistics type to return.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"split","description":"Flag to invoke the ranking logic.  Default is false.","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns document-level stats.","httpMethod":"GET","errorResponses":[{"reason":"Invalid stats type supplied.","code":400}],"nickname":"getDocumentStats","responseClass":"basicDocumentStats"}]},{"path":"/corpus.{format}/words","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Gets corpus-level WordFrequency","httpMethod":"GET","errorResponses":[{"reason":"No corpus frequency data available.","code":400}],"nickname":"getCorpusWordFrequencies","responseClass":"List[wordFrequency]"}]},{"path":"/corpus.{format}/dymInternal/{wordstring}","description":"","operations":[{"parameters":[{"name":"wordstring","description":"Returns results only from human visitors","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns word relationships.","httpMethod":"GET","errorResponses":[{"reason":"No data available.","code":404},{"reason":"Invalid word supplied.","code":400}],"nickname":"getDym","responseClass":"relationshipMap"}]},{"path":"/corpus.{format}/recentListedWords","description":"","operations":[{"parameters":[{"name":"limit","description":"Maximun results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns recently listed words.","httpMethod":"GET","nickname":"getRecentListedWords","responseClass":"List[wordListingHistory]"}]},{"path":"/corpus.{format}/views","description":"","operations":[{"parameters":[{"name":"word","description":"Filter by word","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"userId","description":"filter by user id","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"userGuid","description":"Filter by user guid","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"sessionId","description":"Filter by user session id","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"callingClass","description":"Filter by calling class","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"method","description":"Filter by calling method","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"environment","description":"Deployment environment to find results from","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"serverIp","description":"Server IP to query from","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"createdAfter","description":"Date to find results after","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches views from the website.","httpMethod":"GET","nickname":"getViews","responseClass":"List[wordView]"}]},{"path":"/corpus.{format}/contextualLookup","description":"","operations":[{"parameters":[{"name":"word","description":"Word of interest","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"contextString","description":"Sentence word appears in","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"title","description":"Word of interest","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"metadataId","description":"Word of interest","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"partnerId","description":"Partner Id","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"sourceUrl","description":"Document source URL","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Mock method to return Contextual Lookup info.","httpMethod":"GET","nickname":"getMockContextualLookupInfo","responseClass":"contextualLookupResponse","notes":"Internal Only"},{"parameters":[{"name":"category","description":"Filters response by category","required":false,"dataType":"contextualLookupRequest","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches ContextualLookup info.","httpMethod":"POST","nickname":"getContextualLookupInfo","responseClass":"contextualLookupResponse"}]},{"path":"/corpus.{format}/totalWordCount","description":"","operations":[{"summary":"Returns the count of tokens in the Corpus.","httpMethod":"GET","nickname":"getTotalTokensCount","responseClass":"long"}]},{"path":"/corpus.{format}/sentenceCount","description":"","operations":[{"summary":"Returns the count of sentences in the Corpus.","httpMethod":"GET","nickname":"getTotalSentencesCount","responseClass":"long"}]}],"models1":[{"name":"sentence","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"scoredWord","required":false,"wrapperName":"scoredWords","allowMultiple":false,"paramType":"List[scoredWord]"},{"name":"display","required":false,"allowMultiple":false,"paramType":"string"},{"name":"documentMetadataId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"rating","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"wordFrequency","fields":[{"name":"count","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"contextualLookupRequest","fields":[{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"sourceUrl","required":false,"allowMultiple":false,"paramType":"string"},{"name":"contextString","required":false,"allowMultiple":false,"paramType":"string"},{"name":"metadataId","required":false,"allowMultiple":false,"paramType":"string"},{"name":"partnerId","required":false,"allowMultiple":false,"paramType":"string"},{"name":"documentTitle","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"relationshipMap","fields":[{"name":"sourceWordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"suggestion","required":false,"wrapperName":"suggestions","allowMultiple":false,"paramType":"List[suggestion]"}]},{"name":"punctuationFactor","fields":[{"name":"totalCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"periodCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"exclamationPointCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"questionMarkCount","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"long","fields":[{"name":"value","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"lookupExample","fields":[{"name":"uRL","required":false,"allowMultiple":false,"paramType":"string"},{"name":"sourceName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"exampleString","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"wordView","fields":[{"name":"id","required":true,"allowMultiple":false,"paramType":"long"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"basicWordUsage","fields":[{"name":"year","required":false,"allowMultiple":false,"paramType":"integer"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"documentId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"sentenceId","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"wordListingHistory","fields":[{"name":"wordString","required":false,"allowMultiple":false,"paramType":"string"},{"name":"wordId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"listingCount","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"dictionaryStats","fields":[{"name":"defintionCount","required":false,"allowMultiple":false,"paramType":"int"},{"name":"textPronunciationCount","required":false,"allowMultiple":false,"paramType":"int"},{"name":"exampleCount","required":false,"allowMultiple":false,"paramType":"int"},{"name":"dictionaryName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"wordCount","required":false,"allowMultiple":false,"paramType":"int"},{"name":"wordsWithRelationship","required":false,"allowMultiple":false,"paramType":"Map[string,integer]"},{"name":"relationshipLinks","required":false,"allowMultiple":false,"paramType":"Map[string,integer]"}]},{"name":"wordResult","fields":[{"name":"count","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"scoredWord","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordType","required":false,"allowMultiple":false,"paramType":"string"},{"name":"position","required":false,"allowMultiple":false,"paramType":"int"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"score","required":false,"allowMultiple":false,"paramType":"float"},{"name":"sentenceId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"partOfSpeech","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"contextualLookupResponse","fields":[{"name":"examples","required":false,"wrapperName":"lookupExamples","allowMultiple":false,"paramType":"List[lookupExample]"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"suggestion","fields":[{"name":"type","required":false,"allowMultiple":false,"paramType":"int"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"basicDocumentStats","fields":[{"name":"key","required":false,"allowMultiple":false,"paramType":"string"},{"name":"type","required":false,"allowMultiple":false,"paramType":"string"},{"name":"sentencesCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"uniqueWordsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"documentsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"tokensCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"firstUsedWordsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"viableSentencesCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"uniqueBiGramsCount","required":false,"allowMultiple":false,"paramType":"long"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/api_docs/document.json

@@ -1 +1 @@
-{"endPoints":[{"path":"/document.{format}/id/{document_id}/words","description":"","operations":[{"parameters":[{"name":"document_id","description":"Document ID to fetch frequency data for","required":false,"dataType":"string","paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[wordFrequency]","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":400},{"reason":"No activation code available.","code":404}],"condition":"any"}],"category":"DocumentAccess","summary":"Fetches Document objects by Content Provider code.","suggestedName":"getWordFrequencies","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/document.{format}/{contentProvider}/documents","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code to fetch for.","required":false,"dataType":"string","paramType":"path"},{"name":"filterByWordScore","description":"Filter document model by word scores.","required":false,"dataType":"string","paramType":"query"},{"name":"minWordScore","description":"Minimum word score to return.","required":false,"dataType":"string","paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[documentModel]","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"condition":"any"}],"category":"DocumentAccess","summary":"Fetches examples for a specific provider matching a criteria.","suggestedName":"getGlossaries","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/document","description":"","operations":[{"response":[{"valueType":"doc","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Help","summary":"Returns information about API parameters","suggestedName":"getHelp","deprecated":false,"open":true,"httpMethod":"GET"}]},{"path":"/document.{format}/provider/{provider}","description":"","operations":[{"parameters":[{"name":"provider","description":"Username","required":false,"dataType":"string","paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[documentMetadata]","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":400},{"reason":"No activation code available.","code":404}],"condition":"any"}],"category":"DocumentAccess","summary":"Fetches Document objects by Content Provider code.","suggestedName":"getDocumentsByContentProvider","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/document.{format}/{id}/metadata","description":"","operations":[{"parameters":[{"name":"id","description":"Document ID","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"documentMetadata","errorResponses":[{"reason":"Invalid document ID supplied.","code":400},{"reason":"No activation code available.","code":404}],"condition":"any"}],"category":"DocumentAccess","summary":"Fetches Document objects by document identifier.","suggestedName":"getMetadataById","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/document.{format}/{id}/model","description":"","operations":[{"parameters":[{"name":"scores","description":"Return word scores","required":false,"dataType":"string","paramType":"query"},{"name":"id","description":"Document ID","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"documentModel","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":400},{"reason":"No activation code available.","code":404}],"condition":"any"}],"category":"DocumentAccess","summary":"Fetches Document objects by id.","suggestedName":"getModelById","deprecated":false,"open":false,"httpMethod":"GET"}]}],"models":[{"name":"wordFrequency","fields":[{"name":"count","required":false,"paramType":"long"},{"name":"wordstring","required":false,"paramType":"string"}]},{"name":"sentence","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"scoredWord","required":false,"wrapperName":"scoredWords","paramType":"List[scoredWord]"},{"name":"display","required":false,"paramType":"string"},{"name":"documentMetadataId","required":false,"paramType":"long"},{"name":"rating","required":false,"paramType":"int"}]},{"name":"extendedMetadata","fields":[{"name":"documentMetadataId","required":false,"paramType":"long"},{"name":"isbn","required":false,"paramType":"string"},{"name":"issn","required":false,"paramType":"string"},{"name":"lccn","required":false,"paramType":"string"},{"name":"sourceFileSize","required":false,"paramType":"long"}]},{"name":"error","fields":[{"name":"reason","required":false,"paramType":"string"},{"name":"code","required":false,"paramType":"int"}]},{"name":"documentModel","fields":[{"name":"documentMetadata","required":false,"paramType":"documentMetadata"},{"name":"basicDocumentStats","required":false,"paramType":"basicDocumentStats"},{"name":"wordFrequency","required":false,"wrapperName":"wordFrequencies","paramType":"List[wordFrequency]"},{"name":"sentence","required":false,"wrapperName":"sentences","paramType":"List[sentence]"},{"name":"biGramFrequency","required":false,"wrapperName":"bigramFrequencies","paramType":"List[biGramFrequency]"}]},{"name":"biGramFrequency","fields":[{"name":"count","required":false,"paramType":"long"},{"name":"mi","required":false,"paramType":"double"},{"name":"wlmi","required":false,"paramType":"double"},{"name":"bigram","required":false,"paramType":"bigram"}]},{"name":"author","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"long"},{"name":"description","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"authorType","required":false,"paramType":"authorType"},{"name":"uniqueName","required":false,"paramType":"string"}]},{"name":"contentType","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"object","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"fields","required":false,"paramType":"List[parameter]"},{"name":"uniqueFieldName","required":false,"paramType":"string"}]},{"name":"bigram","fields":[{"name":"count","required":false,"paramType":"long"},{"name":"gram1","required":false,"paramType":"string"},{"name":"gram2","required":false,"paramType":"string"},{"name":"mi","required":false,"paramType":"double"},{"name":"wlmi","required":false,"paramType":"double"}]},{"name":"yearType","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"documentMetadata","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"year","required":false,"paramType":"integer"},{"name":"contentType","required":false,"paramType":"contentType"},{"name":"provider","required":false,"paramType":"contentProvider"},{"name":"tag","required":false,"wrapperName":"tags","paramType":"List[string]"},{"name":"title","required":false,"paramType":"string"},{"name":"rating","required":false,"paramType":"double"},{"name":"medium","required":false,"paramType":"documentMedium"},{"name":"sourceUrl","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"stats","required":false,"paramType":"basicDocumentStats"},{"name":"date","required":false,"paramType":"Date"},{"name":"classification","required":false,"paramType":"subjectClassificationType"},{"name":"yearType","required":false,"paramType":"yearType"},{"name":"primaryAuthor","required":false,"paramType":"string"},{"name":"primaryAuthorType","required":false,"paramType":"authorType"},{"name":"primaryAuthorId","required":false,"paramType":"long"},{"name":"guid","required":false,"paramType":"string"},{"name":"extendedMetadata","required":false,"paramType":"extendedMetadata"},{"name":"author","required":false,"wrapperName":"authors","paramType":"List[author]"},{"name":"expirationDate","required":false,"paramType":"Date"}]},{"name":"documentMedium","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"subjectClassificationType","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"response","fields":[{"name":"valueType","required":false,"paramType":"string"},{"name":"errorResponses","required":false,"paramType":"List[error]"},{"name":"occurs","required":false,"paramType":"string"},{"name":"condition","required":false,"paramType":"string"}]},{"name":"parameter","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"defaultValue","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"required","required":false,"paramType":"boolean"},{"name":"dataType","required":false,"paramType":"string"},{"name":"allowableValues","required":false,"paramType":"string"},{"name":"wrapperName","required":false,"paramType":"string"},{"name":"internalDescription","required":false,"paramType":"string"},{"name":"paramAccess","required":false,"paramType":"string"},{"name":"paramType","required":false,"paramType":"string"}]},{"name":"contentProvider","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"authorType","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"doc","fields":[{"name":"endPoints","required":false,"paramType":"List[endpoint]"},{"name":"models","required":false,"paramType":"List[object]"}]},{"name":"scoredWord","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"wordType","required":false,"paramType":"string"},{"name":"position","required":false,"paramType":"int"},{"name":"word","required":false,"paramType":"string"},{"name":"score","required":false,"paramType":"float"},{"name":"sentenceId","required":false,"paramType":"long"},{"name":"partOfSpeech","required":false,"paramType":"string"}]},{"name":"basicDocumentStats","fields":[{"name":"key","required":false,"paramType":"string"},{"name":"type","required":false,"paramType":"string"},{"name":"sentencesCount","required":false,"paramType":"long"},{"name":"documentsCount","required":false,"paramType":"long"},{"name":"tokensCount","required":false,"paramType":"long"},{"name":"uniqueWordsCount","required":false,"paramType":"long"},{"name":"wordsCount","required":false,"paramType":"long"},{"name":"firstUsedWordsCount","required":false,"paramType":"long"},{"name":"viableSentencesCount","required":false,"paramType":"long"},{"name":"uniqueBiGramsCount","required":false,"paramType":"long"}]},{"name":"endpoint","fields":[{"name":"path","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"operations","required":false,"paramType":"List[operation]"}]},{"name":"operation","fields":[{"name":"parameters","required":false,"paramType":"List[parameter]"},{"name":"response","required":false,"paramType":"List[response]"},{"name":"category","required":false,"paramType":"string"},{"name":"summary","required":false,"paramType":"string"},{"name":"suggestedName","required":false,"paramType":"string"},{"name":"deprecated","required":false,"paramType":"boolean"},{"name":"open","required":false,"paramType":"boolean"},{"name":"notes","required":false,"paramType":"string"},{"name":"httpMethod","required":false,"paramType":"string"}]}]}
+{"resourcePath":"/document","models":{"authorType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"authorType","type":"any","required":false,"uniqueItems":false},"yearType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"yearType","type":"any","required":false,"uniqueItems":false},"documentModel":{"properties":{"biGramFrequency":{"type":"array","required":false,"items":{"$ref":"biGramFrequency","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"sentence":{"type":"array","required":false,"items":{"$ref":"sentence","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"wordFrequency":{"type":"array","required":false,"items":{"$ref":"wordFrequency","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"documentMetadata":{"type":"documentMetadata","required":false,"uniqueItems":false},"basicDocumentStats":{"type":"basicDocumentStats","required":false,"uniqueItems":false}},"id":"documentModel","type":"any","required":false,"uniqueItems":false},"extendedMetadata":{"properties":{"sourceFileSize":{"type":"long","required":false,"uniqueItems":false},"issn":{"type":"string","required":false,"uniqueItems":false},"isbn":{"type":"string","required":false,"uniqueItems":false},"lccn":{"type":"string","required":false,"uniqueItems":false},"documentMetadataId":{"type":"long","required":false,"uniqueItems":false}},"id":"extendedMetadata","type":"any","required":false,"uniqueItems":false},"subjectClassificationType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"subjectClassificationType","type":"any","required":false,"uniqueItems":false},"sentence":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"display":{"type":"string","required":false,"uniqueItems":false},"rating":{"type":"int","required":false,"uniqueItems":false},"documentMetadataId":{"type":"long","required":false,"uniqueItems":false},"scoredWord":{"type":"array","required":false,"items":{"$ref":"scoredWord","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"sentence","type":"any","required":false,"uniqueItems":false},"documentMedium":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"documentMedium","type":"any","required":false,"uniqueItems":false},"contentType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"contentType","type":"any","required":false,"uniqueItems":false},"documentMetadata":{"properties":{"yearType":{"type":"yearType","required":false,"uniqueItems":false},"expirationDate":{"type":"Date","required":false,"uniqueItems":false},"extendedMetadata":{"type":"extendedMetadata","required":false,"uniqueItems":false},"stats":{"type":"basicDocumentStats","required":false,"uniqueItems":false},"tag":{"type":"array","required":false,"items":{"type":"string","required":false,"uniqueItems":false},"uniqueItems":false},"provider":{"type":"contentProvider","required":false,"uniqueItems":false},"contentType":{"type":"contentType","required":false,"uniqueItems":false},"sourceUrl":{"type":"string","required":false,"uniqueItems":false},"date":{"type":"Date","required":false,"uniqueItems":false},"medium":{"type":"documentMedium","required":false,"uniqueItems":false},"guid":{"type":"string","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"author":{"type":"array","required":false,"items":{"$ref":"author","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"title":{"type":"string","required":false,"uniqueItems":false},"primaryAuthorType":{"type":"authorType","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"classification":{"type":"subjectClassificationType","required":false,"uniqueItems":false},"year":{"type":"integer","required":false,"uniqueItems":false},"primaryAuthor":{"type":"string","required":false,"uniqueItems":false},"rating":{"type":"double","required":false,"uniqueItems":false},"primaryAuthorId":{"type":"long","required":false,"uniqueItems":false}},"id":"documentMetadata","type":"any","required":false,"uniqueItems":false},"basicDocumentStats":{"properties":{"uniqueBiGramsCount":{"type":"long","required":false,"uniqueItems":false},"wordsCount":{"type":"long","required":false,"uniqueItems":false},"documentsCount":{"type":"long","required":false,"uniqueItems":false},"firstUsedWordsCount":{"type":"long","required":false,"uniqueItems":false},"tokensCount":{"type":"long","required":false,"uniqueItems":false},"sentencesCount":{"type":"long","required":false,"uniqueItems":false},"viableSentencesCount":{"type":"long","required":false,"uniqueItems":false},"type":{"type":"string","required":false,"uniqueItems":false},"uniqueWordsCount":{"type":"long","required":false,"uniqueItems":false},"key":{"type":"string","required":false,"uniqueItems":false}},"id":"basicDocumentStats","type":"any","required":false,"uniqueItems":false},"scoredWord":{"properties":{"position":{"type":"int","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"wordType":{"type":"string","required":false,"uniqueItems":false},"score":{"type":"float","required":false,"uniqueItems":false},"sentenceId":{"type":"long","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"partOfSpeech":{"type":"string","required":false,"uniqueItems":false}},"id":"scoredWord","type":"any","required":false,"uniqueItems":false},"author":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"authorType":{"type":"authorType","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false},"uniqueName":{"type":"string","required":false,"uniqueItems":false}},"id":"author","type":"any","required":false,"uniqueItems":false},"bigram":{"properties":{"count":{"type":"long","required":false,"uniqueItems":false},"gram2":{"type":"string","required":false,"uniqueItems":false},"gram1":{"type":"string","required":false,"uniqueItems":false},"wlmi":{"type":"double","required":false,"uniqueItems":false},"mi":{"type":"double","required":false,"uniqueItems":false}},"id":"bigram","type":"any","required":false,"uniqueItems":false},"biGramFrequency":{"properties":{"count":{"type":"long","required":false,"uniqueItems":false},"bigram":{"type":"bigram","required":false,"uniqueItems":false},"wlmi":{"type":"double","required":false,"uniqueItems":false},"mi":{"type":"double","required":false,"uniqueItems":false}},"id":"biGramFrequency","type":"any","required":false,"uniqueItems":false},"contentProvider":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"contentProvider","type":"any","required":false,"uniqueItems":false},"wordFrequency":{"properties":{"count":{"type":"long","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false}},"id":"wordFrequency","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/document.{format}/id/{document_id}/words","description":"","operations":[{"parameters":[{"name":"document_id","description":"Document ID to fetch frequency data for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches Document objects by Content Provider code.","httpMethod":"GET","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getWordFrequencies","responseClass":"List[wordFrequency]"}]},{"path":"/document.{format}/{contentProvider}/documents","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code to fetch for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"filterByWordScore","description":"Filter document model by word scores.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"minWordScore","description":"Minimum word score to return.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches examples for a specific provider matching a criteria.","httpMethod":"GET","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"nickname":"getGlossaries","responseClass":"List[documentModel]"}]},{"path":"/document.{format}/provider/{provider}","description":"","operations":[{"parameters":[{"name":"provider","description":"Content provider","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches Document objects by Content Provider code.","httpMethod":"GET","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getDocumentsByContentProvider","responseClass":"List[documentMetadata]"}]},{"path":"/document.{format}/{id}/metadata","description":"","operations":[{"parameters":[{"name":"id","description":"Document ID","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches Document objects by document identifier.","httpMethod":"GET","errorResponses":[{"reason":"Invalid document ID supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getMetadataById","responseClass":"documentMetadata"}]},{"path":"/document.{format}/{id}/model","description":"","operations":[{"parameters":[{"name":"scores","description":"Return word scores","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"id","description":"Document ID","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches Document objects by id.","httpMethod":"GET","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getModelById","responseClass":"documentModel"}]}],"models1":[{"name":"wordFrequency","fields":[{"name":"count","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"sentence","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"scoredWord","required":false,"wrapperName":"scoredWords","allowMultiple":false,"paramType":"List[scoredWord]"},{"name":"display","required":false,"allowMultiple":false,"paramType":"string"},{"name":"documentMetadataId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"rating","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"extendedMetadata","fields":[{"name":"documentMetadataId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"isbn","required":false,"allowMultiple":false,"paramType":"string"},{"name":"issn","required":false,"allowMultiple":false,"paramType":"string"},{"name":"lccn","required":false,"allowMultiple":false,"paramType":"string"},{"name":"sourceFileSize","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"documentModel","fields":[{"name":"documentMetadata","required":false,"allowMultiple":false,"paramType":"documentMetadata"},{"name":"basicDocumentStats","required":false,"allowMultiple":false,"paramType":"basicDocumentStats"},{"name":"wordFrequency","required":false,"wrapperName":"wordFrequencies","allowMultiple":false,"paramType":"List[wordFrequency]"},{"name":"sentence","required":false,"wrapperName":"sentences","allowMultiple":false,"paramType":"List[sentence]"},{"name":"biGramFrequency","required":false,"wrapperName":"bigramFrequencies","allowMultiple":false,"paramType":"List[biGramFrequency]"}]},{"name":"biGramFrequency","fields":[{"name":"count","required":false,"allowMultiple":false,"paramType":"long"},{"name":"mi","required":false,"allowMultiple":false,"paramType":"double"},{"name":"wlmi","required":false,"allowMultiple":false,"paramType":"double"},{"name":"bigram","required":false,"allowMultiple":false,"paramType":"bigram"}]},{"name":"author","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"authorType","required":false,"allowMultiple":false,"paramType":"authorType"},{"name":"uniqueName","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"contentType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"bigram","fields":[{"name":"count","required":false,"allowMultiple":false,"paramType":"long"},{"name":"gram1","required":false,"allowMultiple":false,"paramType":"string"},{"name":"gram2","required":false,"allowMultiple":false,"paramType":"string"},{"name":"mi","required":false,"allowMultiple":false,"paramType":"double"},{"name":"wlmi","required":false,"allowMultiple":false,"paramType":"double"}]},{"name":"yearType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"documentMetadata","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"year","required":false,"allowMultiple":false,"paramType":"integer"},{"name":"contentType","required":false,"allowMultiple":false,"paramType":"contentType"},{"name":"provider","required":false,"allowMultiple":false,"paramType":"contentProvider"},{"name":"tag","required":false,"wrapperName":"tags","allowMultiple":false,"paramType":"List[string]"},{"name":"title","required":false,"allowMultiple":false,"paramType":"string"},{"name":"rating","required":false,"allowMultiple":false,"paramType":"double"},{"name":"medium","required":false,"allowMultiple":false,"paramType":"documentMedium"},{"name":"sourceUrl","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"classification","required":false,"allowMultiple":false,"paramType":"subjectClassificationType"},{"name":"date","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"yearType","required":false,"allowMultiple":false,"paramType":"yearType"},{"name":"primaryAuthor","required":false,"allowMultiple":false,"paramType":"string"},{"name":"primaryAuthorType","required":false,"allowMultiple":false,"paramType":"authorType"},{"name":"primaryAuthorId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"guid","required":false,"allowMultiple":false,"paramType":"string"},{"name":"extendedMetadata","required":false,"allowMultiple":false,"paramType":"extendedMetadata"},{"name":"author","required":false,"wrapperName":"authors","allowMultiple":false,"paramType":"List[author]"},{"name":"expirationDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"stats","required":false,"allowMultiple":false,"paramType":"basicDocumentStats"}]},{"name":"documentMedium","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"subjectClassificationType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"contentProvider","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"authorType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"scoredWord","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordType","required":false,"allowMultiple":false,"paramType":"string"},{"name":"position","required":false,"allowMultiple":false,"paramType":"int"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"score","required":false,"allowMultiple":false,"paramType":"float"},{"name":"sentenceId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"partOfSpeech","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"basicDocumentStats","fields":[{"name":"key","required":false,"allowMultiple":false,"paramType":"string"},{"name":"type","required":false,"allowMultiple":false,"paramType":"string"},{"name":"sentencesCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"uniqueWordsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"documentsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"tokensCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"firstUsedWordsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"viableSentencesCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"uniqueBiGramsCount","required":false,"allowMultiple":false,"paramType":"long"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/api_docs/partner.json

@@ -0,0 +1 @@
+{"resourcePath":"/partner","models":{"glossaryStatus":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"glossaryStatus","type":"any","required":false,"uniqueItems":false},"GlossaryEntry":{"properties":{"title":{"type":"string","required":false,"uniqueItems":false},"noteType":{"type":"string","required":false,"uniqueItems":false},"example":{"type":"string","required":false,"uniqueItems":false},"glossaryId":{"type":"long","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false},"note":{"type":"string","required":false,"uniqueItems":false},"url":{"type":"string","required":false,"uniqueItems":false}},"id":"GlossaryEntry","type":"any","required":false,"uniqueItems":false},"Glossary":{"properties":{"updatedAt":{"type":"Date","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"permalinkId":{"type":"string","required":false,"uniqueItems":false},"status":{"type":"glossaryStatus","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"contentProvider":{"type":"contentProvider","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false},"totalEntries":{"type":"int","required":false,"uniqueItems":false},"publishedDate":{"type":"Date","required":false,"uniqueItems":false},"version":{"type":"double","required":false,"uniqueItems":false}},"id":"Glossary","type":"any","required":false,"uniqueItems":false},"contentProvider":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"contentProvider","type":"any","required":false,"uniqueItems":false},"documentModelSearchResults":{"properties":{"author":{"type":"string","required":false,"uniqueItems":false},"title":{"type":"string","required":false,"uniqueItems":false},"sentences":{"type":"array","required":false,"items":{"type":"string","required":false,"uniqueItems":false},"uniqueItems":false},"date":{"type":"string","required":false,"uniqueItems":false},"url":{"type":"string","required":false,"uniqueItems":false}},"id":"documentModelSearchResults","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/partner.{format}/{id}/result","description":"","operations":[{"parameters":[{"name":"id","description":"Document ID","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"searchTerms","description":"Comma separated search terms","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches model search results.","httpMethod":"GET","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"nickname":"getResults","responseClass":"List[documentModelSearchResults]"}]},{"path":"/partner.{format}/glossaries","description":"","operations":[{"parameters":[{"name":"includeDrafts","description":"Includes unpublished Glossaries","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches glossaries for the specified Provider.","httpMethod":"GET","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"nickname":"getGlossaries","responseClass":"List[Glossary]"}]},{"path":"/partner.{format}/glossary/{permalink}","description":"","operations":[{"parameters":[{"name":"permalink","description":"Permalink of Glossary to fetch.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"version","description":"Version to fetch","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches a glossary by permalink.","httpMethod":"GET","errorResponses":[{"reason":"Not authorized.","code":403},{"reason":"Invalid ID supplied.","code":404}],"nickname":"getGlossary","responseClass":"Glossary"}]},{"path":"/partner.{format}/{word}/related","description":"","operations":[{"parameters":[{"name":"word","description":"Word to find related items for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"type","description":"Related Type","required":false,"dataType":"string","allowableValues":["person"," location"," organization"],"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns weighted terms related to the input word","httpMethod":"GET","errorResponses":[{"reason":"No data found.","code":404}],"nickname":"getRelatedWords","responseClass":"relatedWord"}]},{"path":"/partner.{format}/glossary/{permalink}/entries","description":"","operations":[{"parameters":[{"name":"permalink","description":"Permalink of Glossary.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"startsWith","description":"Word pattern to fetch with.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches GlossaryEntry objects for the specified Glossary.","httpMethod":"GET","errorResponses":[{"reason":"Not authorized.","code":403},{"reason":"Invalid ID supplied.","code":404}],"nickname":"getGlossaryEntries","responseClass":"List[GlossaryEntry]"}]}],"models1":[{"name":"contentProvider","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"Glossary","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"version","required":false,"allowMultiple":false,"paramType":"double"},{"name":"status","required":false,"allowMultiple":false,"paramType":"glossaryStatus"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"permalinkId","required":false,"allowMultiple":false,"paramType":"string"},{"name":"contentProvider","required":false,"allowMultiple":false,"paramType":"contentProvider"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"publishedDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"updatedAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"totalEntries","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"documentModelSearchResults","fields":[{"name":"date","required":false,"allowMultiple":false,"paramType":"string"},{"name":"url","required":false,"allowMultiple":false,"paramType":"string"},{"name":"sentences","required":false,"allowMultiple":false,"paramType":"List[string]"},{"name":"title","required":false,"allowMultiple":false,"paramType":"string"},{"name":"author","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"GlossaryEntry","fields":[{"name":"url","required":false,"allowMultiple":false,"paramType":"string"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"example","required":false,"allowMultiple":false,"paramType":"string"},{"name":"title","required":false,"allowMultiple":false,"paramType":"string"},{"name":"note","required":false,"allowMultiple":false,"paramType":"string"},{"name":"glossaryId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"noteType","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"glossaryStatus","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/api_docs/partners.json

@@ -1 +1 @@
-{"endPoints":[{"path":"/partners.{format}/{contentProvider}/glossaries","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code to create for.","required":false,"dataType":"string","paramType":"path"},{"description":"Glossary to create","required":false,"dataType":"Glossary","paramType":"body"}],"response":[{"valueType":"Glossary","errorResponses":[{"reason":"Invalid Glossary supplied.","code":400},{"reason":"Invalid Content Provider code supplied.","code":404}],"condition":"any"}],"category":"PartnersGlossary","summary":"Creates a glossary for the Content Provider.","suggestedName":"createGlossary","deprecated":false,"open":false,"httpMethod":"POST"},{"parameters":[{"name":"contentProvider","description":"Partner Code to fetch for.","required":false,"dataType":"string","paramType":"path"},{"name":"includeDrafts","description":"Includes unpublished Glossaries","required":false,"dataType":"string","paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[Glossary]","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"condition":"any"}],"category":"PartnersGlossary","summary":"Fetches glossaries for the specified Provider.","suggestedName":"getGlossaries","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/partners.{format}/{contentProvider}/glossary/{permalinkId}","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code to fetch for.","required":false,"dataType":"string","paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary to fetch.","required":false,"dataType":"string","paramType":"path"},{"name":"version","description":"Version to fetch","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"Glossary","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"condition":"any"}],"category":"PartnersGlossary","summary":"Fetches a glossary for the specified Provider.","suggestedName":"getGlossary","deprecated":false,"open":false,"httpMethod":"GET"},{"parameters":[{"name":"contentProvider","description":"Partner Code to update for.","required":false,"dataType":"string","paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary to fetch.","required":false,"dataType":"string","paramType":"path"},{"name":"version","description":"Version to fetch","required":false,"dataType":"string","paramType":"query"},{"description":"Updated Glossary","required":false,"dataType":"Glossary","paramType":"body"}],"response":[{"valueType":"Glossary","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"condition":"any"}],"category":"PartnersGlossary","summary":"Updates a Glossaryfor the specified Provider.","suggestedName":"updateGlossary","deprecated":false,"open":false,"httpMethod":"PUT"},{"parameters":[{"name":"contentProvider","description":"Partner Code to delete for.","required":false,"dataType":"string","paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary to delete.","required":false,"dataType":"string","paramType":"path"},{"name":"version","description":"Version to delete","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"condition":"any"}],"category":"PartnersGlossary","summary":"Deletes a single Glossary.","suggestedName":"deleteGlossary","deprecated":false,"open":false,"httpMethod":"DELETE"}]},{"path":"/partners","description":"","operations":[{"response":[{"valueType":"doc","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Help","summary":"Returns information about API parameters","suggestedName":"getHelp","deprecated":false,"open":true,"httpMethod":"GET"}]},{"path":"/partners.{format}/{contentProvider}/glossary/{permalinkId}/entries","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code to fetch for.","required":false,"dataType":"string","paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary.","required":false,"dataType":"string","paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","paramType":"query"},{"name":"startsWith","description":"Word pattern to fetch with.","required":false,"dataType":"string","paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[GlossaryEntry]","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"condition":"any"}],"category":"PartnersGlossary","summary":"Fetches GlossaryEntry objects for the specified Glossary.","suggestedName":"getGlossaryEntries","deprecated":false,"open":false,"httpMethod":"GET"},{"parameters":[{"name":"contentProvider","description":"Partner Code to add to.","required":false,"dataType":"string","paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary.","required":false,"dataType":"string","paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","paramType":"query"},{"description":"Glossary Entries to add","required":false,"dataType":"GlossaryEntry[]","paramType":"body"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"condition":"any"}],"category":"PartnersGlossary","summary":"Adds GlossaryEntry objects for the specified Glossary.","suggestedName":"addGlossaryEntry","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/partners.{format}/{contentProvider}/glossary/{permalinkId}/publish","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code for Glossary.","required":false,"dataType":"string","paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary to publish.","required":false,"dataType":"string","paramType":"path"},{"name":"version","description":"Version to publish.","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid Content Provider code","code":400},{"reason":"Invalid Permalink ID supplied.","code":404}],"condition":"any"}],"category":"PartnersGlossary","summary":"Publishes a Glossary.","suggestedName":"publishGlossary","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/partners.{format}/{contentProvider}/glossary/{permalinkId}/clone","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code for Glossary.","required":false,"dataType":"string","paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary to version.","required":false,"dataType":"string","paramType":"path"},{"name":"version","description":"New version number to assign.","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"Glossary","errorResponses":[{"reason":"Invalid Content Provider code","code":400},{"reason":"Invalid Permalink ID supplied.","code":404}],"condition":"any"}],"category":"PartnersGlossary","summary":"Creates a new version of a Glossary.","suggestedName":"createVersion","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/partners.{format}/{contentProvider}/glossary/{permalinkId}/entries/{word}","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code to delete from.","required":false,"dataType":"string","paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary.","required":false,"dataType":"string","paramType":"path"},{"name":"word","description":"Word to remove.","required":false,"dataType":"string","paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid word being removed.","code":400},{"reason":"Invalid Content Provider code supplied.","code":404}],"condition":"any"}],"category":"PartnersGlossary","summary":"Removes a GlossaryEntry object from the specified Glossary.","suggestedName":"deleteGlossaryEntry","deprecated":false,"open":false,"httpMethod":"DELETE"}]},{"path":"/partners.{format}/{contentProvider}/glossary/{permalinkId}/deleteEntries","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code to delete from.","required":false,"dataType":"string","paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary.","required":false,"dataType":"string","paramType":"path"},{"description":"Words to remove.","required":false,"dataType":"StringValue[]","paramType":"body"},{"name":"version","description":"Specific Glossary version to remove Entries from","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid word being removed.","code":400},{"reason":"Invalid Content Provider code supplied.","code":404}],"condition":"any"}],"category":"PartnersGlossary","summary":"Removes a GlossaryEntry object from the specified Glossary.","suggestedName":"deleteGlossaryEntries","deprecated":false,"open":false,"httpMethod":"POST"}]}],"models":[{"name":"error","fields":[{"name":"reason","required":false,"paramType":"string"},{"name":"code","required":false,"paramType":"int"}]},{"name":"response","fields":[{"name":"valueType","required":false,"paramType":"string"},{"name":"errorResponses","required":false,"paramType":"List[error]"},{"name":"occurs","required":false,"paramType":"string"},{"name":"condition","required":false,"paramType":"string"}]},{"name":"parameter","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"defaultValue","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"required","required":false,"paramType":"boolean"},{"name":"dataType","required":false,"paramType":"string"},{"name":"allowableValues","required":false,"paramType":"string"},{"name":"wrapperName","required":false,"paramType":"string"},{"name":"internalDescription","required":false,"paramType":"string"},{"name":"paramAccess","required":false,"paramType":"string"},{"name":"paramType","required":false,"paramType":"string"}]},{"name":"contentProvider","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"Glossary","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"long"},{"name":"version","required":false,"paramType":"double"},{"name":"status","required":false,"paramType":"glossaryStatus"},{"name":"description","required":false,"paramType":"string"},{"name":"permalinkId","required":false,"paramType":"string"},{"name":"contentProvider","required":false,"paramType":"contentProvider"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"publishedDate","required":false,"paramType":"Date"},{"name":"updatedAt","required":false,"paramType":"Date"},{"name":"totalEntries","required":false,"paramType":"int"}]},{"name":"doc","fields":[{"name":"endPoints","required":false,"paramType":"List[endpoint]"},{"name":"models","required":false,"paramType":"List[object]"}]},{"name":"object","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"fields","required":false,"paramType":"List[parameter]"},{"name":"uniqueFieldName","required":false,"paramType":"string"}]},{"name":"GlossaryEntry","fields":[{"name":"url","required":false,"paramType":"string"},{"name":"wordstring","required":false,"paramType":"string"},{"name":"example","required":false,"paramType":"string"},{"name":"title","required":false,"paramType":"string"},{"name":"note","required":false,"paramType":"string"},{"name":"glossaryId","required":false,"paramType":"long"},{"name":"noteType","required":false,"paramType":"string"}]},{"name":"endpoint","fields":[{"name":"path","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"operations","required":false,"paramType":"List[operation]"}]},{"name":"operation","fields":[{"name":"parameters","required":false,"paramType":"List[parameter]"},{"name":"response","required":false,"paramType":"List[response]"},{"name":"category","required":false,"paramType":"string"},{"name":"summary","required":false,"paramType":"string"},{"name":"suggestedName","required":false,"paramType":"string"},{"name":"deprecated","required":false,"paramType":"boolean"},{"name":"open","required":false,"paramType":"boolean"},{"name":"notes","required":false,"paramType":"string"},{"name":"httpMethod","required":false,"paramType":"string"}]},{"name":"glossaryStatus","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]}]}
+{"resourcePath":"/partners","models":{"glossaryStatus":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"glossaryStatus","type":"any","required":false,"uniqueItems":false},"GlossaryEntry":{"properties":{"title":{"type":"string","required":false,"uniqueItems":false},"noteType":{"type":"string","required":false,"uniqueItems":false},"example":{"type":"string","required":false,"uniqueItems":false},"glossaryId":{"type":"long","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false},"note":{"type":"string","required":false,"uniqueItems":false},"url":{"type":"string","required":false,"uniqueItems":false}},"id":"GlossaryEntry","type":"any","required":false,"uniqueItems":false},"Glossary":{"properties":{"updatedAt":{"type":"Date","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"permalinkId":{"type":"string","required":false,"uniqueItems":false},"status":{"type":"glossaryStatus","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"contentProvider":{"type":"contentProvider","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false},"totalEntries":{"type":"int","required":false,"uniqueItems":false},"publishedDate":{"type":"Date","required":false,"uniqueItems":false},"version":{"type":"double","required":false,"uniqueItems":false}},"id":"Glossary","type":"any","required":false,"uniqueItems":false},"contentProvider":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"contentProvider","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/partners.{format}/{contentProvider}/glossaries","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code to create for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Glossary to create","required":false,"dataType":"Glossary","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Creates a glossary for the Content Provider.","httpMethod":"POST","errorResponses":[{"reason":"Invalid Glossary supplied.","code":400},{"reason":"Invalid Content Provider code supplied.","code":404}],"nickname":"createGlossary","responseClass":"Glossary"},{"parameters":[{"name":"contentProvider","description":"Partner Code to fetch for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"includeDrafts","description":"Includes unpublished Glossaries","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches glossaries for the specified Provider.","httpMethod":"GET","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"nickname":"getGlossaries","responseClass":"List[Glossary]"}]},{"path":"/partners.{format}/{contentProvider}/glossary/{permalinkId}","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code to fetch for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary to fetch.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"version","description":"Version to fetch","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches a glossary for the specified Provider.","httpMethod":"GET","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"nickname":"getGlossary","responseClass":"Glossary"},{"parameters":[{"name":"contentProvider","description":"Partner Code to update for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary to fetch.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"version","description":"Version to fetch","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"description":"Updated Glossary","required":false,"dataType":"Glossary","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Updates a Glossaryfor the specified Provider.","httpMethod":"PUT","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"nickname":"updateGlossary","responseClass":"Glossary"},{"parameters":[{"name":"contentProvider","description":"Partner Code to delete for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary to delete.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"version","description":"Version to delete","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Deletes a single Glossary.","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"nickname":"deleteGlossary","responseClass":"ok"}]},{"path":"/partners.{format}/{contentProvider}/glossary/{permalinkId}/entries","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code to fetch for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"startsWith","description":"Word pattern to fetch with.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches GlossaryEntry objects for the specified Glossary.","httpMethod":"GET","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"nickname":"getGlossaryEntries","responseClass":"List[GlossaryEntry]"},{"parameters":[{"name":"contentProvider","description":"Partner Code to add to.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"description":"Glossary Entries to add","required":false,"dataType":"GlossaryEntry[]","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Adds GlossaryEntry objects for the specified Glossary.","httpMethod":"POST","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"nickname":"addGlossaryEntry","responseClass":"ok"}]},{"path":"/partners.{format}/{contentProvider}/glossary/{permalinkId}/publish","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code for Glossary.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary to publish.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"version","description":"Version to publish.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Publishes a Glossary.","httpMethod":"POST","errorResponses":[{"reason":"Invalid Content Provider code","code":400},{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"publishGlossary","responseClass":"ok"}]},{"path":"/partners.{format}/{contentProvider}/glossary/{permalinkId}/clone","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code for Glossary.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary to version.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"version","description":"New version number to assign.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Creates a new version of a Glossary.","httpMethod":"POST","errorResponses":[{"reason":"Invalid Content Provider code","code":400},{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"createVersion","responseClass":"Glossary"}]},{"path":"/partners.{format}/{contentProvider}/glossary/{permalinkId}/entries/{word}","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code to delete from.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"word","description":"Word to remove.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Removes a GlossaryEntry object from the specified Glossary.","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid word being removed.","code":400},{"reason":"Invalid Content Provider code supplied.","code":404}],"nickname":"deleteGlossaryEntry","responseClass":"ok"}]},{"path":"/partners.{format}/{contentProvider}/glossary/{permalinkId}/deleteEntries","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code to delete from.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"permalinkId","description":"Permalink of Glossary.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Words to remove.","required":false,"dataType":"StringValue[]","allowableValues":[],"allowMultiple":false,"paramType":"body"},{"name":"version","description":"Specific Glossary version to remove Entries from","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Removes a GlossaryEntry object from the specified Glossary.","httpMethod":"POST","errorResponses":[{"reason":"Invalid word being removed.","code":400},{"reason":"Invalid Content Provider code supplied.","code":404}],"nickname":"deleteGlossaryEntries","responseClass":"ok"}]}],"models1":[{"name":"contentProvider","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"Glossary","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"version","required":false,"allowMultiple":false,"paramType":"double"},{"name":"status","required":false,"allowMultiple":false,"paramType":"glossaryStatus"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"permalinkId","required":false,"allowMultiple":false,"paramType":"string"},{"name":"contentProvider","required":false,"allowMultiple":false,"paramType":"contentProvider"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"publishedDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"updatedAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"totalEntries","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"GlossaryEntry","fields":[{"name":"url","required":false,"allowMultiple":false,"paramType":"string"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"example","required":false,"allowMultiple":false,"paramType":"string"},{"name":"title","required":false,"allowMultiple":false,"paramType":"string"},{"name":"note","required":false,"allowMultiple":false,"paramType":"string"},{"name":"glossaryId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"noteType","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"glossaryStatus","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/api_docs/suggest.json

@@ -0,0 +1 @@
+{"resourcePath":"/suggest","models":{"searchResult":{"properties":{"matches":{"type":"int","required":false,"uniqueItems":false},"more":{"type":"int","required":false,"uniqueItems":false},"searchTerm":{"type":"wordResult","required":false,"uniqueItems":false},"match":{"type":"array","required":false,"items":{"$ref":"wordResult","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"searchResult","type":"any","required":false,"uniqueItems":false},"wordResult":{"properties":{"count":{"type":"long","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false}},"id":"wordResult","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/suggest.{format}/tags/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"Word fragment to use.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns Word strings based on the input.","httpMethod":"GET","errorResponses":[{"reason":"Invalid Word Fragment supplied.","code":400}],"nickname":"getTagSuggestions","responseClass":"searchResult"}]}],"models1":[{"name":"wordResult","fields":[{"name":"count","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"searchResult","fields":[{"name":"matches","required":false,"allowMultiple":false,"paramType":"int"},{"name":"match","required":false,"allowMultiple":false,"paramType":"List[wordResult]"},{"name":"searchTerm","required":false,"allowMultiple":false,"paramType":"wordResult"},{"name":"more","required":false,"allowMultiple":false,"paramType":"int"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/api_docs/system.json

@@ -0,0 +1 @@
+{"resourcePath":"/system","models":{"contentProvider":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"contentProvider","type":"any","required":false,"uniqueItems":false},"word":{"properties":{"numericProperties":{"type":"Map[string,double]","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"stringProperties":{"type":"Map[string,string]","required":false,"uniqueItems":false}},"id":"word","type":"any","required":false,"uniqueItems":false},"wordStats":{"properties":{"wordsListedCount":{"type":"long","required":false,"uniqueItems":false},"externalApiCallsCount":{"type":"long","required":false,"uniqueItems":false},"favoritesCount":{"type":"long","required":false,"uniqueItems":false},"wordViewCount":{"type":"long","required":false,"uniqueItems":false},"tokensCount":{"type":"long","required":false,"uniqueItems":false},"sentencesCount":{"type":"long","required":false,"uniqueItems":false},"apiUsersCount":{"type":"long","required":false,"uniqueItems":false},"commentsCount":{"type":"long","required":false,"uniqueItems":false},"audioPronsCount":{"type":"long","required":false,"uniqueItems":false},"listsCount":{"type":"long","required":false,"uniqueItems":false},"documentsCount":{"type":"long","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"elapsedMillis":{"type":"long","required":false,"uniqueItems":false},"userLoginCount":{"type":"long","required":false,"uniqueItems":false},"prettyWordsCount":{"type":"long","required":false,"uniqueItems":false},"usersCount":{"type":"long","required":false,"uniqueItems":false},"taggedObjectsCount":{"type":"long","required":false,"uniqueItems":false},"uniqueWordsCount":{"type":"long","required":false,"uniqueItems":false},"tagsCount":{"type":"long","required":false,"uniqueItems":false}},"id":"wordStats","type":"any","required":false,"uniqueItems":false},"long":{"properties":{"value":{"type":"long","required":false,"uniqueItems":false}},"id":"long","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/system.{format}/providers","description":"","operations":[{"summary":"Returns all defined ContentProviders.","httpMethod":"GET","nickname":"getProviders","responseClass":"List[contentProvider]"}]},{"path":"/system.{format}/stats","description":"","operations":[{"parameters":[{"name":"skip","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"delta","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns system-wide statistics for the platform.","httpMethod":"GET","nickname":"getStats","responseClass":"List[wordStats]"}]},{"path":"/system.{format}/{word}/related","description":"","operations":[{"parameters":[{"name":"word","description":"Word to find related items for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"type","description":"Relationship type","required":false,"dataType":"string","allowableValues":["synonym","antonym","variant","equivalent","cross-reference","related-word","rhyme","form","etymologically-related-term","hypernym","hyponym","inflected-form","primary","same-context","verb-form","verb-stem","unknown"],"allowMultiple":false,"paramType":"query"}],"summary":"Returns weighted terms related to the input word","httpMethod":"GET","errorResponses":[{"reason":"No data found.","code":404}],"nickname":"getRelatedWords","responseClass":"relatedWord"}]},{"path":"/system.{format}/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to find attributes for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"useLiteral","description":"Use exact word","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns a word with attributes","httpMethod":"GET","errorResponses":[{"reason":"No data found.","code":404}],"nickname":"getRelatedWords","responseClass":"word"}]},{"path":"/system.{format}/graph","description":"","operations":[{"parameters":[{"name":"term","description":"Term to query","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"objectType","description":"Object type","required":false,"dataType":"string","allowableValues":["word"],"allowMultiple":false,"paramType":"query"},{"name":"excludeEdgeTypes","description":"Relationships to exclude","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"includeEdgeTypes","description":"Specifies the only relationship to include (note, this overrides the exclusions)","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"startConstraints","description":"Edge start constraints to enforce","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"endConstraints","description":"Edge end constraints to enforce","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"maxHops","defaultValue":"2","description":"Maximum number of to route","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"maxResults","defaultValue":"2","description":"Maximum number of routes to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"destination","description":"Destination to route to (VERY inefficient)","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"useGraphML","description":"Return is GraphML format","required":false,"dataType":"string","allowableValues":["true","false"],"allowMultiple":false,"paramType":"query"},{"name":"goal","description":"Selection goal","required":false,"dataType":"string","allowableValues":["content","similar","basic-form"],"allowMultiple":false,"paramType":"query"}],"summary":"Returns a graph response for the supplied terms","httpMethod":"GET","errorResponses":[{"reason":"Invalid query.","code":400},{"reason":"No data found.","code":404}],"nickname":"getWordById","responseClass":"com.wordnik.graph.RouteResponse"}]},{"path":"/system.{format}/audioRecordId","description":"","operations":[{"summary":"Gets an Audio File ID for recording.","httpMethod":"GET","nickname":"getAudioRecordId","responseClass":"long"}]},{"path":"/system.{format}/audioDuration","description":"","operations":[{"parameters":[{"name":"audioFileId","description":"Audio file id","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"duration","description":"Audio duration","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Sets duration of an Audio File","httpMethod":"POST","errorResponses":[{"reason":"Invalid audio file id supplied.","code":400}],"nickname":"setAudioDuration","responseClass":"ok"}]}],"models1":[{"name":"wordStats","fields":[{"name":"sentencesCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"uniqueWordsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"apiUsersCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"audioPronsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"commentsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"documentsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"externalApiCallsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"favoritesCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"listsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"userLoginCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"prettyWordsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"taggedObjectsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"tagsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"tokensCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordsListedCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordViewCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"usersCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"elapsedMillis","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"contentProvider","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"word","fields":[{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"stringProperties","required":false,"allowMultiple":false,"paramType":"Map[string,string]"},{"name":"numericProperties","required":false,"allowMultiple":false,"paramType":"Map[string,double]"}]},{"name":"long","fields":[{"name":"value","required":false,"allowMultiple":false,"paramType":"long"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/api_docs/tag.json

@@ -1 +1 @@
-{"endPoints":[{"path":"/tag","description":"","operations":[{"response":[{"valueType":"doc","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Help","summary":"Returns information about API parameters","suggestedName":"getHelp","deprecated":false,"open":true,"httpMethod":"GET"}]},{"path":"/tag.{format}/{tag}/word","description":"","operations":[{"parameters":[{"name":"tag","description":"Tag to fetch words for","required":false,"dataType":"string","paramType":"path"},{"name":"userName","description":"Username to restrict results to","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[wordObject]","errorResponses":[{"reason":"Invalid Tag supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"condition":"any"}],"category":"Words","summary":"Fetches Words with a specific Tag.","suggestedName":"getWordsTagged","deprecated":false,"open":false,"httpMethod":"GET"}]}],"models":[{"name":"error","fields":[{"name":"reason","required":false,"paramType":"string"},{"name":"code","required":false,"paramType":"int"}]},{"name":"wordObject","fields":[{"name":"word","required":false,"paramType":"string"},{"name":"vulgar","required":false,"paramType":"string"}]},{"name":"response","fields":[{"name":"valueType","required":false,"paramType":"string"},{"name":"errorResponses","required":false,"paramType":"List[error]"},{"name":"occurs","required":false,"paramType":"string"},{"name":"condition","required":false,"paramType":"string"}]},{"name":"parameter","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"defaultValue","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"required","required":false,"paramType":"boolean"},{"name":"dataType","required":false,"paramType":"string"},{"name":"allowableValues","required":false,"paramType":"string"},{"name":"wrapperName","required":false,"paramType":"string"},{"name":"internalDescription","required":false,"paramType":"string"},{"name":"paramAccess","required":false,"paramType":"string"},{"name":"paramType","required":false,"paramType":"string"}]},{"name":"doc","fields":[{"name":"endPoints","required":false,"paramType":"List[endpoint]"},{"name":"models","required":false,"paramType":"List[object]"}]},{"name":"object","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"fields","required":false,"paramType":"List[parameter]"},{"name":"uniqueFieldName","required":false,"paramType":"string"}]},{"name":"endpoint","fields":[{"name":"path","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"operations","required":false,"paramType":"List[operation]"}]},{"name":"operation","fields":[{"name":"parameters","required":false,"paramType":"List[parameter]"},{"name":"response","required":false,"paramType":"List[response]"},{"name":"category","required":false,"paramType":"string"},{"name":"summary","required":false,"paramType":"string"},{"name":"suggestedName","required":false,"paramType":"string"},{"name":"deprecated","required":false,"paramType":"boolean"},{"name":"open","required":false,"paramType":"boolean"},{"name":"notes","required":false,"paramType":"string"},{"name":"httpMethod","required":false,"paramType":"string"}]}]}
+{"resourcePath":"/tag","models":{"wordObject":{"properties":{"word":{"type":"string","required":false,"uniqueItems":false},"vulgar":{"type":"string","required":false,"uniqueItems":false}},"id":"wordObject","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/tag.{format}/{tag}/word","description":"","operations":[{"parameters":[{"name":"tag","description":"Tag to fetch words for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"userName","description":"Username to restrict results to","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches Words with a specific Tag.","httpMethod":"GET","errorResponses":[{"reason":"Invalid Tag supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getWordsTagged","responseClass":"List[wordObject]"}]}],"models1":[{"name":"wordObject","fields":[{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"vulgar","required":false,"allowMultiple":false,"paramType":"string"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/api_docs/user.json

@@ -1 +1 @@
-{"endPoints":[{"path":"/user.{format}/{username}/wordOfTheDayList","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","paramType":"path"},{"name":"includeAll","description":"Include future words (owner-only)","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"wordOfTheDayList","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"No WordOfTheDayList available","code":404}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Returns a user's WordOfTheDayList","suggestedName":"getWordOfTheDayList","deprecated":false,"open":false,"httpMethod":"GET"},{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","paramType":"path"},{"description":"WordOfTheDayList to create, provided in the format specified by the URL","required":true,"dataType":"wordOfTheDayList","paramType":"body"}],"response":[{"valueType":"wordOfTheDayList","errorResponses":[{"reason":"User already has a list or list is invalid","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Creates a WordOfTheDayList","suggestedName":"createWordOfTheDayList","deprecated":false,"open":false,"notes":"A user can have only one WordOfTheDayList.","httpMethod":"POST"},{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","paramType":"path"},{"description":"Updated WordOfTheDayList data in the format specified by the URL","required":true,"dataType":"wordOfTheDayList","paramType":"body"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"Not authorized to perform update","code":403},{"reason":"No WordOfTheDayList available","code":404}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Updates a user's WordOfTheDayList","suggestedName":"updateWordOfTheDayList","deprecated":false,"open":false,"httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/wordOfTheDayList/{permalink}","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","paramType":"path"},{"name":"permalink","description":"Permalink of WordOfTheDayList to delete","required":true,"dataType":"string","paramType":"path"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"Not authorized to perform update","code":403},{"reason":"No WordOfTheDayList available","code":404}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Deletes a user's WordOfTheDayList","suggestedName":"updateWordOfTheDayList","deprecated":false,"open":false,"httpMethod":"DELETE"},{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","paramType":"path"},{"name":"permalink","description":"Permalink of the WordOfTheDayList to add the WordOfTheDay to","required":true,"dataType":"string","paramType":"path"},{"description":"WordOfTheDay to add, in the format specified by the URL","required":true,"dataType":"WordOfTheDay","paramType":"body"}],"response":[{"valueType":"void","errorResponses":[{"reason":"WordOfTheDay already scheduled on this date","code":400},{"reason":"Not authorized to perform modification","code":403},{"reason":"No WordOfTheDayList available to add to","code":404}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Adds a WordOfTheDay to a user's WordOfTheDayList","suggestedName":"updateItemInWordOfTheDayList","deprecated":false,"open":false,"httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/profile","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch profile for.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"UserProfile","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UserInfo","summary":"Returns a UserProfile","suggestedName":"getUserProfile","deprecated":false,"open":false,"httpMethod":"GET"},{"parameters":[{"name":"username","description":"Username to fetch profile for.","required":false,"dataType":"string","paramType":"path"},{"description":"Updated UserProfile.","required":false,"dataType":"UserProfile","paramType":"body"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UserInfo","summary":"Updates a UserProfile","suggestedName":"updateUserProfile","deprecated":false,"open":false,"httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/trackingInfo","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch tracking info for.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"UserTrackingInfo","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UserInfo","summary":"Returns a user's tracking info","suggestedName":"getUserTrackingInfo","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"Username to update.","required":false,"dataType":"string","paramType":"path"},{"description":"Updated User object.","required":false,"dataType":"user","paramType":"body"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid username supplied or username/email already in use.","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UserInfo","summary":"Updates a User","suggestedName":"updateUser","deprecated":false,"open":false,"httpMethod":"PUT"},{"parameters":[{"name":"username","description":"Username to get.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"user","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UserInfo","summary":"Fetches a User","suggestedName":"getUser","deprecated":false,"open":false,"httpMethod":"GET"},{"parameters":[{"name":"username","description":"Username to update.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid username supplied or username/email already in use.","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UserInfo","summary":"Deletes a User","suggestedName":"deleteUser","deprecated":false,"open":false,"httpMethod":"DELETE"}]},{"path":"/user.{format}/{username}/wordOfTheDayList/{permalink}/add","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","paramType":"path"},{"name":"permalink","description":"WordOfTheDayList to modify","required":true,"dataType":"string","paramType":"path"},{"description":"WordOfTheDay to add","required":true,"dataType":"WordOfTheDay","paramType":"body"}],"response":[{"valueType":"void","errorResponses":[{"reason":"WordOfTheDay already scheduled on this date","code":400},{"reason":"Not authorized to perform modification","code":403},{"reason":"No WordOfTheDayList available to add to","code":404}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Adds an item to a user's WordOfTheDayList","suggestedName":"addWordToWordOfTheDayList","deprecated":false,"open":false,"httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/wordOfTheDayList/{permalink}/{wordToDelete}","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","paramType":"path"},{"name":"permalink","description":"Permalink of WordOfTheDayList to delete a word from","required":true,"dataType":"string","paramType":"path"},{"name":"wordToDelete","description":"Word to delete","required":true,"dataType":"string","paramType":"path"}],"response":[{"valueType":"void","errorResponses":[{"reason":"WordOfTheDay already scheduled on this date","code":400},{"reason":"Not authorized to perform modification","code":403},{"reason":"No WordOfTheDayList available to add to","code":404}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Deletes a specific word from a user's WordOfTheDayList","suggestedName":"deleteWordFromWordOfTheDayList","deprecated":false,"open":false,"httpMethod":"DELETE"}]},{"path":"/user.{format}/{username}/wordOfTheDay/{date}","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDay owner","required":true,"dataType":"string","paramType":"path"},{"name":"date","description":"Date of the WordOfTheDay to retrieve (yyyy-MM-dd) format","required":true,"dataType":"string","paramType":"path"},{"name":"includeAll","description":"Include WordOfTheDay items for future dates (owner-only)","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"WordOfTheDay","errorResponses":[{"reason":"Invalid username or dateString supplied","code":400},{"reason":"User not found or no list available","code":404}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Returns the WordOfTheDay for a given user on a given date","suggestedName":"getWordOfTheDayByDate","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{username}/wordLists","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch WordLists for.","required":false,"dataType":"string","paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"},{"name":"sortBy","defaultValue":"createDate","description":"Field to sort by","required":false,"dataType":"string","allowableValues":"alpha,createDate,editDate","paramType":"query"},{"name":"sortOrder","defaultValue":"desc","description":"Direction to sort","required":false,"dataType":"string","allowableValues":"asc,desc","paramType":"query"}],"response":[{"valueType":"List[wordList]","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UserWordLists","summary":"Gets WordLists for a User.","suggestedName":"getUserWordLists","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{username}/wordListsCount","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch WordLists for.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UserWordLists","summary":"Gets the count of WordLists for a User.","suggestedName":"getUserWordListCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{username}/settings","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch settings for.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"UserSettings","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UserInfo","summary":"Returns a user's settings","suggestedName":"getUserSettings","deprecated":false,"open":false,"httpMethod":"GET"},{"parameters":[{"name":"username","description":"Username to fetch profile for.","required":false,"dataType":"string","paramType":"path"},{"description":"Updated UserSettings.","required":false,"dataType":"UserSettings","paramType":"body"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UserInfo","summary":"Updates a user's settings","suggestedName":"updateUserSettings","deprecated":false,"open":false,"httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/apiKey","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch api key for.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"Principal","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404},{"reason":"API key not found","code":409}],"condition":"any"}],"category":"UserInfo","summary":"Returns the API key for the specified user","suggestedName":"getApiKeyForUser","deprecated":false,"open":false,"notes":"Use the super user API key for getting this information or auth token of the user who is requesting the API key","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/comment","description":"","operations":[{"parameters":[{"name":"username","description":"Username to comment on.","required":false,"dataType":"string","paramType":"path"},{"description":"Comment to save.","required":false,"dataType":"comment","paramType":"body"}],"response":[{"valueType":"comment","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UgcInfo","summary":"Adds a Comment on a User","suggestedName":"commentOnUser","deprecated":false,"open":false,"httpMethod":"POST"},{"parameters":[{"name":"username","description":"Username with Comment.","required":false,"dataType":"string","paramType":"path"},{"description":"Updated Comment.","required":false,"dataType":"comment","paramType":"body"}],"response":[{"valueType":"comment","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UgcInfo","summary":"Updates a Comment on a User","suggestedName":"updateCommentOnUser","deprecated":false,"open":false,"httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/comment/{commentId}","description":"","operations":[{"parameters":[{"name":"username","description":"Username with Comment.","required":false,"dataType":"string","paramType":"path"},{"name":"commentId","description":"Updated Comment.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UgcInfo","summary":"Deletes a Comment on a User","suggestedName":"deleteCommentOnUser","deprecated":false,"open":false,"httpMethod":"DELETE"},{"parameters":[{"name":"username","description":"Username with Comment.","required":false,"dataType":"string","paramType":"path"},{"name":"commentId","description":"Comment ID.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"comment","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UgcInfo","summary":"Fetches a comment by ID","suggestedName":"getCommentOnUserById","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{username}/commentsOnCount","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count for.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UgcInfo","summary":"Returns a count of Comments on a user","suggestedName":"getCommentsOnUserCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{username}/commentsByCount","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count by.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UgcInfo","summary":"Returns a count of Comments by a user","suggestedName":"getCommentsByUserCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{username}/commentsBy","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count by.","required":false,"dataType":"string","paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"},{"name":"sortOrder","description":"Sort order","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[comment]","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UgcInfo","summary":"Returns Comments by a user","suggestedName":"getCommentsByUser","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{username}/commentsOnUser","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count by.","required":false,"dataType":"string","paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"},{"name":"sortOrder","description":"Sort order","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[comment]","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UgcInfo","summary":"Returns Comments on a user","suggestedName":"getCommentsOnUser","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{username}/ugcSummary","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get statistics for.","required":false,"dataType":"string","paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"},{"name":"sortOrder","description":"Sort order","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"UgcSummary","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"condition":"any"}],"category":"UgcInfo","summary":"Returns UgcSummary info a user","suggestedName":"getUgcSummaryForUser","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{user}/tagHistory","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch History for","required":false,"dataType":"string","paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[userTagHistory]","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"condition":"any"}],"category":"Tags","summary":"Fetches TagHistory for a User.","suggestedName":"getUserTagHistory","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{user}/tags","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Tags for","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"List[tag]","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"condition":"any"}],"category":"Tags","summary":"Fetches Tags by a User.","suggestedName":"getUserTags","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{user}/tagCount","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Tag count for","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"condition":"any"}],"category":"Tags","summary":"Fetches the count of Tags created by a User.","suggestedName":"getUserTagCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{user}/subscriptions","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch subscriptions for","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"List[SubscriptionType]","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"Not authorized to fetch subscriptions.","code":403},{"reason":"User not found.","code":404}],"condition":"any"}],"category":"Subscriptions","summary":"Fetches all subscriptions for a User.","suggestedName":"getSubscriptions","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{user}/subscriptions/{objectType}/{objectIdentifier}","description":"","operations":[{"parameters":[{"name":"user","description":"User to add subscriptions to","required":false,"dataType":"string","paramType":"path"},{"name":"objectType","description":"Object Type","required":false,"dataType":"string","paramType":"path"},{"name":"objectIdentifier","description":"Object Identifier","required":false,"dataType":"string","paramType":"path"},{"name":"medium","description":"Subscription medium","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"Not authorized to subscribe user to WordOfTheDayList.","code":403},{"reason":"User not found to filter by.","code":404}],"condition":"any"}],"category":"Subscriptions","summary":"Subscribes to an object.","suggestedName":"addSubscription","deprecated":false,"open":false,"httpMethod":"POST"},{"parameters":[{"name":"user","description":"User to add subscriptions to","required":false,"dataType":"string","paramType":"path"},{"name":"objectType","description":"Object Type","required":false,"dataType":"string","paramType":"path"},{"name":"objectIdentifier","description":"Object Identifier","required":false,"dataType":"string","paramType":"path"},{"name":"medium","description":"Subscription medium","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"Not authorized to subscribe user to WordOfTheDayList.","code":403},{"reason":"User not found to filter by.","code":404}],"condition":"any"}],"category":"Subscriptions","summary":"Deletes a subscription to an object.","suggestedName":"removeSubscription","deprecated":false,"open":false,"httpMethod":"DELETE"}]},{"path":"/user.{format}/{user}/favorites/words","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite Words for","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"List[wordObject]","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"condition":"any"}],"category":"Favorites","summary":"Fetches Favorite Words for a user.","suggestedName":"getUserFavoriteWords","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{user}/favorites/wordCount","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite Words for","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"condition":"any"}],"category":"Favorites","summary":"Fetches favorite word count for a user.","suggestedName":"getUserFavoriteCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{user}/favorites/wordLists","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite WordLists for","required":false,"dataType":"string","paramType":"path"},{"name":"access","description":"Filters results by access","required":false,"dataType":"string","allowableValues":"public,private","paramType":"query"}],"response":[{"valueType":"List[wordList]","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"condition":"any"}],"category":"Favorites","summary":"Fetches Favorite WordLists for a user.","suggestedName":"getUserFavoriteWordLists","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{user}/favorites/wordListCount","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite WordList count for","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"condition":"any"}],"category":"Favorites","summary":"Fetches Favorite WordList count for a user.","suggestedName":"getUserFavoriteWordListsCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{user}/searches","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch History for","required":false,"dataType":"string","paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[recentLookup]","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"condition":"any"}],"category":"Activity","summary":"Fetches SearchHistory for a User.","suggestedName":"getUserSearchHistory","deprecated":false,"open":false,"httpMethod":"GET"},{"parameters":[{"name":"user","description":"User to remove search history for","required":false,"dataType":"string","paramType":"path"},{"name":"word","description":"Word to delete","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[recentLookup]","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"condition":"any"}],"category":"Activity","summary":"Fetches SearchHistory for a User.","suggestedName":"removeUserSearchHistoryItem","deprecated":false,"open":false,"httpMethod":"DELETE"}]},{"path":"/user.{format}/{user}/totalSearches","description":"","operations":[{"parameters":[{"name":"user","description":"User to retrieve search count for","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"condition":"any"}],"category":"Activity","summary":"Fetches the total search count for a User.","suggestedName":"getUserSearchHistoryCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{user}/pronunciations","description":"","operations":[{"parameters":[{"name":"user","description":"User to retrieve search count for","required":false,"dataType":"string","paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[audioObject]","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"condition":"any"}],"category":"Activity","summary":"Fetches the total search count for a User.","suggestedName":"getUserPronunciations","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user.{format}/{user}/activitystream","description":"","operations":[{"parameters":[{"name":"user","description":"User to retrieve search count for","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"condition":"any"}],"category":"Activity","summary":"Fetches the total search count for a User.","suggestedName":"getUserActivityStream","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/user","description":"","operations":[{"response":[{"valueType":"doc","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Help","summary":"Returns information about API parameters","suggestedName":"getHelp","deprecated":false,"open":true,"httpMethod":"GET"}]}],"models":[{"name":"Principal","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"type","required":false,"paramType":"int"},{"name":"token","required":false,"paramType":"string"},{"name":"wordnikUserId","required":false,"paramType":"long"}]},{"name":"tag","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"long"},{"name":"count","required":false,"paramType":"long"}]},{"name":"userTagHistory","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"tag","required":false,"paramType":"string"},{"name":"userId","required":false,"paramType":"long"},{"name":"wordstring","required":false,"paramType":"string"},{"name":"wordId","required":false,"paramType":"long"},{"name":"tagDate","required":false,"paramType":"Date"},{"name":"tagId","required":false,"paramType":"long"}]},{"name":"object","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"fields","required":false,"paramType":"List[parameter]"},{"name":"uniqueFieldName","required":false,"paramType":"string"}]},{"name":"long","fields":[{"name":"value","required":false,"paramType":"long"}]},{"name":"wordOfTheDayList","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":true,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"category","required":false,"paramType":"string"},{"name":"createdBy","required":false,"paramType":"string"},{"name":"items","required":false,"paramType":"List[WordOfTheDay]"},{"name":"subscriberCount","required":false,"paramType":"int"},{"name":"subscriptionStatus","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"commentCount","required":false,"paramType":"int"},{"name":"voteCount","required":false,"paramType":"integer"},{"name":"voteAverage","required":false,"paramType":"float"},{"name":"voteWeightedAverage","required":false,"paramType":"float"},{"name":"itemCount","required":false,"paramType":"int"},{"name":"firstItemDate","required":false,"paramType":"Date"},{"name":"lastItemDate","required":false,"paramType":"Date"},{"name":"subscriptionSchedule","required":false,"paramType":"string"},{"name":"subscriptionNamespace","required":false,"paramType":"string"},{"name":"subscriptionIdentifier","required":false,"paramType":"string"}]},{"name":"category","fields":[{"name":"name","required":false,"paramType":"string"}]},{"name":"SubscriptionType","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"items","required":false,"paramType":"List[SubscriptionItem]"}]},{"name":"response","fields":[{"name":"valueType","required":false,"paramType":"string"},{"name":"errorResponses","required":false,"paramType":"List[error]"},{"name":"occurs","required":false,"paramType":"string"},{"name":"condition","required":false,"paramType":"string"}]},{"name":"contentProvider","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"audioType","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"doc","fields":[{"name":"endPoints","required":false,"paramType":"List[endpoint]"},{"name":"models","required":false,"paramType":"List[object]"}]},{"name":"root","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"categories","required":false,"paramType":"List[category]"}]},{"name":"audioType","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"SimpleDefinition","fields":[{"name":"text","required":false,"paramType":"string"},{"name":"partOfSpeech","required":false,"paramType":"string"},{"name":"note","required":false,"paramType":"string"},{"name":"source","required":false,"paramType":"string"}]},{"name":"endpoint","fields":[{"name":"path","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"operations","required":false,"paramType":"List[operation]"}]},{"name":"operation","fields":[{"name":"parameters","required":false,"paramType":"List[parameter]"},{"name":"response","required":false,"paramType":"List[response]"},{"name":"category","required":false,"paramType":"string"},{"name":"summary","required":false,"paramType":"string"},{"name":"suggestedName","required":false,"paramType":"string"},{"name":"deprecated","required":false,"paramType":"boolean"},{"name":"open","required":false,"paramType":"boolean"},{"name":"notes","required":false,"paramType":"string"},{"name":"httpMethod","required":false,"paramType":"string"}]},{"name":"error","fields":[{"name":"reason","required":false,"paramType":"string"},{"name":"code","required":false,"paramType":"int"}]},{"name":"wordObject","fields":[{"name":"word","required":false,"paramType":"string"},{"name":"vulgar","required":false,"paramType":"string"}]},{"name":"UserHandle","fields":[{"name":"webService","required":false,"paramType":"int"},{"name":"handle","required":false,"paramType":"string"}]},{"name":"SubscriptionItem","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"medium","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"}]},{"name":"comment","fields":[{"name":"objectType","required":false,"paramType":"string"},{"name":"objectId","required":false,"paramType":"long"},{"name":"commentedBy","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"updatedAt","required":false,"paramType":"Date"},{"name":"commentedOn","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"string"},{"name":"body","required":false,"paramType":"string"}]},{"name":"UserTrackingInfo","fields":[{"name":"userId","required":false,"paramType":"long"},{"name":"signupIPAddress","required":false,"paramType":"string"},{"name":"noOfLogins","required":false,"paramType":"int"},{"name":"signupDate","required":false,"paramType":"Date"},{"name":"lastUpdatedDate","required":false,"paramType":"Date"},{"name":"lastLoginDate","required":false,"paramType":"Date"}]},{"name":"partOfSpeech","fields":[{"name":"roots","required":false,"paramType":"List[root]"}]},{"name":"recentLookup","fields":[{"name":"wordstring","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"}]},{"name":"UserProfile","fields":[{"name":"location","required":false,"paramType":"string"},{"name":"userId","required":false,"paramType":"long"},{"name":"firstName","required":false,"paramType":"string"},{"name":"lastName","required":false,"paramType":"string"},{"name":"bio","required":false,"paramType":"string"},{"name":"siteUrl","required":false,"paramType":"string"},{"name":"leastFavoriteWord","required":false,"paramType":"string"},{"name":"mostFavoriteWord","required":false,"paramType":"string"},{"name":"onomaTopoeiaWord","required":false,"paramType":"string"},{"name":"seekingWord","required":false,"paramType":"string"},{"name":"youWord","required":false,"paramType":"string"},{"name":"userHandles","required":false,"paramType":"List[UserHandle]"},{"name":"siteName","required":false,"paramType":"string"}]},{"name":"parameter","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"defaultValue","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"required","required":false,"paramType":"boolean"},{"name":"dataType","required":false,"paramType":"string"},{"name":"allowableValues","required":false,"paramType":"string"},{"name":"wrapperName","required":false,"paramType":"string"},{"name":"internalDescription","required":false,"paramType":"string"},{"name":"paramAccess","required":false,"paramType":"string"},{"name":"paramType","required":false,"paramType":"string"}]},{"name":"wordList","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"long"},{"name":"type","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"userId","required":false,"paramType":"long"},{"name":"permalink","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"username","required":false,"paramType":"string"},{"name":"updatedAt","required":false,"paramType":"Date"},{"name":"numberWordsInList","required":false,"paramType":"long"}]},{"name":"WordOfTheDay","fields":[{"name":"id","required":true,"paramType":"long"},{"name":"category","required":false,"paramType":"string"},{"name":"example","required":false,"wrapperName":"examples","paramType":"List[SimpleExample]"},{"name":"word","required":false,"paramType":"string"},{"name":"createdBy","required":false,"paramType":"string"},{"name":"definition","required":false,"wrapperName":"definitions","paramType":"List[SimpleDefinition]"},{"name":"contentProvider","required":false,"paramType":"contentProvider"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"publishDate","required":false,"paramType":"Date"},{"name":"parentId","required":false,"paramType":"string"},{"name":"note","required":false,"paramType":"string"},{"name":"htmlExtra","required":false,"paramType":"string"}]},{"name":"SubscriptionStatus","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"UserSettings","fields":[{"name":"userId","required":false,"paramType":"long"},{"name":"bossURL","required":false,"paramType":"string"}]},{"name":"UgcSummary","fields":[{"name":"userId","required":false,"paramType":"long"},{"name":"ugcCounters","required":false,"paramType":"Map[string,long]"},{"name":"ugcLabels","required":false,"paramType":"Map[string,string]"},{"name":"ugcEvents","required":false,"paramType":"Map[string,Date]"}]},{"name":"audioObject","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"type","required":false,"paramType":"audioType"},{"name":"description","required":false,"paramType":"string"},{"name":"duration","required":false,"paramType":"double"},{"name":"userId","required":false,"paramType":"long"},{"name":"wordstring","required":false,"paramType":"string"},{"name":"createdBy","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"wordId","required":false,"paramType":"long"},{"name":"filePath","required":false,"paramType":"string"},{"name":"recordId","required":false,"paramType":"string"},{"name":"audioFileType","required":false,"paramType":"audioType"},{"name":"audioFileId","required":false,"paramType":"long"},{"name":"streamPath","required":false,"paramType":"string"}]},{"name":"user","fields":[{"name":"id","description":"Unique idenitifier for a user","required":false,"paramType":"long"},{"name":"displayName","description":"Display name","required":false,"paramType":"string"},{"name":"status","description":"Account status","required":false,"allowableValues":"0,1,2,3","paramType":"int"},{"name":"password","required":false,"paramType":"string"},{"name":"userName","description":"User name","required":false,"paramType":"string"},{"name":"email","description":"Email address","required":false,"paramType":"string"},{"name":"faceBookId","description":"Facebook ID","required":false,"paramType":"string"}]},{"name":"SimpleExample","fields":[{"name":"url","required":false,"paramType":"string"},{"name":"text","required":false,"paramType":"string"},{"name":"title","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"long"}]}]}
+{"resourcePath":"/user","models":{"SubscriptionStatus":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"SubscriptionStatus","type":"any","required":false,"uniqueItems":false},"wordOfTheDayList":{"properties":{"subscriptionNamespace":{"type":"string","required":false,"uniqueItems":false},"subscriberCount":{"type":"int","required":false,"uniqueItems":false},"commentCount":{"type":"int","required":false,"uniqueItems":false},"subscriptionIdentifier":{"type":"string","required":false,"uniqueItems":false},"firstItemDate":{"type":"Date","required":false,"uniqueItems":false},"voteCount":{"type":"integer","required":false,"uniqueItems":false},"id":{"type":"string","required":true,"uniqueItems":false},"category":{"type":"string","required":false,"uniqueItems":false},"createdBy":{"type":"string","required":false,"uniqueItems":false},"items":{"type":"array","required":false,"items":{"$ref":"WordOfTheDay","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false},"voteWeightedAverage":{"type":"float","required":false,"uniqueItems":false},"subscriptionSchedule":{"type":"string","required":false,"uniqueItems":false},"lastItemDate":{"type":"Date","required":false,"uniqueItems":false},"voteAverage":{"type":"float","required":false,"uniqueItems":false},"itemCount":{"type":"int","required":false,"uniqueItems":false},"subscriptionStatus":{"type":"string","required":false,"uniqueItems":false}},"id":"wordOfTheDayList","type":"any","required":false,"uniqueItems":false},"Principal":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"token":{"type":"string","required":false,"uniqueItems":false},"wordnikUserId":{"type":"long","required":false,"uniqueItems":false},"type":{"type":"int","required":false,"uniqueItems":false}},"id":"Principal","type":"any","required":false,"uniqueItems":false},"UserHandle":{"properties":{"webService":{"type":"int","required":false,"uniqueItems":false},"handle":{"type":"string","required":false,"uniqueItems":false}},"id":"UserHandle","type":"any","required":false,"uniqueItems":false},"tag":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"count":{"type":"long","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"tag","type":"any","required":false,"uniqueItems":false},"userTagHistory":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"wordId":{"type":"long","required":false,"uniqueItems":false},"tagDate":{"type":"Date","required":false,"uniqueItems":false},"tag":{"type":"string","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"tagId":{"type":"long","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false}},"id":"userTagHistory","type":"any","required":false,"uniqueItems":false},"WordOfTheDay":{"properties":{"id":{"type":"long","required":true,"uniqueItems":false},"parentId":{"type":"string","required":false,"uniqueItems":false},"category":{"type":"string","required":false,"uniqueItems":false},"definition":{"type":"array","required":false,"items":{"$ref":"SimpleDefinition","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"createdBy":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"contentProvider":{"type":"contentProvider","required":false,"uniqueItems":false},"htmlExtra":{"type":"string","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"example":{"type":"array","required":false,"items":{"$ref":"SimpleExample","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"note":{"type":"string","required":false,"uniqueItems":false},"publishDate":{"type":"Date","required":false,"uniqueItems":false}},"id":"WordOfTheDay","type":"any","required":false,"uniqueItems":false},"long":{"properties":{"value":{"type":"long","required":false,"uniqueItems":false}},"id":"long","type":"any","required":false,"uniqueItems":false},"UgcSummary":{"properties":{"ugcEvents":{"type":"Map[string,Date]","required":false,"uniqueItems":false},"ugcLabels":{"type":"Map[string,string]","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"ugcCounters":{"type":"Map[string,long]","required":false,"uniqueItems":false}},"id":"UgcSummary","type":"any","required":false,"uniqueItems":false},"SimpleDefinition":{"properties":{"text":{"type":"string","required":false,"uniqueItems":false},"source":{"type":"string","required":false,"uniqueItems":false},"note":{"type":"string","required":false,"uniqueItems":false},"partOfSpeech":{"type":"string","required":false,"uniqueItems":false}},"id":"SimpleDefinition","type":"any","required":false,"uniqueItems":false},"wordObject":{"properties":{"word":{"type":"string","required":false,"uniqueItems":false},"vulgar":{"type":"string","required":false,"uniqueItems":false}},"id":"wordObject","type":"any","required":false,"uniqueItems":false},"UserTrackingInfo":{"properties":{"signupDate":{"type":"Date","required":false,"uniqueItems":false},"lastLoginDate":{"type":"Date","required":false,"uniqueItems":false},"noOfLogins":{"type":"int","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"lastUpdatedDate":{"type":"Date","required":false,"uniqueItems":false},"signupIPAddress":{"type":"string","required":false,"uniqueItems":false}},"id":"UserTrackingInfo","type":"any","required":false,"uniqueItems":false},"audioObject":{"properties":{"recordId":{"type":"string","required":false,"uniqueItems":false},"wordId":{"type":"long","required":false,"uniqueItems":false},"audioFileType":{"type":"audioType","required":false,"uniqueItems":false},"filePath":{"type":"string","required":false,"uniqueItems":false},"type":{"type":"audioType","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"duration":{"type":"double","required":false,"uniqueItems":false},"createdBy":{"type":"string","required":false,"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"streamPath":{"type":"string","required":false,"uniqueItems":false},"audioFileId":{"type":"long","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false}},"id":"audioObject","type":"any","required":false,"uniqueItems":false},"wordList":{"properties":{"updatedAt":{"type":"Date","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"username":{"type":"string","required":false,"uniqueItems":false},"permalink":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false},"numberWordsInList":{"type":"long","required":false,"uniqueItems":false},"type":{"type":"string","required":false,"uniqueItems":false}},"id":"wordList","type":"any","required":false,"uniqueItems":false},"SubscriptionType":{"properties":{"items":{"type":"array","required":false,"items":{"$ref":"SubscriptionItem","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"SubscriptionType","type":"any","required":false,"uniqueItems":false},"UserSettings":{"properties":{"bossURL":{"type":"string","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false}},"id":"UserSettings","type":"any","required":false,"uniqueItems":false},"audioType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"audioType","type":"any","required":false,"uniqueItems":false},"SubscriptionItem":{"properties":{"createdAt":{"type":"Date","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false},"medium":{"type":"string","required":false,"uniqueItems":false}},"id":"SubscriptionItem","type":"any","required":false,"uniqueItems":false},"recentLookup":{"properties":{"createdAt":{"type":"Date","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false}},"id":"recentLookup","type":"any","required":false,"uniqueItems":false},"contentProvider":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"contentProvider","type":"any","required":false,"uniqueItems":false},"UserProfile":{"properties":{"lastName":{"type":"string","required":false,"uniqueItems":false},"mostFavoriteWord":{"type":"string","required":false,"uniqueItems":false},"location":{"type":"string","required":false,"uniqueItems":false},"seekingWord":{"type":"string","required":false,"uniqueItems":false},"leastFavoriteWord":{"type":"string","required":false,"uniqueItems":false},"onomaTopoeiaWord":{"type":"string","required":false,"uniqueItems":false},"siteUrl":{"type":"string","required":false,"uniqueItems":false},"bio":{"type":"string","required":false,"uniqueItems":false},"userHandles":{"type":"array","required":false,"items":{"$ref":"UserHandle","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"youWord":{"type":"string","required":false,"uniqueItems":false},"firstName":{"type":"string","required":false,"uniqueItems":false},"siteName":{"type":"string","required":false,"uniqueItems":false}},"id":"UserProfile","type":"any","required":false,"uniqueItems":false},"comment":{"properties":{"updatedAt":{"type":"Date","required":false,"uniqueItems":false},"id":{"type":"string","required":false,"uniqueItems":false},"body":{"type":"string","required":false,"uniqueItems":false},"commentedOn":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"objectId":{"type":"long","required":false,"uniqueItems":false},"commentedBy":{"type":"string","required":false,"uniqueItems":false},"objectType":{"type":"string","required":false,"uniqueItems":false}},"id":"comment","type":"any","required":false,"uniqueItems":false},"SimpleExample":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"title":{"type":"string","required":false,"uniqueItems":false},"text":{"type":"string","required":false,"uniqueItems":false},"url":{"type":"string","required":false,"uniqueItems":false}},"id":"SimpleExample","type":"any","required":false,"uniqueItems":false},"user":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"email":{"type":"string","required":false,"uniqueItems":false},"status":{"type":"int","required":false,"uniqueItems":false},"faceBookId":{"type":"string","required":false,"uniqueItems":false},"userName":{"type":"string","required":false,"uniqueItems":false},"displayName":{"type":"string","required":false,"uniqueItems":false},"password":{"type":"string","required":false,"uniqueItems":false}},"id":"user","type":"any","required":false,"uniqueItems":false},"partOfSpeech":{"properties":{"roots":{"type":"array","required":false,"items":{"$ref":"root","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"partOfSpeech","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/user.{format}/{username}/wordOfTheDayList","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"includeAll","description":"Include future words (owner-only)","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns a user's WordOfTheDayList","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"No WordOfTheDayList available","code":404}],"nickname":"getWordOfTheDayList","responseClass":"wordOfTheDayList"},{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"WordOfTheDayList to create, provided in the format specified by the URL","required":true,"dataType":"wordOfTheDayList","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Creates a WordOfTheDayList","httpMethod":"POST","errorResponses":[{"reason":"User already has a list or list is invalid","code":400},{"reason":"User not found","code":404}],"nickname":"createWordOfTheDayList","responseClass":"wordOfTheDayList","notes":"A user can have only one WordOfTheDayList."},{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Updated WordOfTheDayList data in the format specified by the URL","required":true,"dataType":"wordOfTheDayList","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Updates a user's WordOfTheDayList","httpMethod":"PUT","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"Not authorized to perform update","code":403},{"reason":"No WordOfTheDayList available","code":404}],"nickname":"updateWordOfTheDayList","responseClass":"ok"}]},{"path":"/user.{format}/{username}/wordOfTheDayList/{permalink}","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"permalink","description":"Permalink of WordOfTheDayList to delete","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Deletes a user's WordOfTheDayList","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"Not authorized to perform update","code":403},{"reason":"No WordOfTheDayList available","code":404}],"nickname":"updateWordOfTheDayList","responseClass":"ok"},{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"permalink","description":"Permalink of the WordOfTheDayList to add the WordOfTheDay to","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"WordOfTheDay to add, in the format specified by the URL","required":true,"dataType":"WordOfTheDay","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Adds a WordOfTheDay to a user's WordOfTheDayList","httpMethod":"PUT","errorResponses":[{"reason":"WordOfTheDay already scheduled on this date","code":400},{"reason":"Not authorized to perform modification","code":403},{"reason":"No WordOfTheDayList available to add to","code":404}],"nickname":"updateItemInWordOfTheDayList","responseClass":"ok"}]},{"path":"/user.{format}/{username}/profile","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch profile for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns a UserProfile","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getUserProfile","responseClass":"UserProfile"},{"parameters":[{"name":"username","description":"Username to fetch profile for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Updated UserProfile.","required":false,"dataType":"UserProfile","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Updates a UserProfile","httpMethod":"PUT","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"updateUserProfile","responseClass":"ok"}]},{"path":"/user.{format}/{username}/trackingInfo","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch tracking info for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns a user's tracking info","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getUserTrackingInfo","responseClass":"UserTrackingInfo"}]},{"path":"/user.{format}/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"Username to update.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Updated User object.","required":false,"dataType":"user","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Updates a User","httpMethod":"PUT","errorResponses":[{"reason":"Invalid username supplied or username/email already in use.","code":400},{"reason":"User not found","code":404}],"nickname":"updateUser","responseClass":"ok"},{"parameters":[{"name":"username","description":"Username to get.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches a User","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found","code":404}],"nickname":"getUser","responseClass":"user"},{"parameters":[{"name":"username","description":"Username to update.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Deletes a User","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid username supplied or username/email already in use.","code":400},{"reason":"User not found","code":404}],"nickname":"deleteUser","responseClass":"ok"}]},{"path":"/user.{format}/{username}/wordOfTheDayList/{permalink}/add","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"permalink","description":"WordOfTheDayList to modify","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"WordOfTheDay to add","required":true,"dataType":"WordOfTheDay","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Adds an item to a user's WordOfTheDayList","httpMethod":"PUT","errorResponses":[{"reason":"WordOfTheDay already scheduled on this date","code":400},{"reason":"Not authorized to perform modification","code":403},{"reason":"No WordOfTheDayList available to add to","code":404}],"nickname":"addWordToWordOfTheDayList","responseClass":"ok"}]},{"path":"/user.{format}/{username}/wordOfTheDayList/{permalink}/{wordToDelete}","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"permalink","description":"Permalink of WordOfTheDayList to delete a word from","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"wordToDelete","description":"Word to delete","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Deletes a specific word from a user's WordOfTheDayList","httpMethod":"DELETE","errorResponses":[{"reason":"WordOfTheDay already scheduled on this date","code":400},{"reason":"Not authorized to perform modification","code":403},{"reason":"No WordOfTheDayList available to add to","code":404}],"nickname":"deleteWordFromWordOfTheDayList","responseClass":"ok"}]},{"path":"/user.{format}/{username}/wordOfTheDay/{date}","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDay owner","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"date","description":"Date of the WordOfTheDay to retrieve (yyyy-MM-dd) format","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"includeAll","description":"Include WordOfTheDay items for future dates (owner-only)","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns the WordOfTheDay for a given user on a given date","httpMethod":"GET","errorResponses":[{"reason":"Invalid username or dateString supplied","code":400},{"reason":"User not found or no list available","code":404}],"nickname":"getWordOfTheDayByDate","responseClass":"WordOfTheDay"}]},{"path":"/user.{format}/{username}/wordLists","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch WordLists for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"sortBy","defaultValue":"createDate","description":"Field to sort by","required":false,"dataType":"string","allowableValues":["alpha","createDate","editDate"],"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","defaultValue":"desc","description":"Direction to sort","required":false,"dataType":"string","allowableValues":["asc","desc"],"allowMultiple":false,"paramType":"query"}],"summary":"Gets WordLists for a User.","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found","code":404}],"nickname":"getUserWordLists","responseClass":"List[wordList]"}]},{"path":"/user.{format}/{username}/wordListsCount","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch WordLists for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Gets the count of WordLists for a User.","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found","code":404}],"nickname":"getUserWordListCount","responseClass":"long"}]},{"path":"/user.{format}/{username}/settings","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch settings for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns a user's settings","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getUserSettings","responseClass":"UserSettings"},{"parameters":[{"name":"username","description":"Username to fetch profile for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Updated UserSettings.","required":false,"dataType":"UserSettings","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Updates a user's settings","httpMethod":"PUT","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"updateUserSettings","responseClass":"ok"}]},{"path":"/user.{format}/{username}/apiKey","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch api key for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns the API key for the specified user","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404},{"reason":"API key not found","code":409}],"nickname":"getApiKeyForUser","responseClass":"Principal","notes":"Use the super user API key for getting this information or auth token of the user who is requesting the API key"}]},{"path":"/user.{format}/{username}/comment","description":"","operations":[{"parameters":[{"name":"username","description":"Username to comment on.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Comment to save.","required":false,"dataType":"comment","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Adds a Comment on a User","httpMethod":"POST","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"commentOnUser","responseClass":"comment"},{"parameters":[{"name":"username","description":"Username with Comment.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Updated Comment.","required":false,"dataType":"comment","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Updates a Comment on a User","httpMethod":"PUT","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"updateCommentOnUser","responseClass":"comment"}]},{"path":"/user.{format}/{username}/comment/{commentId}","description":"","operations":[{"parameters":[{"name":"username","description":"Username with Comment.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Updated Comment.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Deletes a Comment on a User","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"deleteCommentOnUser","responseClass":"ok"},{"parameters":[{"name":"username","description":"Username with Comment.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Comment ID.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches a comment by ID","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentOnUserById","responseClass":"comment"}]},{"path":"/user.{format}/{username}/commentsOnCount","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns a count of Comments on a user","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentsOnUserCount","responseClass":"long"}]},{"path":"/user.{format}/{username}/commentsByCount","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count by.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns a count of Comments by a user","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentsByUserCount","responseClass":"long"}]},{"path":"/user.{format}/{username}/commentsBy","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count by.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort order","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns Comments by a user","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentsByUser","responseClass":"List[comment]"}]},{"path":"/user.{format}/{username}/commentsOnUser","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count by.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort order","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns Comments on a user","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentsOnUser","responseClass":"List[comment]"}]},{"path":"/user.{format}/{username}/ugcSummary","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get statistics for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort order","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns UgcSummary info a user","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getUgcSummaryForUser","responseClass":"UgcSummary"}]},{"path":"/user.{format}/{user}/tagHistory","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch History for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches TagHistory for a User.","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserTagHistory","responseClass":"List[userTagHistory]"}]},{"path":"/user.{format}/{user}/tags","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Tags for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches Tags by a User.","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserTags","responseClass":"List[tag]"}]},{"path":"/user.{format}/{user}/tagCount","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Tag count for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches the count of Tags created by a User.","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"getUserTagCount","responseClass":"long"}]},{"path":"/user.{format}/{user}/subscriptions","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch subscriptions for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches all subscriptions for a User.","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"Not authorized to fetch subscriptions.","code":403},{"reason":"User not found.","code":404}],"nickname":"getSubscriptions","responseClass":"List[SubscriptionType]"}]},{"path":"/user.{format}/{user}/subscriptions/{objectType}/{objectIdentifier}","description":"","operations":[{"parameters":[{"name":"user","description":"User to add subscriptions to","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"objectType","description":"Object Type","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"objectIdentifier","description":"Object Identifier","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"medium","description":"Subscription medium","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Subscribes to an object.","httpMethod":"POST","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"Not authorized to subscribe user to WordOfTheDayList.","code":403},{"reason":"User not found to filter by.","code":404}],"nickname":"addSubscription","responseClass":"ok"},{"parameters":[{"name":"user","description":"User to add subscriptions to","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"objectType","description":"Object Type","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"objectIdentifier","description":"Object Identifier","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"medium","description":"Subscription medium","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Deletes a subscription to an object.","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"Not authorized to subscribe user to WordOfTheDayList.","code":403},{"reason":"User not found to filter by.","code":404}],"nickname":"removeSubscription","responseClass":"ok"}]},{"path":"/user.{format}/{user}/favorites/words","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite Words for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches Favorite Words for a user.","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserFavoriteWords","responseClass":"List[wordObject]"}]},{"path":"/user.{format}/{user}/favorites/wordCount","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite Words for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches favorite word count for a user.","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserFavoriteCount","responseClass":"long"}]},{"path":"/user.{format}/{user}/favorites/wordLists","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite WordLists for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"access","description":"Filters results by access","required":false,"dataType":"string","allowableValues":["public","private"],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches Favorite WordLists for a user.","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserFavoriteWordLists","responseClass":"List[wordList]"}]},{"path":"/user.{format}/{user}/favorites/wordListCount","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite WordList count for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches Favorite WordList count for a user.","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserFavoriteWordListsCount","responseClass":"long"}]},{"path":"/user.{format}/{user}/searches","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch History for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches SearchHistory for a User.","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserSearchHistory","responseClass":"List[recentLookup]"},{"parameters":[{"name":"user","description":"User to remove search history for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"word","description":"Word to delete","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches SearchHistory for a User.","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"removeUserSearchHistoryItem","responseClass":"List[recentLookup]"}]},{"path":"/user.{format}/{user}/totalSearches","description":"","operations":[{"parameters":[{"name":"user","description":"User to retrieve search count for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches the total search count for a User.","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"getUserSearchHistoryCount","responseClass":"Long"}]},{"path":"/user.{format}/{user}/pronunciations","description":"","operations":[{"parameters":[{"name":"user","description":"User to retrieve search count for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches the total search count for a User.","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"getUserPronunciations","responseClass":"List[audioObject]"}]},{"path":"/user.{format}/{user}/activitystream","description":"","operations":[{"parameters":[{"name":"user","description":"User to retrieve search count for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches the total search count for a User.","httpMethod":"GET","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"getUserActivityStream","responseClass":"Long"}]}],"models1":[{"name":"Principal","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"type","required":false,"allowMultiple":false,"paramType":"int"},{"name":"token","required":false,"allowMultiple":false,"paramType":"string"},{"name":"wordnikUserId","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"tag","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"count","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"userTagHistory","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"tag","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"wordId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"tagId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"tagDate","required":false,"allowMultiple":false,"paramType":"Date"}]},{"name":"long","fields":[{"name":"value","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"wordOfTheDayList","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":true,"allowMultiple":false,"paramType":"string"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"category","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdBy","required":false,"allowMultiple":false,"paramType":"string"},{"name":"items","required":false,"allowMultiple":false,"paramType":"List[WordOfTheDay]"},{"name":"subscriberCount","required":false,"allowMultiple":false,"paramType":"int"},{"name":"subscriptionStatus","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"commentCount","required":false,"allowMultiple":false,"paramType":"int"},{"name":"voteCount","required":false,"allowMultiple":false,"paramType":"integer"},{"name":"voteAverage","required":false,"allowMultiple":false,"paramType":"float"},{"name":"voteWeightedAverage","required":false,"allowMultiple":false,"paramType":"float"},{"name":"itemCount","required":false,"allowMultiple":false,"paramType":"int"},{"name":"firstItemDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"lastItemDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"subscriptionSchedule","required":false,"allowMultiple":false,"paramType":"string"},{"name":"subscriptionNamespace","required":false,"allowMultiple":false,"paramType":"string"},{"name":"subscriptionIdentifier","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"SubscriptionType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"items","required":false,"allowMultiple":false,"paramType":"List[SubscriptionItem]"}]},{"name":"contentProvider","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"audioType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"audioType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"SimpleDefinition","fields":[{"name":"text","required":false,"allowMultiple":false,"paramType":"string"},{"name":"partOfSpeech","required":false,"allowMultiple":false,"paramType":"string"},{"name":"note","required":false,"allowMultiple":false,"paramType":"string"},{"name":"source","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"wordObject","fields":[{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"vulgar","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"UserHandle","fields":[{"name":"webService","required":false,"allowMultiple":false,"paramType":"int"},{"name":"handle","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"SubscriptionItem","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"medium","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"}]},{"name":"UserTrackingInfo","fields":[{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"noOfLogins","required":false,"allowMultiple":false,"paramType":"int"},{"name":"signupDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"signupIPAddress","required":false,"allowMultiple":false,"paramType":"string"},{"name":"lastUpdatedDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"lastLoginDate","required":false,"allowMultiple":false,"paramType":"Date"}]},{"name":"comment","fields":[{"name":"objectType","required":false,"allowMultiple":false,"paramType":"string"},{"name":"objectId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"commentedBy","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"id","required":false,"allowMultiple":false,"paramType":"string"},{"name":"commentedOn","required":false,"allowMultiple":false,"paramType":"string"},{"name":"body","required":false,"allowMultiple":false,"paramType":"string"},{"name":"updatedAt","required":false,"allowMultiple":false,"paramType":"Date"}]},{"name":"partOfSpeech","fields":[{"name":"roots","required":false,"allowMultiple":false,"paramType":"List[root]"}]},{"name":"recentLookup","fields":[{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"}]},{"name":"UserProfile","fields":[{"name":"location","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"firstName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"lastName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"bio","required":false,"allowMultiple":false,"paramType":"string"},{"name":"siteUrl","required":false,"allowMultiple":false,"paramType":"string"},{"name":"leastFavoriteWord","required":false,"allowMultiple":false,"paramType":"string"},{"name":"mostFavoriteWord","required":false,"allowMultiple":false,"paramType":"string"},{"name":"onomaTopoeiaWord","required":false,"allowMultiple":false,"paramType":"string"},{"name":"seekingWord","required":false,"allowMultiple":false,"paramType":"string"},{"name":"youWord","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userHandles","required":false,"allowMultiple":false,"paramType":"List[UserHandle]"},{"name":"siteName","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"wordList","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"type","required":false,"allowMultiple":false,"paramType":"string"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"permalink","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"username","required":false,"allowMultiple":false,"paramType":"string"},{"name":"updatedAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"numberWordsInList","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"WordOfTheDay","fields":[{"name":"id","required":true,"allowMultiple":false,"paramType":"long"},{"name":"category","required":false,"allowMultiple":false,"paramType":"string"},{"name":"example","required":false,"wrapperName":"examples","allowMultiple":false,"paramType":"List[SimpleExample]"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdBy","required":false,"allowMultiple":false,"paramType":"string"},{"name":"definition","required":false,"wrapperName":"definitions","allowMultiple":false,"paramType":"List[SimpleDefinition]"},{"name":"contentProvider","required":false,"allowMultiple":false,"paramType":"contentProvider"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"publishDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"parentId","required":false,"allowMultiple":false,"paramType":"string"},{"name":"note","required":false,"allowMultiple":false,"paramType":"string"},{"name":"htmlExtra","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"UserSettings","fields":[{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"bossURL","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"SubscriptionStatus","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"UgcSummary","fields":[{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"ugcEvents","required":false,"allowMultiple":false,"paramType":"Map[string,Date]"},{"name":"ugcCounters","required":false,"allowMultiple":false,"paramType":"Map[string,long]"},{"name":"ugcLabels","required":false,"allowMultiple":false,"paramType":"Map[string,string]"}]},{"name":"audioObject","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"type","required":false,"allowMultiple":false,"paramType":"audioType"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"duration","required":false,"allowMultiple":false,"paramType":"double"},{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdBy","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"audioFileType","required":false,"allowMultiple":false,"paramType":"audioType"},{"name":"audioFileId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"filePath","required":false,"allowMultiple":false,"paramType":"string"},{"name":"wordId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"recordId","required":false,"allowMultiple":false,"paramType":"string"},{"name":"streamPath","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"SimpleExample","fields":[{"name":"url","required":false,"allowMultiple":false,"paramType":"string"},{"name":"text","required":false,"allowMultiple":false,"paramType":"string"},{"name":"title","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"user","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"displayName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"status","required":false,"allowMultiple":false,"paramType":"int"},{"name":"password","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"email","required":false,"allowMultiple":false,"paramType":"string"},{"name":"faceBookId","required":false,"allowMultiple":false,"paramType":"string"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/api_docs/users.json

@@ -1 +1 @@
-{"endPoints":[{"path":"/users.{format}/pronunciations","description":"","operations":[{"parameters":[{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[audioObject]","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Users","summary":"Fetches recent AudioPron objects","suggestedName":"getRecentPronunciations","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/users","description":"","operations":[{"response":[{"valueType":"doc","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Help","summary":"Returns information about API parameters","suggestedName":"getHelp","deprecated":false,"open":true,"httpMethod":"GET"},{"parameters":[{"name":"signupIP","description":"Client IP address","required":false,"dataType":"string","paramType":"query"},{"name":"password","description":"Password","required":false,"dataType":"string","paramType":"query"},{"description":"User to create","required":false,"dataType":"user","paramType":"body"}],"response":[{"valueType":"user","errorResponses":[{"reason":"Invalid User or User parameters supplied.","code":400}],"condition":"any"}],"category":"Users","summary":"Creates a User","suggestedName":"createUser","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/users.{format}/id/{id}","description":"","operations":[{"parameters":[{"name":"id","description":"User ID to filter by","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"user","errorResponses":[{"reason":"User not found.","code":404}],"condition":"any"}],"category":"Users","summary":"Fetches a User by ID","suggestedName":"getUserById","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/users.{format}/facebook/{facebookId}","description":"","operations":[{"parameters":[{"name":"facebookId","description":"Facebook ID to filter by","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"user","errorResponses":[{"reason":"User not found.","code":404}],"condition":"any"}],"category":"Users","summary":"Fetches a User by Facebook ID","suggestedName":"getByFacebookId","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/users.{format}/favorites","description":"","operations":[{"parameters":[{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[wordObject]","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Users","summary":"Fetches recent Favorite Word objects.","suggestedName":"getRecentFavorites","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/users.{format}/comments","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[comment]","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Users","summary":"Fetches recent Comment objects","suggestedName":"getRecentComments","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/users.{format}/listedMostWords","description":"","operations":[{"parameters":[{"name":"dayInterval","description":"Interval in days to compute from","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[UserSummary]","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Users","summary":"Fetches info on Users who listed most words","suggestedName":"getUsersWhoListedMostWords","deprecated":false,"open":false,"httpMethod":"GET"}]}],"models":[{"name":"wordObject","fields":[{"name":"word","required":false,"paramType":"string"},{"name":"vulgar","required":false,"paramType":"string"}]},{"name":"error","fields":[{"name":"reason","required":false,"paramType":"string"},{"name":"code","required":false,"paramType":"int"}]},{"name":"object","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"fields","required":false,"paramType":"List[parameter]"},{"name":"uniqueFieldName","required":false,"paramType":"string"}]},{"name":"comment","fields":[{"name":"objectType","required":false,"paramType":"string"},{"name":"objectId","required":false,"paramType":"long"},{"name":"commentedBy","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"updatedAt","required":false,"paramType":"Date"},{"name":"commentedOn","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"string"},{"name":"body","required":false,"paramType":"string"}]},{"name":"response","fields":[{"name":"valueType","required":false,"paramType":"string"},{"name":"errorResponses","required":false,"paramType":"List[error]"},{"name":"occurs","required":false,"paramType":"string"},{"name":"condition","required":false,"paramType":"string"}]},{"name":"parameter","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"defaultValue","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"required","required":false,"paramType":"boolean"},{"name":"dataType","required":false,"paramType":"string"},{"name":"allowableValues","required":false,"paramType":"string"},{"name":"wrapperName","required":false,"paramType":"string"},{"name":"internalDescription","required":false,"paramType":"string"},{"name":"paramAccess","required":false,"paramType":"string"},{"name":"paramType","required":false,"paramType":"string"}]},{"name":"audioType","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"doc","fields":[{"name":"endPoints","required":false,"paramType":"List[endpoint]"},{"name":"models","required":false,"paramType":"List[object]"}]},{"name":"audioType","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"audioObject","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"type","required":false,"paramType":"audioType"},{"name":"description","required":false,"paramType":"string"},{"name":"duration","required":false,"paramType":"double"},{"name":"userId","required":false,"paramType":"long"},{"name":"wordstring","required":false,"paramType":"string"},{"name":"createdBy","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"wordId","required":false,"paramType":"long"},{"name":"filePath","required":false,"paramType":"string"},{"name":"recordId","required":false,"paramType":"string"},{"name":"audioFileType","required":false,"paramType":"audioType"},{"name":"audioFileId","required":false,"paramType":"long"},{"name":"streamPath","required":false,"paramType":"string"}]},{"name":"endpoint","fields":[{"name":"path","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"operations","required":false,"paramType":"List[operation]"}]},{"name":"UserSummary","fields":[{"name":"userId","required":false,"paramType":"long"},{"name":"userName","required":false,"paramType":"string"},{"name":"totalListedWordsCount","required":false,"paramType":"long"}]},{"name":"operation","fields":[{"name":"parameters","required":false,"paramType":"List[parameter]"},{"name":"response","required":false,"paramType":"List[response]"},{"name":"category","required":false,"paramType":"string"},{"name":"summary","required":false,"paramType":"string"},{"name":"suggestedName","required":false,"paramType":"string"},{"name":"deprecated","required":false,"paramType":"boolean"},{"name":"open","required":false,"paramType":"boolean"},{"name":"notes","required":false,"paramType":"string"},{"name":"httpMethod","required":false,"paramType":"string"}]},{"name":"user","fields":[{"name":"id","description":"Unique idenitifier for a user","required":false,"paramType":"long"},{"name":"displayName","description":"Display name","required":false,"paramType":"string"},{"name":"status","description":"Account status","required":false,"allowableValues":"0,1,2,3","paramType":"int"},{"name":"password","required":false,"paramType":"string"},{"name":"userName","description":"User name","required":false,"paramType":"string"},{"name":"email","description":"Email address","required":false,"paramType":"string"},{"name":"faceBookId","description":"Facebook ID","required":false,"paramType":"string"}]}]}
+{"resourcePath":"/users","models":{"wordObject":{"properties":{"word":{"type":"string","required":false,"uniqueItems":false},"vulgar":{"type":"string","required":false,"uniqueItems":false}},"id":"wordObject","type":"any","required":false,"uniqueItems":false},"UserSummary":{"properties":{"totalListedWordsCount":{"type":"long","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"userName":{"type":"string","required":false,"uniqueItems":false}},"id":"UserSummary","type":"any","required":false,"uniqueItems":false},"comment":{"properties":{"updatedAt":{"type":"Date","required":false,"uniqueItems":false},"id":{"type":"string","required":false,"uniqueItems":false},"body":{"type":"string","required":false,"uniqueItems":false},"commentedOn":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"objectId":{"type":"long","required":false,"uniqueItems":false},"commentedBy":{"type":"string","required":false,"uniqueItems":false},"objectType":{"type":"string","required":false,"uniqueItems":false}},"id":"comment","type":"any","required":false,"uniqueItems":false},"user":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"email":{"type":"string","required":false,"uniqueItems":false},"status":{"type":"int","required":false,"uniqueItems":false},"faceBookId":{"type":"string","required":false,"uniqueItems":false},"userName":{"type":"string","required":false,"uniqueItems":false},"displayName":{"type":"string","required":false,"uniqueItems":false},"password":{"type":"string","required":false,"uniqueItems":false}},"id":"user","type":"any","required":false,"uniqueItems":false},"audioObject":{"properties":{"recordId":{"type":"string","required":false,"uniqueItems":false},"wordId":{"type":"long","required":false,"uniqueItems":false},"audioFileType":{"type":"audioType","required":false,"uniqueItems":false},"filePath":{"type":"string","required":false,"uniqueItems":false},"type":{"type":"audioType","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"duration":{"type":"double","required":false,"uniqueItems":false},"createdBy":{"type":"string","required":false,"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"streamPath":{"type":"string","required":false,"uniqueItems":false},"audioFileId":{"type":"long","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false}},"id":"audioObject","type":"any","required":false,"uniqueItems":false},"audioType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"audioType","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/users.{format}/pronunciations","description":"","operations":[{"parameters":[{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches recent AudioPron objects","httpMethod":"GET","nickname":"getRecentPronunciations","responseClass":"List[audioObject]"}]},{"path":"/users.{format}/id/{id}","description":"","operations":[{"parameters":[{"name":"id","description":"User ID to filter by","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches a User by ID","httpMethod":"GET","errorResponses":[{"reason":"User not found.","code":404}],"nickname":"getUserById","responseClass":"user"}]},{"path":"/users.{format}/facebook/{facebookId}","description":"","operations":[{"parameters":[{"name":"facebookId","description":"Facebook ID to filter by","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches a User by Facebook ID","httpMethod":"GET","errorResponses":[{"reason":"User not found.","code":404}],"nickname":"getByFacebookId","responseClass":"user"}]},{"path":"/users.{format}","description":"","operations":[{"parameters":[{"name":"signupIP","description":"Client IP address","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"password","description":"Password","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"description":"User to create","required":false,"dataType":"user","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Creates a User","httpMethod":"POST","errorResponses":[{"reason":"Invalid User or User parameters supplied.","code":400}],"nickname":"createUser","responseClass":"user"}]},{"path":"/users.{format}/favorites","description":"","operations":[{"parameters":[{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches recent Favorite Word objects.","httpMethod":"GET","nickname":"getRecentFavorites","responseClass":"List[wordObject]"}]},{"path":"/users.{format}/comments","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches recent Comment objects","httpMethod":"GET","nickname":"getRecentComments","responseClass":"List[comment]"}]},{"path":"/users.{format}/listedMostWords","description":"","operations":[{"parameters":[{"name":"dayInterval","description":"Interval in days to compute from","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches info on Users who listed most words","httpMethod":"GET","nickname":"getUsersWhoListedMostWords","responseClass":"List[UserSummary]"}]}],"models1":[{"name":"wordObject","fields":[{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"vulgar","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"audioType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"audioType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"comment","fields":[{"name":"objectType","required":false,"allowMultiple":false,"paramType":"string"},{"name":"objectId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"commentedBy","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"id","required":false,"allowMultiple":false,"paramType":"string"},{"name":"commentedOn","required":false,"allowMultiple":false,"paramType":"string"},{"name":"body","required":false,"allowMultiple":false,"paramType":"string"},{"name":"updatedAt","required":false,"allowMultiple":false,"paramType":"Date"}]},{"name":"audioObject","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"type","required":false,"allowMultiple":false,"paramType":"audioType"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"duration","required":false,"allowMultiple":false,"paramType":"double"},{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdBy","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"audioFileType","required":false,"allowMultiple":false,"paramType":"audioType"},{"name":"audioFileId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"filePath","required":false,"allowMultiple":false,"paramType":"string"},{"name":"wordId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"recordId","required":false,"allowMultiple":false,"paramType":"string"},{"name":"streamPath","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"UserSummary","fields":[{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"userName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"totalListedWordsCount","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"user","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"displayName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"status","required":false,"allowMultiple":false,"paramType":"int"},{"name":"password","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"email","required":false,"allowMultiple":false,"paramType":"string"},{"name":"faceBookId","required":false,"allowMultiple":false,"paramType":"string"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/api_docs/word.json

@@ -1 +1 @@
-{"endPoints":[{"path":"/word.{format}/{word}/entries","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","paramType":"path"},{"name":"tags","description":"Return XML tags in response","required":false,"dataType":"string","paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary. Valid options: ahd, century, wiktionary, webster, and wordnet.","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"},{"name":"etymologies","description":"Return etymologies","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[entry]","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"DictionaryInfo","summary":"Return entries for a word","suggestedName":"getEntries","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/examples","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return examples for","required":true,"dataType":"string","paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"},{"name":"includeDuplicates","description":"Show duplicate examples from different sources","required":false,"dataType":"string","paramType":"query"},{"name":"contentProvider","description":"Return results from a specific ContentProvider","required":false,"dataType":"string","paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","paramType":"query"},{"name":"internalDataStore","description":"Specify the internal storage engine.","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"exampleSearchResults","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"Examples","summary":"Returns examples for a word","suggestedName":"getExamples","deprecated":false,"open":false,"httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to fetch examples for","required":true,"dataType":"string","paramType":"path"},{"description":"Search definition object","required":false,"dataType":"ExampleSearchQuery","paramType":"body"},{"name":"internalDataStore","description":"Specify the internal storage engine.","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"exampleSearchResults","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"Examples","summary":"Fetches examples for a word","suggestedName":"getExamplesPost","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/word.{format}/{word}/wordForms","description":"","operations":[{"parameters":[{"name":"word","description":"Word to add forms for","required":false,"dataType":"string","paramType":"path"},{"description":"RelationshipMapWord to add","required":false,"dataType":"suggestion","paramType":"body"},{"name":"canonical","description":"Make this the Canonical form of the word.","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"condition":"any"}],"category":"WordDetails","summary":"Adds a Relationship Map to a word","suggestedName":"addWordForm","deprecated":false,"open":false,"httpMethod":"POST"},{"parameters":[{"name":"word","description":"Word to fetch forms for","required":true,"dataType":"string","paramType":"path"},{"name":"useCanonical","description":"If true will try to return a correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"relationshipMap","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"condition":"any"}],"category":"WordDetails","summary":"Returns other forms of a word","suggestedName":"getWordForms","deprecated":false,"open":false,"httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to delete forms from","required":false,"dataType":"string","paramType":"path"},{"name":"type","description":"Relationship type to delete","required":false,"dataType":"string","paramType":"query"},{"name":"word","description":"Target word to remove relationship from.","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"condition":"any"}],"category":"WordDetails","summary":"Deletes a relationship from a word","suggestedName":"deleteWordForm","deprecated":false,"open":false,"httpMethod":"DELETE"}]},{"path":"/word.{format}/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"String value of WordObject to return","required":true,"dataType":"string","paramType":"path"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","paramType":"query"},{"name":"includeSuggestions","description":"Return suggestions (for correct spelling, case variants, etc.)","required":false,"dataType":"string","paramType":"query"},{"name":"shouldCreate","description":"Create word if not existing","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"wordObject","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Given a word as a string, returns the WordObject that represents it","suggestedName":"getWord","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/definitions","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return definitions for","required":true,"dataType":"string","paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"},{"name":"partOfSpeech","description":"CSV list of part-of-speech types","required":false,"dataType":"string","allowableValues":"noun,adjective,verb,adverb,interjection,pronoun,preposition,abbreviation,affix,article,auxiliary-verb,conjunction,definite-article,family-name,given-name,idiom,imperative,noun-plural,noun-posessive,past-participle,phrasal-prefix,proper-noun,proper-noun-plural,proper-noun-posessive,suffix,verb-intransitive,verb-transitive","paramType":"query"},{"name":"includeRelated","description":"Return related words with definitions","required":false,"dataType":"string","allowableValues":"true,false","paramType":"query"},{"name":"sourceDictionaries","description":"Gets from dictionaries in the supplied order of precedence","required":false,"dataType":"string","allowableValues":"ahd, century, wiktionary, webster, wordnet","paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":"false,true","paramType":"query"},{"name":"includeTags","description":"Return a closed set of XML tags in response","required":false,"dataType":"string","allowableValues":"false,true","paramType":"query"}],"response":[{"valueType":"List[definition]","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No definitions found.","code":404}],"condition":"any"}],"category":"DictionaryInfo","summary":"Return definitions for a word","suggestedName":"getDefinitions","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/stats","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return stats for","required":false,"dataType":"string","paramType":"path"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","paramType":"query"},{"name":"detailed","description":"Return detailed usage info","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"wordStats","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No stats available.","code":404}],"condition":"any"}],"category":"Statistics","summary":"Returns word statistics","suggestedName":"getWordStats","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word","description":"","operations":[{"response":[{"valueType":"doc","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Help","summary":"Returns information about API parameters","suggestedName":"getHelp","deprecated":false,"open":true,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/topExample","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch examples for","required":true,"dataType":"string","paramType":"path"},{"name":"contentProvider","description":"Return results from a specific ContentProvider","required":false,"dataType":"string","paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","paramType":"query"},{"name":"internalDataStore","description":"Specify the internal storage engine.","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"example","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"Examples","summary":"Returns a top example for a word","suggestedName":"getTopExample","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/punctuationFactor","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","paramType":"path"},{"name":"caseSensitive","description":"Input is case sensitive","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"punctuationFactor","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"condition":"any"}],"category":"DeprecatedApis","summary":"Fetches other forms of a word","suggestedName":"getPunctuationFactor","deprecated":false,"open":false,"notes":"Deprecated","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/contextualLookup","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return definitions for","required":true,"dataType":"string","paramType":"path"},{"name":"sentence","description":"The sentence in which the word occurs","required":true,"dataType":"string","paramType":"query"},{"name":"offset","defaultValue":"-1","description":"The start character offset of the word in the given sentence","required":false,"dataType":"int","allowableValues":"0 to 4096","paramType":"query"},{"name":"expandTerms","description":"Expand context terms using related words","required":false,"dataType":"string","allowableValues":"true,false","paramType":"query"},{"name":"includeSourceDictionaries","description":"Only include these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":"ahd, century, wiktionary, webster, wordnet","paramType":"query"},{"name":"excludeSourceDictionaries","description":"Exclude these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":"ahd, century, wiktionary, webster, wordnet","paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":"0 to 1000","paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":"1 to 1000","paramType":"query"}],"response":[{"valueType":"DefinitionSearchResults","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"DictionaryInfo","summary":"Returns definitions for a word based on the sentence in which it is found","suggestedName":"contextualLookup","deprecated":false,"open":false,"notes":"Use the offset parameter when the word occurs more than once in the sentence","httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to return definitions for","required":true,"dataType":"string","paramType":"path"},{"description":"The sentence in which the word occurs","required":true,"dataType":"string","paramType":"body"},{"name":"offset","defaultValue":"-1","description":"The start character offset of the word in the given sentence","required":false,"dataType":"int","allowableValues":"0 to 4096","paramType":"query"},{"name":"expandTerms","description":"Expand context terms using related words","required":false,"dataType":"string","allowableValues":"true,false","paramType":"query"},{"name":"includeSourceDictionaries","description":"Only include these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":"ahd, century, wiktionary, webster, wordnet","paramType":"query"},{"name":"excludeSourceDictionaries","description":"Exclude these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":"ahd, century, wiktionary, webster, wordnet","paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":"0 to 1000","paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":"1 to 1000","paramType":"query"}],"response":[{"valueType":"DefinitionSearchResults","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"condition":"any"}],"category":"DictionaryInfo","summary":"Returns definitions for a word based on the sentence in which it is found","suggestedName":"contextualLookupPost","deprecated":false,"open":false,"notes":"Use the offset parameter when the word occurs more than once in the sentence","httpMethod":"POST"}]},{"path":"/word.{format}/{word}/commentCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get comment count for.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"condition":"any"}],"category":"Comments","summary":"Returns the number of comments on a word","suggestedName":"getCommentCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/related","description":"","operations":[{"parameters":[{"name":"word","description":"Word for which to return related words","required":true,"dataType":"string","paramType":"path"},{"name":"partOfSpeech","description":"CSV list of part-of-speech types","required":false,"dataType":"string","allowableValues":"noun,adjective,verb,adverb,interjection,pronoun,preposition,abbreviation,affix,article,auxiliary-verb,conjunction,definite-article,family-name,given-name,idiom,imperative,noun-plural,noun-posessive,past-participle,phrasal-prefix,proper-noun,proper-noun-plural,proper-noun-posessive,suffix,verb-intransitive,verb-transitive","paramType":"query"},{"name":"sourceDictionary","description":"Get data from a single dictionary","required":false,"dataType":"string","allowableValues":"ahd, century, wiktionary, webster, wordnet","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":"false,true","paramType":"query"},{"name":"type","description":"Relationship type","required":false,"dataType":"string","allowableValues":"synonym,antonym,variant,equivalent,cross-reference,related-word,rhyme,form,etymologically-related-term,hypernym,hyponym,inflected-form,primary,same-context,verb-form,verb-stem,unknown","paramType":"query"}],"response":[{"valueType":"List[related]","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No definitions found.","code":404}],"condition":"any"}],"category":"DictionaryInfo","summary":"Return related words (thesaurus data) for a word","suggestedName":"getRelatedWords","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/listedIn","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch WordLists for","required":false,"dataType":"string","paramType":"path"},{"name":"sortBy","description":"Specifies a sort parameter","required":false,"dataType":"string","allowableValues":"rating","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"},{"name":"username","description":"User to scope the request to","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[wordList]","errorResponses":[{"reason":"Invalid word supplied","code":400},{"reason":"Supplied user does not exist","code":404}],"condition":"any"}],"category":"WordListMethods","summary":"Returns WordLists containing a word","suggestedName":"getListedIn","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/listedInCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch count for","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"condition":"any"}],"category":"WordListMethods","summary":"Returns a count of lists a word appears in","suggestedName":"getListedInCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/firstListedIn","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch a WordList for","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"wordList","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"condition":"any"}],"category":"WordListMethods","summary":"Returns the first WordList a word appeared in","suggestedName":"getFirstListedIn","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/firstListedBy","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch a User for","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"user","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"condition":"any"}],"category":"WordListMethods","summary":"Returns the first User to list a particular word","suggestedName":"getFirstListedBy","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/pronunciations","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get pronunciations for","required":true,"dataType":"string","paramType":"path"},{"name":"useCanonical","description":"If true will try to return a correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary.","required":false,"dataType":"string","allowableValues":"ahd,century,cmu,macmillan,wiktionary,webster,wordnet","paramType":"query"},{"name":"typeFormat","description":"Text pronunciation type","required":false,"dataType":"string","allowableValues":"ahd,arpabet,gcide-diacritical,IPA","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[textPron]","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Returns text pronunciations for a given word","suggestedName":"getTextPronunciations","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/images/flickr","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get flickr images for.","required":false,"dataType":"string","paramType":"path"},{"name":"size","description":"Image size","required":false,"dataType":"string","allowableValues":"thumb,small,med,lg,orig","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[photo]","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Returns Flickr images for a word","suggestedName":"getFlickrImages","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/scrabbleScore","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get scrabble score for.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No scrabble score found.","code":404}],"condition":"any"}],"category":"WordDetails","summary":"Returns the Scrabble score for a word","suggestedName":"getScrabbleScore","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/citations","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get citations for.","required":false,"dataType":"string","paramType":"path"},{"name":"useCanonical","description":"If true will try to return a correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary. Valid options: ahd, century, wiktionary, webster, and wordnet.","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[citation]","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Returns citations for a word","suggestedName":"getCitations","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/hyphenation","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get syllables for","required":true,"dataType":"string","paramType":"path"},{"name":"useCanonical","description":"If true will try to return a correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary. Valid options: ahd, century, wiktionary, webster, and wordnet.","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[syllable]","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Returns syllable information for a word","suggestedName":"getHyphenation","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/unigramCountInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get unigram count for.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Returns syllable information for a word","suggestedName":"getUnigramCountInternal","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/phrasesInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get bigrams for.","required":false,"dataType":"string","paramType":"path"},{"name":"gamma","description":"Gamma filter","required":false,"dataType":"string","paramType":"query"},{"name":"minWlmi","description":"WLMI Limit","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[bigram]","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Returns Bigrams for the given word","suggestedName":"getBigramsInternal","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/lookupCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get Bigrams for","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"condition":"any"}],"category":"WordDetails","summary":"Returns the number of times a word has been viewed","suggestedName":"getLookupCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/tags","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch Tags on","required":false,"dataType":"string","paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","paramType":"query"},{"name":"username","description":"Restrict to a particular user","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[tag]","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"Tags","summary":"Fetches tags for a word","suggestedName":"getTagsOnWord","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/tagCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch Tag count on","required":false,"dataType":"string","paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","paramType":"query"},{"name":"username","description":"Restrict to a particular user","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"Tags","summary":"Fetches tag count for a word","suggestedName":"getTagCountOnWord","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/tag","description":"","operations":[{"parameters":[{"name":"word","description":"Word to add a Tag to","required":false,"dataType":"string","paramType":"path"},{"name":"tags","description":"CSV list of tags to add.","required":false,"dataType":"string","paramType":"query"},{"name":"username","description":"Add tag on behalf of a particular user","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"Tags","summary":"Adds a tag to a word","suggestedName":"addTagToWord","deprecated":false,"open":false,"httpMethod":"POST"},{"parameters":[{"name":"word","description":"Word to add a Tag to","required":false,"dataType":"string","paramType":"path"},{"name":"tags","description":"CSV list of tags to remove.","required":false,"dataType":"string","paramType":"query"},{"name":"username","description":"Remove tag on behalf of a particular user","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"Tags","summary":"Removes a tag from a word","suggestedName":"deleteTagFromWord","deprecated":false,"open":false,"httpMethod":"DELETE"}]},{"path":"/word.{format}/{word}/frequency","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","paramType":"path"},{"name":"caseSensitive","description":"Input is case sensitive","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","paramType":"query"},{"name":"startYear","description":"Starting Year","required":false,"dataType":"string","paramType":"query"},{"name":"endYear","description":"Ending Year","required":false,"dataType":"string","paramType":"query"},{"name":"includeErrorBars","description":"Get error bar data","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"frequencySummary","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"condition":"any"},{"valueType":"frequencySummaryE","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"condition":"errorBars=true"}],"category":"Statistics","summary":"Returns word usage over time","suggestedName":"getWordFrequency","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/firstUsed","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return first usage for","required":false,"dataType":"string","paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","paramType":"query"},{"name":"detailed","description":"Return detailed usage info","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"detailedWordUsage","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"detailed=true"},{"valueType":"basicWordUsage","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"detailed=false"}],"category":"Statistics","summary":"Returns first usage of a word","suggestedName":"getFirstUsageOfWord","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/wordView","description":"","operations":[{"parameters":[{"name":"word","description":"Word to record a word view for","required":false,"dataType":"string","paramType":"path"},{"name":"userId","description":"ID of the user viewing the word","required":false,"dataType":"string","paramType":"query"},{"name":"userGuid","description":"Tracking ID for the user","required":false,"dataType":"string","paramType":"query"},{"name":"userSessionId","description":"Session ID for the user","required":false,"dataType":"string","paramType":"query"},{"name":"serverIp","description":"Internal IP address of the web server","required":false,"dataType":"string","paramType":"query"},{"name":"pageName","description":"Page being viewed","required":false,"dataType":"string","paramType":"query"},{"name":"method","description":"Method of the word view","required":false,"dataType":"string","paramType":"query"},{"name":"userAgent","description":"Browser user agent","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"Statistics","summary":"Records a word view from the website","suggestedName":"addWordView","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/word.{format}/{word}/isFavorite","description":"","operations":[{"parameters":[{"name":"word","description":"Word to check","required":false,"dataType":"string","paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","paramType":"query"},{"name":"userName","description":"Check for a particular user","required":true,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"BooleanValue","errorResponses":[{"reason":"Invalid word supplied","code":400},{"reason":"No user found","code":404}],"condition":"any"}],"category":"Favorites","summary":"Checks to see if a word is a user's favorite","suggestedName":"isFavorite","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/favoriteCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to check","required":false,"dataType":"string","paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","paramType":"query"},{"name":"userName","description":"Check for a particular user","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid word supplied","code":400},{"reason":"No user found","code":404}],"condition":"any"}],"category":"Favorites","summary":"Returns the number of times a word has been Favorited","suggestedName":"getFavoriteCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/favorite","description":"","operations":[{"parameters":[{"name":"word","description":"Word to favorite","required":false,"dataType":"string","paramType":"path"},{"name":"userName","description":"Add as favorite on behalf of a particular user","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No user found","code":404}],"condition":"any"}],"category":"Favorites","summary":"Favorites a Word for a user","suggestedName":"addWordToFavorites","deprecated":false,"open":false,"httpMethod":"POST"},{"parameters":[{"name":"word","description":"Word to remove","required":false,"dataType":"string","paramType":"path"},{"name":"userName","description":"Remove on behalf of a particular user","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid word supplied or no user found.","code":400}],"condition":"any"}],"category":"Favorites","summary":"Removes a Word from a user's Favorites","suggestedName":"deleteFromFavorites","deprecated":false,"open":false,"httpMethod":"DELETE"}]},{"path":"/word.{format}/{word}/phrases","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch phrases for","required":true,"dataType":"string","paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"},{"name":"wlmi","description":"Minimum WLMI for the phrase","required":false,"dataType":"string","paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[bigram]","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"Examples","summary":"Fetches bi-gram phrases for a word","suggestedName":"getPhrases","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/etymologies","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":false,"dataType":"string","paramType":"path"},{"name":"sourceDictionary","description":"Get etymologies from a single dictionary. Options are ahd or century.","required":false,"dataType":"string","allowableValues":"ahd,webster,wiktionary","paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":"false,true","paramType":"query"},{"name":"type","description":"Etymology type","required":false,"dataType":"string","allowableValues":"ahd,webster,wiktionary","paramType":"query"}],"response":[{"valueType":"String","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No definitions found.","code":404}],"condition":"any"}],"category":"DictionaryInfo","summary":"Fetches etymology data","suggestedName":"getEtymologies","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/otherFormsInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":false,"dataType":"string","paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"},{"name":"minFrequency","description":"Minimum corpus frequency","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[otherForms]","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"DeprecatedApis","summary":"Fetches other forms of a word","suggestedName":"getOtherFormsInternal","deprecated":false,"open":false,"notes":"Deprecated","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/wordRelationshipInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":false,"dataType":"string","paramType":"path"},{"description":"Relationship to add","required":false,"dataType":"relatedData","paramType":"body"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"condition":"any"}],"category":"DeprecatedApis","summary":"Adds a word relationship","suggestedName":"addWordRelationshipInternal","deprecated":false,"open":false,"notes":"Deprecated","httpMethod":"POST"}]},{"path":"/word.{format}/{word}/comments","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return Comments for","required":false,"dataType":"string","paramType":"path"},{"name":"sortOrder","defaultValue":"descending","description":"Direction to sort by","required":false,"dataType":"string","allowableValues":"ascending,descending","paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[comment]","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"Comments","summary":"Fetches comments on a Word","suggestedName":"getCommentsOnWord","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/word.{format}/{word}/comment/{commentId}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch Comment for.","required":false,"dataType":"string","paramType":"path"},{"name":"commentId","description":"ID of Comment to fetch.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"comment","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"condition":"any"}],"category":"Comments","summary":"Fetches a Comment by ID","suggestedName":"deleteCommentOnWord","deprecated":false,"open":false,"httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to update Comment on.","required":false,"dataType":"string","paramType":"path"},{"name":"commentId","description":"Updated Comment.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"condition":"any"}],"category":"Comments","summary":"Deletes an existing word comment","suggestedName":"deleteCommentByIdOnWord","deprecated":false,"open":false,"httpMethod":"DELETE"}]},{"path":"/word.{format}/{word}/comment","description":"","operations":[{"parameters":[{"name":"word","description":"Word to add Comment to.","required":false,"dataType":"string","paramType":"path"},{"description":"Comment to add.","required":false,"dataType":"comment","paramType":"body"}],"response":[{"valueType":"comment","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"condition":"any"}],"category":"Comments","summary":"Adds a comment to a word","suggestedName":"commentOnWord","deprecated":false,"open":false,"httpMethod":"POST"},{"parameters":[{"name":"word","description":"Word to update Comment on.","required":false,"dataType":"string","paramType":"path"},{"description":"Updated Comment.","required":false,"dataType":"comment","paramType":"body"}],"response":[{"valueType":"comment","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"condition":"any"}],"category":"Comments","summary":"Updates an existing word comment","suggestedName":"updateCommentOnWord","deprecated":false,"open":false,"httpMethod":"PUT"}]},{"path":"/word.{format}/{word}/audio","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get audio for.","required":true,"dataType":"string","paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","paramType":"query"},{"name":"v3Format","description":"Use the V3 api.","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[audioFile]","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"AudioInfo","summary":"Fetches audio metadata for a word.","suggestedName":"getAudio","deprecated":false,"open":false,"notes":"The metadata includes a time-expiring fileUrl which allows reading the audio file directly from the API.  Currently only audio pronunciations from the American Heritage Dictionary in mp3 format are supported.","httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to add audio to.","required":false,"dataType":"string","paramType":"path"},{"description":"AudioPon metadata to add.","required":false,"dataType":"audioObject","paramType":"body"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"AudioInfo","summary":"Creates AudioPron metadata","suggestedName":"addAudio","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/word.{format}/{word}/pronunciation/{pronId}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get audio for.","required":true,"dataType":"string","paramType":"path"},{"name":"pronId","description":"Id to get audio for.","required":true,"dataType":"string","paramType":"path"}],"response":[{"valueType":"audioFile","errorResponses":[{"reason":"Invalid pron id supplied.","code":400}],"condition":"any"}],"category":"AudioInfo","summary":"Fetches single audio pronunciation.","suggestedName":"getPronunciation","deprecated":false,"open":false,"notes":"The metadata includes a time-expiring fileUrl which allows reading the audio file directly from the API.    Currently only audio pronunciations from the American Heritage Dictionary in mp3 format are supported.","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/audioInternal","description":"","operations":[{"parameters":[{"name":"word","description":"audio object to update","required":false,"dataType":"string","paramType":"path"},{"description":"Updated metadata.","required":false,"dataType":"audioObject","internalDescription":"Only updates the comment and duration fields","paramType":"body"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"AudioInfo","summary":"Internal method to update an audio object","suggestedName":"updateAudioInternal","deprecated":false,"open":false,"httpMethod":"PUT"}]},{"path":"/word.{format}/{word}/audio/{audio_id}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to delete audio from.","required":false,"dataType":"string","paramType":"path"},{"name":"audio_id","description":"AudioPon metadata to add.","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Unauthorized.","code":401}],"condition":"any"}],"category":"AudioInfo","summary":"Deletes an AudioPron","suggestedName":"deleteAudio","deprecated":false,"open":false,"httpMethod":"DELETE"}]}],"models":[{"name":"BooleanValue","fields":[{"name":"value","required":false,"paramType":"boolean"}]},{"name":"note","fields":[{"name":"noteType","description":"Contains the type of note","required":false,"allowableValues":"x, y, z","internalDescription":"Need to replace x, y z","paramAccess":"open","paramType":"string"},{"name":"pos","required":false,"paramType":"int"},{"name":"value","required":false,"paramType":"string"},{"name":"appliesTo","required":false,"paramType":"List[string]"}]},{"name":"long","fields":[{"name":"value","required":false,"paramType":"long"}]},{"name":"object","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"fields","required":false,"paramType":"List[parameter]"},{"name":"uniqueFieldName","required":false,"paramType":"string"}]},{"name":"header","fields":[{"name":"type","required":false,"paramType":"type"},{"name":"position","required":false,"paramType":"integer"},{"name":"word","required":false,"paramType":"string"},{"name":"textPron","required":false,"wrapperName":"textProns","paramType":"List[textPron]"},{"name":"partOfSpeech","required":false,"paramType":"string"},{"name":"note","required":false,"wrapperName":"notes","paramType":"List[note]"},{"name":"syllable","required":false,"wrapperName":"syllables","paramType":"List[syllable]"},{"name":"sourceDictionary","required":false,"paramType":"string"},{"name":"homograph","required":false,"paramType":"string"},{"name":"derivativeSense","required":false,"paramType":"string"},{"name":"derivedFrom","required":false,"paramType":"string"},{"name":"etymologyXml","required":false,"paramType":"string"}]},{"name":"contentProvider","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"frequency","fields":[{"name":"year","required":false,"paramType":"int"},{"name":"count","required":false,"paramType":"long"}]},{"name":"doc","fields":[{"name":"endPoints","required":false,"paramType":"List[endpoint]"},{"name":"models","required":false,"paramType":"List[object]"}]},{"name":"frequencySummary","fields":[{"name":"word","required":false,"paramType":"string"},{"name":"totalCount","required":false,"paramType":"long"},{"name":"frequency","required":false,"paramType":"List[frequency]"},{"name":"unknownYearCount","required":false,"paramType":"int"}]},{"name":"detailedWordUsage","fields":[{"name":"wordstring","required":false,"paramType":"string"},{"name":"sentence","required":false,"paramType":"sentence"},{"name":"metadata","required":false,"paramType":"documentMetadata"}]},{"name":"citation","fields":[{"name":"source","required":false,"paramType":"string"},{"name":"cite","required":false,"paramType":"string"}]},{"name":"audioType","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"otherForms","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"wordString","required":false,"paramType":"string"},{"name":"totalCount","required":false,"paramType":"long"},{"name":"plain","required":false,"paramType":"string"},{"name":"wordId","required":false,"paramType":"long"}]},{"name":"endpoint","fields":[{"name":"path","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"operations","required":false,"paramType":"List[operation]"}]},{"name":"facet","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"facetValue","required":false,"wrapperName":"facetValues","paramType":"List[facetValue]"}]},{"name":"wordObject","fields":[{"name":"word","required":false,"paramType":"string"},{"name":"vulgar","required":false,"paramType":"string"}]},{"name":"relationshipMap","fields":[{"name":"sourceWordstring","required":false,"paramType":"string"},{"name":"suggestion","required":false,"wrapperName":"suggestions","paramType":"List[suggestion]"}]},{"name":"comment","fields":[{"name":"objectType","required":false,"paramType":"string"},{"name":"objectId","required":false,"paramType":"long"},{"name":"commentedBy","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"updatedAt","required":false,"paramType":"Date"},{"name":"commentedOn","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"string"},{"name":"body","required":false,"paramType":"string"}]},{"name":"exampleSearchResults","fields":[{"name":"facet","required":false,"wrapperName":"facets","paramType":"List[facet]"},{"name":"example","required":false,"wrapperName":"examples","paramType":"List[example]"}]},{"name":"partOfSpeech","fields":[{"name":"roots","required":false,"paramType":"List[root]"}]},{"name":"sizes","fields":[{"name":"size","required":false,"paramType":"List[size]"}]},{"name":"Label","fields":[{"name":"type","required":false,"paramType":"string"},{"name":"text","required":false,"paramType":"string"}]},{"name":"audioFile","fields":[{"name":"id","required":true,"paramType":"long"},{"name":"description","required":false,"paramType":"string"},{"name":"duration","required":false,"paramType":"double"},{"name":"word","required":false,"paramType":"string"},{"name":"createdBy","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"commentCount","required":false,"paramType":"int"},{"name":"voteCount","required":false,"paramType":"integer"},{"name":"voteAverage","required":false,"paramType":"float"},{"name":"voteWeightedAverage","required":false,"paramType":"float"},{"name":"fileUrl","required":false,"paramType":"string"},{"name":"audioType","required":false,"paramType":"string"}]},{"name":"parameter","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"defaultValue","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"required","required":false,"paramType":"boolean"},{"name":"dataType","required":false,"paramType":"string"},{"name":"allowableValues","required":false,"paramType":"string"},{"name":"wrapperName","required":false,"paramType":"string"},{"name":"internalDescription","required":false,"paramType":"string"},{"name":"paramAccess","required":false,"paramType":"string"},{"name":"paramType","required":false,"paramType":"string"}]},{"name":"DefinitionSearchResults","fields":[{"name":"totalResults","required":false,"paramType":"int"},{"name":"result","required":false,"wrapperName":"results","paramType":"List[definition]"}]},{"name":"frequencyElement","fields":[{"name":"year","required":false,"paramType":"int"},{"name":"lowerWisker","required":false,"paramType":"double"},{"name":"upperWisker","required":false,"paramType":"double"},{"name":"lowerBox","required":false,"paramType":"double"},{"name":"upperBox","required":false,"paramType":"double"}]},{"name":"tag","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"long"},{"name":"count","required":false,"paramType":"long"}]},{"name":"example","fields":[{"name":"year","required":false,"paramType":"integer"},{"name":"provider","required":false,"paramType":"contentProvider"},{"name":"url","required":false,"paramType":"string"},{"name":"word","required":false,"paramType":"string"},{"name":"text","required":false,"paramType":"string"},{"name":"title","required":false,"paramType":"string"},{"name":"rating","required":false,"paramType":"float"},{"name":"exampleId","required":false,"paramType":"long"},{"name":"documentId","required":false,"paramType":"long"}]},{"name":"definition","fields":[{"name":"exampleUsage","required":false,"wrapperName":"exampleUses","paramType":"List[ExampleUsage]"},{"name":"word","required":false,"paramType":"string"},{"name":"text","required":false,"paramType":"string"},{"name":"textPron","required":false,"wrapperName":"textProns","paramType":"List[textPron]"},{"name":"score","required":false,"paramType":"float"},{"name":"partOfSpeech","required":false,"paramType":"string"},{"name":"note","required":false,"wrapperName":"notes","paramType":"List[note]"},{"name":"citation","required":false,"wrapperName":"citations","paramType":"List[citation]"},{"name":"relWord","required":false,"wrapperName":"relatedWords","paramType":"List[related]"},{"name":"sourceDictionary","required":false,"paramType":"string"},{"name":"label","required":false,"wrapperName":"labels","paramType":"List[Label]"},{"name":"sequence","required":false,"paramType":"string"},{"name":"seqString","required":false,"paramType":"string"},{"name":"extendedText","required":false,"paramType":"string"}]},{"name":"photo","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"owner","required":false,"paramType":"string"},{"name":"server","required":false,"paramType":"int"},{"name":"title","required":false,"paramType":"string"},{"name":"ownername","required":false,"paramType":"string"},{"name":"secret","required":false,"paramType":"string"},{"name":"farm","required":false,"paramType":"int"},{"name":"ispublic","required":false,"paramType":"int"},{"name":"isfriend","required":false,"paramType":"int"},{"name":"isfamily","required":false,"paramType":"int"},{"name":"ownerLink","required":false,"paramType":"string"},{"name":"linkUri","required":false,"paramType":"string"},{"name":"size","required":false,"paramType":"size"}]},{"name":"basicWordUsage","fields":[{"name":"year","required":false,"paramType":"integer"},{"name":"wordstring","required":false,"paramType":"string"},{"name":"documentId","required":false,"paramType":"long"},{"name":"sentenceId","required":false,"paramType":"long"}]},{"name":"response","fields":[{"name":"valueType","required":false,"paramType":"string"},{"name":"errorResponses","required":false,"paramType":"List[error]"},{"name":"occurs","required":false,"paramType":"string"},{"name":"condition","required":false,"paramType":"string"}]},{"name":"ExampleUsage","fields":[{"name":"text","required":false,"paramType":"string"}]},{"name":"entry","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"header","required":false,"paramType":"header"},{"name":"word","required":false,"paramType":"string"},{"name":"note","required":false,"wrapperName":"notes","paramType":"List[note]"},{"name":"definition","required":false,"wrapperName":"definitions","paramType":"List[definition]"},{"name":"syll","required":false,"wrapperName":"syllabified","paramType":"List[syllable]"},{"name":"relWord","required":false,"wrapperName":"relatedWords","paramType":"List[related]"},{"name":"sourceDictionary","required":false,"paramType":"string"}]},{"name":"scoredWord","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"wordType","required":false,"paramType":"string"},{"name":"position","required":false,"paramType":"int"},{"name":"word","required":false,"paramType":"string"},{"name":"score","required":false,"paramType":"float"},{"name":"sentenceId","required":false,"paramType":"long"},{"name":"partOfSpeech","required":false,"paramType":"string"}]},{"name":"operation","fields":[{"name":"parameters","required":false,"paramType":"List[parameter]"},{"name":"response","required":false,"paramType":"List[response]"},{"name":"category","required":false,"paramType":"string"},{"name":"summary","required":false,"paramType":"string"},{"name":"suggestedName","required":false,"paramType":"string"},{"name":"deprecated","required":false,"paramType":"boolean"},{"name":"open","required":false,"paramType":"boolean"},{"name":"notes","required":false,"paramType":"string"},{"name":"httpMethod","required":false,"paramType":"string"}]},{"name":"facetValue","fields":[{"name":"value","required":false,"paramType":"string"},{"name":"count","required":false,"paramType":"long"}]},{"name":"sentence","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"scoredWord","required":false,"wrapperName":"scoredWords","paramType":"List[scoredWord]"},{"name":"display","required":false,"paramType":"string"},{"name":"documentMetadataId","required":false,"paramType":"long"},{"name":"rating","required":false,"paramType":"int"}]},{"name":"error","fields":[{"name":"reason","required":false,"paramType":"string"},{"name":"code","required":false,"paramType":"int"}]},{"name":"type","fields":[{"name":"typeId","required":false,"paramType":"int"},{"name":"text","required":false,"paramType":"string"},{"name":"enteredAt","required":false,"paramType":"string"},{"name":"mapping","required":false,"paramType":"long"}]},{"name":"punctuationFactor","fields":[{"name":"totalCount","required":false,"paramType":"long"},{"name":"wordId","required":false,"paramType":"long"},{"name":"periodCount","required":false,"paramType":"long"},{"name":"exclamationPointCount","required":false,"paramType":"long"},{"name":"questionMarkCount","required":false,"paramType":"long"}]},{"name":"bigram","fields":[{"name":"count","required":false,"paramType":"long"},{"name":"gram1","required":false,"paramType":"string"},{"name":"gram2","required":false,"paramType":"string"},{"name":"mi","required":false,"paramType":"double"},{"name":"wlmi","required":false,"paramType":"double"}]},{"name":"related","fields":[{"name":"word","required":false,"wrapperName":"words","paramType":"List[string]"},{"name":"relationshipType","required":false,"paramType":"string"},{"name":"label1","required":false,"paramType":"string"},{"name":"label2","required":false,"paramType":"string"},{"name":"label3","required":false,"paramType":"string"},{"name":"label4","required":false,"paramType":"string"},{"name":"gram","required":false,"paramType":"string"}]},{"name":"documentMetadata","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"year","required":false,"paramType":"integer"},{"name":"contentType","required":false,"paramType":"contentType"},{"name":"provider","required":false,"paramType":"contentProvider"},{"name":"tag","required":false,"wrapperName":"tags","paramType":"List[string]"},{"name":"title","required":false,"paramType":"string"},{"name":"rating","required":false,"paramType":"double"},{"name":"medium","required":false,"paramType":"documentMedium"},{"name":"sourceUrl","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"stats","required":false,"paramType":"basicDocumentStats"},{"name":"date","required":false,"paramType":"Date"},{"name":"classification","required":false,"paramType":"subjectClassificationType"},{"name":"yearType","required":false,"paramType":"yearType"},{"name":"primaryAuthor","required":false,"paramType":"string"},{"name":"primaryAuthorType","required":false,"paramType":"authorType"},{"name":"primaryAuthorId","required":false,"paramType":"long"},{"name":"guid","required":false,"paramType":"string"},{"name":"extendedMetadata","required":false,"paramType":"extendedMetadata"},{"name":"author","required":false,"wrapperName":"authors","paramType":"List[author]"},{"name":"expirationDate","required":false,"paramType":"Date"}]},{"name":"frequencySummaryE","fields":[{"name":"elements","required":false,"paramType":"List[frequencyElement]"}]},{"name":"wordStats","fields":[{"name":"wordstring","required":false,"paramType":"string"},{"name":"sentencesCount","required":false,"paramType":"long"},{"name":"documentsCount","required":false,"paramType":"long"},{"name":"frequencyStats","required":false,"paramType":"frequencyStats"},{"name":"dictionaryStats","required":false,"paramType":"Map[string,dictionaryWordStats]"},{"name":"partOfSpeechStats","required":false,"paramType":"Map[string,integer]"}]},{"name":"syllable","fields":[{"name":"type","required":false,"paramType":"string"},{"name":"seq","required":false,"paramType":"int"},{"name":"text","required":false,"paramType":"string"}]},{"name":"textPron","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"seq","required":false,"paramType":"int"},{"name":"raw","required":false,"paramType":"string"},{"name":"rawType","required":false,"paramType":"string"}]},{"name":"wordList","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"long"},{"name":"type","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"userId","required":false,"paramType":"long"},{"name":"permalink","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"username","required":false,"paramType":"string"},{"name":"updatedAt","required":false,"paramType":"Date"},{"name":"numberWordsInList","required":false,"paramType":"long"}]},{"name":"frequencyStats","fields":[{"name":"corpusCount","required":false,"paramType":"long"},{"name":"yearWise","required":false,"paramType":"Map[integer,long]"},{"name":"contentType","required":false,"paramType":"Map[integer,long]"},{"name":"contentProvider","required":false,"paramType":"Map[integer,long]"},{"name":"medium","required":false,"paramType":"Map[integer,long]"},{"name":"subject","required":false,"paramType":"Map[integer,long]"},{"name":"author","required":false,"paramType":"Map[long,long]"}]},{"name":"suggestion","fields":[{"name":"type","required":false,"paramType":"int"},{"name":"wordstring","required":false,"paramType":"string"}]},{"name":"user","fields":[{"name":"id","description":"Unique idenitifier for a user","required":false,"paramType":"long"},{"name":"displayName","description":"Display name","required":false,"paramType":"string"},{"name":"status","description":"Account status","required":false,"allowableValues":"0,1,2,3","paramType":"int"},{"name":"password","required":false,"paramType":"string"},{"name":"userName","description":"User name","required":false,"paramType":"string"},{"name":"email","description":"Email address","required":false,"paramType":"string"},{"name":"faceBookId","description":"Facebook ID","required":false,"paramType":"string"}]}]}
+{"resourcePath":"/word","models":{"sizes":{"properties":{"size":{"type":"array","required":false,"items":{"$ref":"size","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"sizes","type":"any","required":false,"uniqueItems":false},"facet":{"properties":{"facetValue":{"type":"array","required":false,"items":{"$ref":"facetValue","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"facet","type":"any","required":false,"uniqueItems":false},"detailedWordUsage":{"properties":{"sentence":{"type":"sentence","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false},"metadata":{"type":"documentMetadata","required":false,"uniqueItems":false}},"id":"detailedWordUsage","type":"any","required":false,"uniqueItems":false},"root":{"properties":{"name":{"type":"string","required":false,"uniqueItems":false},"categories":{"type":"array","required":false,"items":{"$ref":"category","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"root","type":"any","required":false,"uniqueItems":false},"tag":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"count":{"type":"long","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"tag","type":"any","required":false,"uniqueItems":false},"contentType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"contentType","type":"any","required":false,"uniqueItems":false},"long":{"properties":{"value":{"type":"long","required":false,"uniqueItems":false}},"id":"long","type":"any","required":false,"uniqueItems":false},"type":{"properties":{"enteredAt":{"type":"string","required":false,"uniqueItems":false},"text":{"type":"string","required":false,"uniqueItems":false},"mapping":{"type":"long","required":false,"uniqueItems":false},"typeId":{"type":"int","required":false,"uniqueItems":false}},"id":"type","type":"any","required":false,"uniqueItems":false},"documentMetadata":{"properties":{"yearType":{"type":"yearType","required":false,"uniqueItems":false},"expirationDate":{"type":"Date","required":false,"uniqueItems":false},"extendedMetadata":{"type":"extendedMetadata","required":false,"uniqueItems":false},"stats":{"type":"basicDocumentStats","required":false,"uniqueItems":false},"tag":{"type":"array","required":false,"items":{"type":"string","required":false,"uniqueItems":false},"uniqueItems":false},"provider":{"type":"contentProvider","required":false,"uniqueItems":false},"contentType":{"type":"contentType","required":false,"uniqueItems":false},"sourceUrl":{"type":"string","required":false,"uniqueItems":false},"date":{"type":"Date","required":false,"uniqueItems":false},"medium":{"type":"documentMedium","required":false,"uniqueItems":false},"guid":{"type":"string","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"author":{"type":"array","required":false,"items":{"$ref":"author","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"title":{"type":"string","required":false,"uniqueItems":false},"primaryAuthorType":{"type":"authorType","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"classification":{"type":"subjectClassificationType","required":false,"uniqueItems":false},"year":{"type":"integer","required":false,"uniqueItems":false},"primaryAuthor":{"type":"string","required":false,"uniqueItems":false},"rating":{"type":"double","required":false,"uniqueItems":false},"primaryAuthorId":{"type":"long","required":false,"uniqueItems":false}},"id":"documentMetadata","type":"any","required":false,"uniqueItems":false},"related":{"properties":{"label1":{"type":"string","required":false,"uniqueItems":false},"label2":{"type":"string","required":false,"uniqueItems":false},"relationshipType":{"type":"string","required":false,"uniqueItems":false},"label3":{"type":"string","required":false,"uniqueItems":false},"word":{"type":"array","required":false,"items":{"type":"string","required":false,"uniqueItems":false},"uniqueItems":false},"gram":{"type":"string","required":false,"uniqueItems":false},"label4":{"type":"string","required":false,"uniqueItems":false}},"id":"related","type":"any","required":false,"uniqueItems":false},"exampleSearchResults":{"properties":{"facet":{"type":"array","required":false,"items":{"$ref":"facet","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"example":{"type":"array","required":false,"items":{"$ref":"example","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"exampleSearchResults","type":"any","required":false,"uniqueItems":false},"BooleanValue":{"properties":{"value":{"type":"boolean","required":false,"uniqueItems":false}},"id":"BooleanValue","type":"any","required":false,"uniqueItems":false},"frequencyStats":{"properties":{"author":{"type":"Map[long,long]","required":false,"uniqueItems":false},"subject":{"type":"Map[integer,long]","required":false,"uniqueItems":false},"contentProvider":{"type":"Map[integer,long]","required":false,"uniqueItems":false},"contentType":{"type":"Map[integer,long]","required":false,"uniqueItems":false},"yearWise":{"type":"Map[integer,long]","required":false,"uniqueItems":false},"corpusCount":{"type":"long","required":false,"uniqueItems":false},"medium":{"type":"Map[integer,long]","required":false,"uniqueItems":false}},"id":"frequencyStats","type":"any","required":false,"uniqueItems":false},"wordStats":{"properties":{"dictionaryStats":{"type":"Map[string,dictionaryWordStats]","required":false,"uniqueItems":false},"documentsCount":{"type":"long","required":false,"uniqueItems":false},"sentencesCount":{"type":"long","required":false,"uniqueItems":false},"frequencyStats":{"type":"frequencyStats","required":false,"uniqueItems":false},"partOfSpeechStats":{"type":"Map[string,integer]","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false}},"id":"wordStats","type":"any","required":false,"uniqueItems":false},"RelatedDataSource":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"RelatedDataSource","type":"any","required":false,"uniqueItems":false},"audioObject":{"properties":{"recordId":{"type":"string","required":false,"uniqueItems":false},"wordId":{"type":"long","required":false,"uniqueItems":false},"audioFileType":{"type":"audioType","required":false,"uniqueItems":false},"filePath":{"type":"string","required":false,"uniqueItems":false},"type":{"type":"audioType","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"duration":{"type":"double","required":false,"uniqueItems":false},"createdBy":{"type":"string","required":false,"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"streamPath":{"type":"string","required":false,"uniqueItems":false},"audioFileId":{"type":"long","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false}},"id":"audioObject","type":"any","required":false,"uniqueItems":false},"citation":{"properties":{"cite":{"type":"string","required":false,"uniqueItems":false},"source":{"type":"string","required":false,"uniqueItems":false}},"id":"citation","type":"any","required":false,"uniqueItems":false},"relatedData":{"properties":{"direction":{"type":"string","required":false,"uniqueItems":false},"targetWordstring":{"type":"string","required":false,"uniqueItems":false},"frequency":{"type":"long","required":false,"uniqueItems":false},"sense":{"type":"integer","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"sourceWordstring":{"type":"string","required":false,"uniqueItems":false},"sourceWordId":{"type":"long","required":false,"uniqueItems":false},"relationshipType":{"type":"RelationshipType","required":false,"uniqueItems":false},"source":{"type":"RelatedDataSource","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"partOfSpeech":{"type":"string","required":false,"uniqueItems":false},"targetWordId":{"type":"long","required":false,"uniqueItems":false}},"id":"relatedData","type":"any","required":false,"uniqueItems":false},"punctuationFactor":{"properties":{"periodCount":{"type":"long","required":false,"uniqueItems":false},"exclamationPointCount":{"type":"long","required":false,"uniqueItems":false},"wordId":{"type":"long","required":false,"uniqueItems":false},"questionMarkCount":{"type":"long","required":false,"uniqueItems":false},"totalCount":{"type":"long","required":false,"uniqueItems":false}},"id":"punctuationFactor","type":"any","required":false,"uniqueItems":false},"subjectClassificationType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"subjectClassificationType","type":"any","required":false,"uniqueItems":false},"basicDocumentStats":{"properties":{"uniqueBiGramsCount":{"type":"long","required":false,"uniqueItems":false},"wordsCount":{"type":"long","required":false,"uniqueItems":false},"documentsCount":{"type":"long","required":false,"uniqueItems":false},"firstUsedWordsCount":{"type":"long","required":false,"uniqueItems":false},"tokensCount":{"type":"long","required":false,"uniqueItems":false},"sentencesCount":{"type":"long","required":false,"uniqueItems":false},"viableSentencesCount":{"type":"long","required":false,"uniqueItems":false},"type":{"type":"string","required":false,"uniqueItems":false},"uniqueWordsCount":{"type":"long","required":false,"uniqueItems":false},"key":{"type":"string","required":false,"uniqueItems":false}},"id":"basicDocumentStats","type":"any","required":false,"uniqueItems":false},"header":{"properties":{"position":{"type":"integer","required":false,"uniqueItems":false},"sourceDictionary":{"type":"string","required":false,"uniqueItems":false},"homograph":{"type":"string","required":false,"uniqueItems":false},"derivedFrom":{"type":"string","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"etymologyXml":{"type":"string","required":false,"uniqueItems":false},"derivativeSense":{"type":"string","required":false,"uniqueItems":false},"type":{"type":"type","required":false,"uniqueItems":false},"note":{"type":"array","required":false,"items":{"$ref":"note","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"syllable":{"type":"array","required":false,"items":{"$ref":"syllable","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"partOfSpeech":{"type":"string","required":false,"uniqueItems":false},"textPron":{"type":"array","required":false,"items":{"$ref":"textPron","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"header","type":"any","required":false,"uniqueItems":false},"facetValue":{"properties":{"count":{"type":"long","required":false,"uniqueItems":false},"value":{"type":"string","required":false,"uniqueItems":false}},"id":"facetValue","type":"any","required":false,"uniqueItems":false},"category":{"properties":{"name":{"type":"string","required":false,"uniqueItems":false}},"id":"category","type":"any","required":false,"uniqueItems":false},"RelationshipType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"RelationshipType","type":"any","required":false,"uniqueItems":false},"suggestion":{"properties":{"type":{"type":"int","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false}},"id":"suggestion","type":"any","required":false,"uniqueItems":false},"relationshipMap":{"properties":{"sourceWordstring":{"type":"string","required":false,"uniqueItems":false},"suggestion":{"type":"array","required":false,"items":{"$ref":"suggestion","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"relationshipMap","type":"any","required":false,"uniqueItems":false},"example":{"properties":{"exampleId":{"type":"long","required":false,"uniqueItems":false},"title":{"type":"string","required":false,"uniqueItems":false},"text":{"type":"string","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"provider":{"type":"contentProvider","required":false,"uniqueItems":false},"year":{"type":"integer","required":false,"uniqueItems":false},"rating":{"type":"float","required":false,"uniqueItems":false},"documentId":{"type":"long","required":false,"uniqueItems":false},"url":{"type":"string","required":false,"uniqueItems":false}},"id":"example","type":"any","required":false,"uniqueItems":false},"comment":{"properties":{"updatedAt":{"type":"Date","required":false,"uniqueItems":false},"id":{"type":"string","required":false,"uniqueItems":false},"body":{"type":"string","required":false,"uniqueItems":false},"commentedOn":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"objectId":{"type":"long","required":false,"uniqueItems":false},"commentedBy":{"type":"string","required":false,"uniqueItems":false},"objectType":{"type":"string","required":false,"uniqueItems":false}},"id":"comment","type":"any","required":false,"uniqueItems":false},"frequencySummary":{"properties":{"unknownYearCount":{"type":"int","required":false,"uniqueItems":false},"totalCount":{"type":"long","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"frequency":{"type":"array","required":false,"items":{"$ref":"frequency","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"frequencySummary","type":"any","required":false,"uniqueItems":false},"textPron":{"properties":{"raw":{"type":"string","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"seq":{"type":"int","required":false,"uniqueItems":false},"rawType":{"type":"string","required":false,"uniqueItems":false}},"id":"textPron","type":"any","required":false,"uniqueItems":false},"yearType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"yearType","type":"any","required":false,"uniqueItems":false},"extendedMetadata":{"properties":{"sourceFileSize":{"type":"long","required":false,"uniqueItems":false},"issn":{"type":"string","required":false,"uniqueItems":false},"isbn":{"type":"string","required":false,"uniqueItems":false},"lccn":{"type":"string","required":false,"uniqueItems":false},"documentMetadataId":{"type":"long","required":false,"uniqueItems":false}},"id":"extendedMetadata","type":"any","required":false,"uniqueItems":false},"sentence":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"display":{"type":"string","required":false,"uniqueItems":false},"rating":{"type":"int","required":false,"uniqueItems":false},"documentMetadataId":{"type":"long","required":false,"uniqueItems":false},"scoredWord":{"type":"array","required":false,"items":{"$ref":"scoredWord","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"sentence","type":"any","required":false,"uniqueItems":false},"documentMedium":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"documentMedium","type":"any","required":false,"uniqueItems":false},"frequency":{"properties":{"count":{"type":"long","required":false,"uniqueItems":false},"year":{"type":"int","required":false,"uniqueItems":false}},"id":"frequency","type":"any","required":false,"uniqueItems":false},"author":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"authorType":{"type":"authorType","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false},"uniqueName":{"type":"string","required":false,"uniqueItems":false}},"id":"author","type":"any","required":false,"uniqueItems":false},"bigram":{"properties":{"count":{"type":"long","required":false,"uniqueItems":false},"gram2":{"type":"string","required":false,"uniqueItems":false},"gram1":{"type":"string","required":false,"uniqueItems":false},"wlmi":{"type":"double","required":false,"uniqueItems":false},"mi":{"type":"double","required":false,"uniqueItems":false}},"id":"bigram","type":"any","required":false,"uniqueItems":false},"wordObject":{"properties":{"word":{"type":"string","required":false,"uniqueItems":false},"vulgar":{"type":"string","required":false,"uniqueItems":false}},"id":"wordObject","type":"any","required":false,"uniqueItems":false},"ExampleUsage":{"properties":{"text":{"type":"string","required":false,"uniqueItems":false}},"id":"ExampleUsage","type":"any","required":false,"uniqueItems":false},"ExampleSearchQuery":{"properties":{"limit":{"type":"int","required":false,"uniqueItems":false},"dateRange":{"type":"string","required":false,"uniqueItems":false},"subject":{"type":"string","required":false,"uniqueItems":false},"endDate":{"type":"Date","required":false,"uniqueItems":false},"contentType":{"type":"string","required":false,"uniqueItems":false},"skip":{"type":"int","required":false,"uniqueItems":false},"beginDate":{"type":"Date","required":false,"uniqueItems":false},"medium":{"type":"string","required":false,"uniqueItems":false},"wordType":{"type":"string","required":false,"uniqueItems":false},"contentProvider":{"type":"string","required":false,"uniqueItems":false},"year":{"type":"int","required":false,"uniqueItems":false},"wordString":{"type":"string","required":false,"uniqueItems":false},"filter":{"type":"string","required":false,"uniqueItems":false},"partOfSpeech":{"type":"string","required":false,"uniqueItems":false}},"id":"ExampleSearchQuery","type":"any","required":false,"uniqueItems":false},"note":{"properties":{"noteType":{"type":"string","required":false,"uniqueItems":false},"appliesTo":{"type":"array","required":false,"items":{"type":"string","required":false,"uniqueItems":false},"uniqueItems":false},"value":{"type":"string","required":false,"uniqueItems":false},"pos":{"type":"int","required":false,"uniqueItems":false}},"id":"note","type":"any","required":false,"uniqueItems":false},"wordList":{"properties":{"updatedAt":{"type":"Date","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"username":{"type":"string","required":false,"uniqueItems":false},"permalink":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false},"numberWordsInList":{"type":"long","required":false,"uniqueItems":false},"type":{"type":"string","required":false,"uniqueItems":false}},"id":"wordList","type":"any","required":false,"uniqueItems":false},"authorType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"authorType","type":"any","required":false,"uniqueItems":false},"definition":{"properties":{"extendedText":{"type":"string","required":false,"uniqueItems":false},"citation":{"type":"array","required":false,"items":{"$ref":"citation","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"text":{"type":"string","required":false,"uniqueItems":false},"sourceDictionary":{"type":"string","required":false,"uniqueItems":false},"exampleUsage":{"type":"array","required":false,"items":{"$ref":"ExampleUsage","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"relWord":{"type":"array","required":false,"items":{"$ref":"related","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"score":{"type":"float","required":false,"uniqueItems":false},"label":{"type":"array","required":false,"items":{"$ref":"Label","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"seqString":{"type":"string","required":false,"uniqueItems":false},"sequence":{"type":"string","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"note":{"type":"array","required":false,"items":{"$ref":"note","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"textPron":{"type":"array","required":false,"items":{"$ref":"textPron","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"partOfSpeech":{"type":"string","required":false,"uniqueItems":false}},"id":"definition","type":"any","required":false,"uniqueItems":false},"otherForms":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"wordId":{"type":"long","required":false,"uniqueItems":false},"totalCount":{"type":"long","required":false,"uniqueItems":false},"plain":{"type":"string","required":false,"uniqueItems":false},"wordString":{"type":"string","required":false,"uniqueItems":false}},"id":"otherForms","type":"any","required":false,"uniqueItems":false},"DefinitionSearchResults":{"properties":{"result":{"type":"array","required":false,"items":{"$ref":"definition","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"totalResults":{"type":"int","required":false,"uniqueItems":false}},"id":"DefinitionSearchResults","type":"any","required":false,"uniqueItems":false},"photo":{"properties":{"isfamily":{"type":"int","required":false,"uniqueItems":false},"ispublic":{"type":"int","required":false,"uniqueItems":false},"linkUri":{"type":"string","required":false,"uniqueItems":false},"isfriend":{"type":"int","required":false,"uniqueItems":false},"size":{"type":"size","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"farm":{"type":"int","required":false,"uniqueItems":false},"title":{"type":"string","required":false,"uniqueItems":false},"ownerLink":{"type":"string","required":false,"uniqueItems":false},"ownername":{"type":"string","required":false,"uniqueItems":false},"owner":{"type":"string","required":false,"uniqueItems":false},"secret":{"type":"string","required":false,"uniqueItems":false},"server":{"type":"int","required":false,"uniqueItems":false}},"id":"photo","type":"any","required":false,"uniqueItems":false},"scoredWord":{"properties":{"position":{"type":"int","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"wordType":{"type":"string","required":false,"uniqueItems":false},"score":{"type":"float","required":false,"uniqueItems":false},"sentenceId":{"type":"long","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"partOfSpeech":{"type":"string","required":false,"uniqueItems":false}},"id":"scoredWord","type":"any","required":false,"uniqueItems":false},"syllable":{"properties":{"text":{"type":"string","required":false,"uniqueItems":false},"seq":{"type":"int","required":false,"uniqueItems":false},"type":{"type":"string","required":false,"uniqueItems":false}},"id":"syllable","type":"any","required":false,"uniqueItems":false},"audioType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"audioType","type":"any","required":false,"uniqueItems":false},"contentProvider":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"contentProvider","type":"any","required":false,"uniqueItems":false},"entry":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"sourceDictionary":{"type":"string","required":false,"uniqueItems":false},"relWord":{"type":"array","required":false,"items":{"$ref":"related","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"definition":{"type":"array","required":false,"items":{"$ref":"definition","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"syll":{"type":"array","required":false,"items":{"$ref":"syllable","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"note":{"type":"array","required":false,"items":{"$ref":"note","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"header":{"type":"header","required":false,"uniqueItems":false}},"id":"entry","type":"any","required":false,"uniqueItems":false},"Label":{"properties":{"text":{"type":"string","required":false,"uniqueItems":false},"type":{"type":"string","required":false,"uniqueItems":false}},"id":"Label","type":"any","required":false,"uniqueItems":false},"ExampleDataStore":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"ExampleDataStore","type":"any","required":false,"uniqueItems":false},"user":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"email":{"type":"string","required":false,"uniqueItems":false},"status":{"type":"int","required":false,"uniqueItems":false},"faceBookId":{"type":"string","required":false,"uniqueItems":false},"userName":{"type":"string","required":false,"uniqueItems":false},"displayName":{"type":"string","required":false,"uniqueItems":false},"password":{"type":"string","required":false,"uniqueItems":false}},"id":"user","type":"any","required":false,"uniqueItems":false},"audioFile":{"properties":{"id":{"type":"long","required":true,"uniqueItems":false},"duration":{"type":"double","required":false,"uniqueItems":false},"createdBy":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"voteWeightedAverage":{"type":"float","required":false,"uniqueItems":false},"voteAverage":{"type":"float","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"commentCount":{"type":"int","required":false,"uniqueItems":false},"voteCount":{"type":"integer","required":false,"uniqueItems":false},"audioType":{"type":"string","required":false,"uniqueItems":false},"fileUrl":{"type":"string","required":false,"uniqueItems":false}},"id":"audioFile","type":"any","required":false,"uniqueItems":false},"partOfSpeech":{"properties":{"roots":{"type":"array","required":false,"items":{"$ref":"root","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"partOfSpeech","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/word.{format}/{word}/entries","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"tags","description":"Return XML tags in response","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary. Valid options: ahd, century, wiktionary, webster, and wordnet.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"etymologies","description":"Return etymologies","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Return entries for a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getEntries","responseClass":"List[entry]"}]},{"path":"/word.{format}/{word}/examples","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return examples for","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"includeDuplicates","description":"Show duplicate examples from different sources","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"},{"name":"contentProvider","description":"Return results from a specific ContentProvider","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"},{"name":"internalDataStore","description":"Specify the internal storage engine.","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns examples for a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getExamples","responseClass":"exampleSearchResults"},{"parameters":[{"name":"word","description":"Word to fetch examples for","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Search definition object","required":false,"dataType":"ExampleSearchQuery","allowableValues":[],"allowMultiple":false,"paramType":"body"},{"name":"internalDataStore","description":"Specify the internal storage engine.","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Fetches examples for a word","httpMethod":"POST","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getExamplesPost","responseClass":"exampleSearchResults"}]},{"path":"/word.{format}/{word}/wordForms","description":"","operations":[{"parameters":[{"name":"word","description":"Word to add forms for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"RelationshipMapWord to add","required":false,"dataType":"suggestion","allowableValues":[],"allowMultiple":false,"paramType":"body"},{"name":"canonical","description":"Make this the Canonical form of the word.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Adds a Relationship Map to a word","httpMethod":"POST","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"addWordForm","responseClass":"ok"},{"parameters":[{"name":"word","description":"Word to fetch forms for","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"If true will try to return a correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns other forms of a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getWordForms","responseClass":"relationshipMap"},{"parameters":[{"name":"word","description":"Word to delete forms from","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"type","description":"Relationship type to delete","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"word","description":"Target word to remove relationship from.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Deletes a relationship from a word","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"deleteWordForm","responseClass":"ok"}]},{"path":"/word.{format}/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"String value of WordObject to return","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"},{"name":"includeSuggestions","description":"Return suggestions (for correct spelling, case variants, etc.)","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"},{"name":"shouldCreate","description":"Create word if not existing","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Given a word as a string, returns the WordObject that represents it","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getWord","responseClass":"wordObject"}]},{"path":"/word.{format}/{word}/definitions","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return definitions for","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"partOfSpeech","description":"CSV list of part-of-speech types","required":false,"dataType":"string","allowableValues":["noun","adjective","verb","adverb","interjection","pronoun","preposition","abbreviation","affix","article","auxiliary-verb","conjunction","definite-article","family-name","given-name","idiom","imperative","noun-plural","noun-posessive","past-participle","phrasal-prefix","proper-noun","proper-noun-plural","proper-noun-posessive","suffix","verb-intransitive","verb-transitive"],"allowMultiple":false,"paramType":"query"},{"name":"includeRelated","description":"Return related words with definitions","required":false,"dataType":"string","allowableValues":["true","false"],"allowMultiple":false,"paramType":"query"},{"name":"sourceDictionaries","description":"Gets from dictionaries in the supplied order of precedence","required":false,"dataType":"string","allowableValues":["ahd"," century"," wiktionary"," webster"," wordnet"],"allowMultiple":false,"paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"},{"name":"includeTags","description":"Return a closed set of XML tags in response","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"}],"summary":"Return definitions for a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No definitions found.","code":404}],"nickname":"getDefinitions","responseClass":"List[definition]"}]},{"path":"/word.{format}/{word}/stats","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return stats for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"detailed","description":"Return detailed usage info","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns word statistics","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No stats available.","code":404}],"nickname":"getWordStats","responseClass":"wordStats"}]},{"path":"/word.{format}/{word}/topExample","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch examples for","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"contentProvider","description":"Return results from a specific ContentProvider","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"},{"name":"internalDataStore","description":"Specify the internal storage engine.","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns a top example for a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getTopExample","responseClass":"example"}]},{"path":"/word.{format}/{word}/punctuationFactor","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"caseSensitive","description":"Input is case sensitive","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches other forms of a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getPunctuationFactor","responseClass":"punctuationFactor","notes":"Deprecated"}]},{"path":"/word.{format}/{word}/contextualLookup","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return definitions for","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"sentence","description":"The sentence in which the word occurs","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"offset","defaultValue":"-1","description":"The start character offset of the word in the given sentence","required":false,"dataType":"int","allowableValues":["0 to 4096"],"allowMultiple":false,"paramType":"query"},{"name":"expandTerms","description":"Expand context terms using related words","required":false,"dataType":"string","allowableValues":["true","false"],"allowMultiple":false,"paramType":"query"},{"name":"includeSourceDictionaries","description":"Only include these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":["ahd"," century"," wiktionary"," webster"," wordnet"],"allowMultiple":false,"paramType":"query"},{"name":"excludeSourceDictionaries","description":"Exclude these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":["ahd"," century"," wiktionary"," webster"," wordnet"],"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":["0 to 1000"],"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":["1 to 1000"],"allowMultiple":false,"paramType":"query"}],"summary":"Returns definitions for a word based on the sentence in which it is found","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"contextualLookup","responseClass":"DefinitionSearchResults","notes":"Use the offset parameter when the word occurs more than once in the sentence"},{"parameters":[{"name":"word","description":"Word to return definitions for","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"The sentence in which the word occurs","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"body"},{"name":"offset","defaultValue":"-1","description":"The start character offset of the word in the given sentence","required":false,"dataType":"int","allowableValues":["0 to 4096"],"allowMultiple":false,"paramType":"query"},{"name":"expandTerms","description":"Expand context terms using related words","required":false,"dataType":"string","allowableValues":["true","false"],"allowMultiple":false,"paramType":"query"},{"name":"includeSourceDictionaries","description":"Only include these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":["ahd"," century"," wiktionary"," webster"," wordnet"],"allowMultiple":false,"paramType":"query"},{"name":"excludeSourceDictionaries","description":"Exclude these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":["ahd"," century"," wiktionary"," webster"," wordnet"],"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":["0 to 1000"],"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":["1 to 1000"],"allowMultiple":false,"paramType":"query"}],"summary":"Returns definitions for a word based on the sentence in which it is found","httpMethod":"POST","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"contextualLookupPost","responseClass":"DefinitionSearchResults","notes":"Use the offset parameter when the word occurs more than once in the sentence"}]},{"path":"/word.{format}/{word}/commentCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get comment count for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns the number of comments on a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getCommentCount","responseClass":"long"}]},{"path":"/word.{format}/{word}/citations","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get citations for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"If true will try to return a correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary. Valid options: ahd, century, wiktionary, webster, and wordnet.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns citations for a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getCitations","responseClass":"List[citation]"}]},{"path":"/word.{format}/{word}/related","description":"","operations":[{"parameters":[{"name":"word","description":"Word for which to return related words","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"partOfSpeech","description":"CSV list of part-of-speech types","required":false,"dataType":"string","allowableValues":["noun","adjective","verb","adverb","interjection","pronoun","preposition","abbreviation","affix","article","auxiliary-verb","conjunction","definite-article","family-name","given-name","idiom","imperative","noun-plural","noun-posessive","past-participle","phrasal-prefix","proper-noun","proper-noun-plural","proper-noun-posessive","suffix","verb-intransitive","verb-transitive"],"allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get data from a single dictionary","required":false,"dataType":"string","allowableValues":["ahd"," century"," wiktionary"," webster"," wordnet"],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"},{"name":"type","description":"Relationship type","required":false,"dataType":"string","allowableValues":["synonym","antonym","variant","equivalent","cross-reference","related-word","rhyme","form","etymologically-related-term","hypernym","hyponym","inflected-form","primary","same-context","verb-form","verb-stem","unknown"],"allowMultiple":false,"paramType":"query"}],"summary":"Return related words (thesaurus data) for a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No definitions found.","code":404}],"nickname":"getRelatedWords","responseClass":"List[related]"}]},{"path":"/word.{format}/{word}/listedIn","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch WordLists for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"sortBy","description":"Specifies a sort parameter","required":false,"dataType":"string","allowableValues":["rating"],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"username","description":"User to scope the request to","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns WordLists containing a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied","code":400},{"reason":"Supplied user does not exist","code":404}],"nickname":"getListedIn","responseClass":"List[wordList]"}]},{"path":"/word.{format}/{word}/listedInCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch count for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns a count of lists a word appears in","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getListedInCount","responseClass":"long"}]},{"path":"/word.{format}/{word}/firstListedIn","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch a WordList for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns the first WordList a word appeared in","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getFirstListedIn","responseClass":"wordList"}]},{"path":"/word.{format}/{word}/firstListedBy","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch a User for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns the first User to list a particular word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getFirstListedBy","responseClass":"user"}]},{"path":"/word.{format}/{word}/pronunciations","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get pronunciations for","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"If true will try to return a correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary.","required":false,"dataType":"string","allowableValues":["ahd","century","cmu","macmillan","wiktionary","webster","wordnet"],"allowMultiple":false,"paramType":"query"},{"name":"typeFormat","description":"Text pronunciation type","required":false,"dataType":"string","allowableValues":["ahd","arpabet","gcide-diacritical","IPA"],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns text pronunciations for a given word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getTextPronunciations","responseClass":"List[textPron]"}]},{"path":"/word.{format}/{word}/images/flickr","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get flickr images for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"size","description":"Image size","required":false,"dataType":"string","allowableValues":["thumb","small","med","lg","orig"],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns Flickr images for a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getFlickrImages","responseClass":"List[photo]"}]},{"path":"/word.{format}/{word}/scrabbleScore","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get scrabble score for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns the Scrabble score for a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No scrabble score found.","code":404}],"nickname":"getScrabbleScore","responseClass":"long"}]},{"path":"/word.{format}/{word}/hyphenation","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get syllables for","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"If true will try to return a correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary. Valid options: ahd, century, wiktionary, webster, and wordnet.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns syllable information for a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getHyphenation","responseClass":"List[syllable]"}]},{"path":"/word.{format}/{word}/unigramCountInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get unigram count for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns syllable information for a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getUnigramCountInternal","responseClass":"long"}]},{"path":"/word.{format}/{word}/phrasesInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get bigrams for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"gamma","description":"Gamma filter","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"minWlmi","description":"WLMI Limit","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns Bigrams for the given word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getBigramsInternal","responseClass":"List[bigram]"}]},{"path":"/word.{format}/{word}/lookupCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get Bigrams for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Returns the number of times a word has been viewed","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getLookupCount","responseClass":"long"}]},{"path":"/word.{format}/{word}/tags","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch Tags on","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"username","description":"Restrict to a particular user","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches tags for a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getTagsOnWord","responseClass":"List[tag]"}]},{"path":"/word.{format}/{word}/tagCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch Tag count on","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"username","description":"Restrict to a particular user","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches tag count for a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getTagCountOnWord","responseClass":"long"}]},{"path":"/word.{format}/{word}/tag","description":"","operations":[{"parameters":[{"name":"word","description":"Word to add a Tag to","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"tags","description":"CSV list of tags to add.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"username","description":"Add tag on behalf of a particular user","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Adds a tag to a word","httpMethod":"POST","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"addTagToWord","responseClass":"ok"},{"parameters":[{"name":"word","description":"Word to add a Tag to","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"tags","description":"CSV list of tags to remove.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"username","description":"Remove tag on behalf of a particular user","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Removes a tag from a word","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"deleteTagFromWord","responseClass":"ok"}]},{"path":"/word.{format}/{word}/frequency","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"caseSensitive","description":"Input is case sensitive","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"startYear","description":"Starting Year","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"endYear","description":"Ending Year","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"includeErrorBars","description":"Get error bar data","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns word usage over time","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getWordFrequency","responseClass":"frequencySummary"}]},{"path":"/word.{format}/{word}/firstUsed","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return first usage for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"detailed","description":"Return detailed usage info","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns first usage of a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getFirstUsageOfWord","responseClass":"detailedWordUsage"}]},{"path":"/word.{format}/{word}/wordView","description":"","operations":[{"parameters":[{"name":"word","description":"Word to record a word view for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"userId","description":"ID of the user viewing the word","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"userGuid","description":"Tracking ID for the user","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"userSessionId","description":"Session ID for the user","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"serverIp","description":"Internal IP address of the web server","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"pageName","description":"Page being viewed","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"method","description":"Method of the word view","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"userAgent","description":"Browser user agent","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Records a word view from the website","httpMethod":"POST","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"addWordView","responseClass":"ok"}]},{"path":"/word.{format}/{word}/isFavorite","description":"","operations":[{"parameters":[{"name":"word","description":"Word to check","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"userName","description":"Check for a particular user","required":true,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Checks to see if a word is a user's favorite","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied","code":400},{"reason":"No user found","code":404}],"nickname":"isFavorite","responseClass":"BooleanValue"}]},{"path":"/word.{format}/{word}/favoriteCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to check","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"userName","description":"Check for a particular user","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns the number of times a word has been Favorited","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied","code":400},{"reason":"No user found","code":404}],"nickname":"getFavoriteCount","responseClass":"long"}]},{"path":"/word.{format}/{word}/favorite","description":"","operations":[{"parameters":[{"name":"word","description":"Word to favorite","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"userName","description":"Add as favorite on behalf of a particular user","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Favorites a Word for a user","httpMethod":"POST","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No user found","code":404}],"nickname":"addWordToFavorites","responseClass":"ok"},{"parameters":[{"name":"word","description":"Word to remove","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"userName","description":"Remove on behalf of a particular user","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Removes a Word from a user's Favorites","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid word supplied or no user found.","code":400}],"nickname":"deleteFromFavorites","responseClass":"ok"}]},{"path":"/word.{format}/{word}/phrases","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch phrases for","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"wlmi","description":"Minimum WLMI for the phrase","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches bi-gram phrases for a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getPhrases","responseClass":"List[bigram]"}]},{"path":"/word.{format}/{word}/etymologies","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"sourceDictionary","description":"Get etymologies from a single dictionary. Options are ahd or century.","required":false,"dataType":"string","allowableValues":["ahd","webster","wiktionary"],"allowMultiple":false,"paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"},{"name":"type","description":"Etymology type","required":false,"dataType":"string","allowableValues":["ahd","webster","wiktionary"],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches etymology data","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No definitions found.","code":404}],"nickname":"getEtymologies","responseClass":"String"}]},{"path":"/word.{format}/{word}/otherFormsInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"minFrequency","description":"Minimum corpus frequency","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches other forms of a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getOtherFormsInternal","responseClass":"List[otherForms]","notes":"Deprecated"}]},{"path":"/word.{format}/{word}/wordRelationshipInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Relationship to add","required":false,"dataType":"relatedData","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Adds a word relationship","httpMethod":"POST","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"addWordRelationshipInternal","responseClass":"ok","notes":"Deprecated"}]},{"path":"/word.{format}/{word}/comments","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return Comments for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"sortOrder","defaultValue":"descending","description":"Direction to sort by","required":false,"dataType":"string","allowableValues":["ascending","descending"],"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches comments on a Word","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getCommentsOnWord","responseClass":"List[comment]"}]},{"path":"/word.{format}/{word}/comment/{commentId}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch Comment for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"ID of Comment to fetch.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches a Comment by ID","httpMethod":"GET","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"nickname":"getCommentOnWord","responseClass":"comment"},{"parameters":[{"name":"word","description":"Word to update Comment on.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Updated Comment.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Deletes an existing word comment","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"nickname":"deleteCommentByIdOnWord","responseClass":"ok"}]},{"path":"/word.{format}/{word}/comment","description":"","operations":[{"parameters":[{"name":"word","description":"Word to add Comment to.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Comment to add.","required":false,"dataType":"comment","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Adds a comment to a word","httpMethod":"POST","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"nickname":"commentOnWord","responseClass":"comment"},{"parameters":[{"name":"word","description":"Word to update Comment on.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Updated Comment.","required":false,"dataType":"comment","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Updates an existing word comment","httpMethod":"PUT","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"nickname":"updateCommentOnWord","responseClass":"comment"}]},{"path":"/word.{format}/{word}/audio","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get audio for.","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"v3Format","description":"Use the V3 api.","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches audio metadata for a word.","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getAudio","responseClass":"List[audioFile]","notes":"The metadata includes a time-expiring fileUrl which allows reading the audio file directly from the API.  Currently only audio pronunciations from the American Heritage Dictionary in mp3 format are supported."},{"parameters":[{"name":"word","description":"Word to add audio to.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"AudioPon metadata to add.","required":false,"dataType":"audioObject","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Creates AudioPron metadata","httpMethod":"POST","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"addAudio","responseClass":"ok"}]},{"path":"/word.{format}/{word}/pronunciation/{pronId}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get audio for.","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"pronId","description":"Id to get audio for.","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches single audio pronunciation.","httpMethod":"GET","errorResponses":[{"reason":"Invalid pron id supplied.","code":400}],"nickname":"getPronunciation","responseClass":"audioFile","notes":"The metadata includes a time-expiring fileUrl which allows reading the audio file directly from the API.  Currently only audio pronunciations from the American Heritage Dictionary in mp3 format are supported."}]},{"path":"/word.{format}/{word}/audioInternal","description":"","operations":[{"parameters":[{"name":"word","description":"audio object to update","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Updated metadata.","required":false,"dataType":"audioObject","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Internal method to update an audio object","httpMethod":"PUT","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"updateAudioInternal","responseClass":"ok"}]},{"path":"/word.{format}/{word}/audio/{audio_id}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to delete audio from.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"audio_id","description":"AudioPon metadata to add.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Deletes an AudioPron","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Unauthorized.","code":401}],"nickname":"deleteAudio","responseClass":"ok"}]}],"models1":[{"name":"BooleanValue","fields":[{"name":"value","required":false,"allowMultiple":false,"paramType":"boolean"}]},{"name":"note","fields":[{"name":"noteType","required":false,"allowMultiple":false,"paramType":"string"},{"name":"pos","required":false,"allowMultiple":false,"paramType":"int"},{"name":"value","required":false,"allowMultiple":false,"paramType":"string"},{"name":"appliesTo","required":false,"allowMultiple":false,"paramType":"List[string]"}]},{"name":"author","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"authorType","required":false,"allowMultiple":false,"paramType":"authorType"},{"name":"uniqueName","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"long","fields":[{"name":"value","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"header","fields":[{"name":"type","required":false,"allowMultiple":false,"paramType":"type"},{"name":"position","required":false,"allowMultiple":false,"paramType":"integer"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"textPron","required":false,"wrapperName":"textProns","allowMultiple":false,"paramType":"List[textPron]"},{"name":"partOfSpeech","required":false,"allowMultiple":false,"paramType":"string"},{"name":"note","required":false,"wrapperName":"notes","allowMultiple":false,"paramType":"List[note]"},{"name":"syllable","required":false,"wrapperName":"syllables","allowMultiple":false,"paramType":"List[syllable]"},{"name":"sourceDictionary","required":false,"allowMultiple":false,"paramType":"string"},{"name":"homograph","required":false,"allowMultiple":false,"paramType":"string"},{"name":"derivativeSense","required":false,"allowMultiple":false,"paramType":"string"},{"name":"derivedFrom","required":false,"allowMultiple":false,"paramType":"string"},{"name":"etymologyXml","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"documentMedium","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"contentProvider","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"frequency","fields":[{"name":"year","required":false,"allowMultiple":false,"paramType":"int"},{"name":"count","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"authorType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"audioType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"frequencySummary","fields":[{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"totalCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"frequency","required":false,"allowMultiple":false,"paramType":"List[frequency]"},{"name":"unknownYearCount","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"detailedWordUsage","fields":[{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"sentence","required":false,"allowMultiple":false,"paramType":"sentence"},{"name":"metadata","required":false,"allowMultiple":false,"paramType":"documentMetadata"}]},{"name":"citation","fields":[{"name":"source","required":false,"allowMultiple":false,"paramType":"string"},{"name":"cite","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"audioType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"basicDocumentStats","fields":[{"name":"key","required":false,"allowMultiple":false,"paramType":"string"},{"name":"type","required":false,"allowMultiple":false,"paramType":"string"},{"name":"sentencesCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"uniqueWordsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"documentsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"tokensCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"firstUsedWordsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"viableSentencesCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"uniqueBiGramsCount","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"otherForms","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordString","required":false,"allowMultiple":false,"paramType":"string"},{"name":"totalCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"plain","required":false,"allowMultiple":false,"paramType":"string"},{"name":"wordId","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"facet","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"facetValue","required":false,"wrapperName":"facetValues","allowMultiple":false,"paramType":"List[facetValue]"}]},{"name":"wordObject","fields":[{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"vulgar","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"relationshipMap","fields":[{"name":"sourceWordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"suggestion","required":false,"wrapperName":"suggestions","allowMultiple":false,"paramType":"List[suggestion]"}]},{"name":"contentType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"comment","fields":[{"name":"objectType","required":false,"allowMultiple":false,"paramType":"string"},{"name":"objectId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"commentedBy","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"id","required":false,"allowMultiple":false,"paramType":"string"},{"name":"commentedOn","required":false,"allowMultiple":false,"paramType":"string"},{"name":"body","required":false,"allowMultiple":false,"paramType":"string"},{"name":"updatedAt","required":false,"allowMultiple":false,"paramType":"Date"}]},{"name":"exampleSearchResults","fields":[{"name":"facet","required":false,"wrapperName":"facets","allowMultiple":false,"paramType":"List[facet]"},{"name":"example","required":false,"wrapperName":"examples","allowMultiple":false,"paramType":"List[example]"}]},{"name":"partOfSpeech","fields":[{"name":"roots","required":false,"allowMultiple":false,"paramType":"List[root]"}]},{"name":"sizes","fields":[{"name":"size","required":false,"allowMultiple":false,"paramType":"List[size]"}]},{"name":"subjectClassificationType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"Label","fields":[{"name":"type","required":false,"allowMultiple":false,"paramType":"string"},{"name":"text","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"audioFile","fields":[{"name":"id","required":true,"allowMultiple":false,"paramType":"long"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"duration","required":false,"allowMultiple":false,"paramType":"double"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdBy","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"commentCount","required":false,"allowMultiple":false,"paramType":"int"},{"name":"voteCount","required":false,"allowMultiple":false,"paramType":"integer"},{"name":"voteAverage","required":false,"allowMultiple":false,"paramType":"float"},{"name":"voteWeightedAverage","required":false,"allowMultiple":false,"paramType":"float"},{"name":"fileUrl","required":false,"allowMultiple":false,"paramType":"string"},{"name":"audioType","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"DefinitionSearchResults","fields":[{"name":"totalResults","required":false,"allowMultiple":false,"paramType":"int"},{"name":"result","required":false,"wrapperName":"results","allowMultiple":false,"paramType":"List[definition]"}]},{"name":"RelatedDataSource","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"audioObject","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"type","required":false,"allowMultiple":false,"paramType":"audioType"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"duration","required":false,"allowMultiple":false,"paramType":"double"},{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdBy","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"audioFileType","required":false,"allowMultiple":false,"paramType":"audioType"},{"name":"audioFileId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"filePath","required":false,"allowMultiple":false,"paramType":"string"},{"name":"wordId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"recordId","required":false,"allowMultiple":false,"paramType":"string"},{"name":"streamPath","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"extendedMetadata","fields":[{"name":"documentMetadataId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"isbn","required":false,"allowMultiple":false,"paramType":"string"},{"name":"issn","required":false,"allowMultiple":false,"paramType":"string"},{"name":"lccn","required":false,"allowMultiple":false,"paramType":"string"},{"name":"sourceFileSize","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"tag","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"count","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"example","fields":[{"name":"year","required":false,"allowMultiple":false,"paramType":"integer"},{"name":"provider","required":false,"allowMultiple":false,"paramType":"contentProvider"},{"name":"url","required":false,"allowMultiple":false,"paramType":"string"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"text","required":false,"allowMultiple":false,"paramType":"string"},{"name":"title","required":false,"allowMultiple":false,"paramType":"string"},{"name":"rating","required":false,"allowMultiple":false,"paramType":"float"},{"name":"exampleId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"documentId","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"definition","fields":[{"name":"exampleUsage","required":false,"wrapperName":"exampleUses","allowMultiple":false,"paramType":"List[ExampleUsage]"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"text","required":false,"allowMultiple":false,"paramType":"string"},{"name":"textPron","required":false,"wrapperName":"textProns","allowMultiple":false,"paramType":"List[textPron]"},{"name":"score","required":false,"allowMultiple":false,"paramType":"float"},{"name":"partOfSpeech","required":false,"allowMultiple":false,"paramType":"string"},{"name":"note","required":false,"wrapperName":"notes","allowMultiple":false,"paramType":"List[note]"},{"name":"relWord","required":false,"wrapperName":"relatedWords","allowMultiple":false,"paramType":"List[related]"},{"name":"sourceDictionary","required":false,"allowMultiple":false,"paramType":"string"},{"name":"label","required":false,"wrapperName":"labels","allowMultiple":false,"paramType":"List[Label]"},{"name":"citation","required":false,"wrapperName":"citations","allowMultiple":false,"paramType":"List[citation]"},{"name":"sequence","required":false,"allowMultiple":false,"paramType":"string"},{"name":"seqString","required":false,"allowMultiple":false,"paramType":"string"},{"name":"extendedText","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"photo","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"owner","required":false,"allowMultiple":false,"paramType":"string"},{"name":"server","required":false,"allowMultiple":false,"paramType":"int"},{"name":"title","required":false,"allowMultiple":false,"paramType":"string"},{"name":"ownername","required":false,"allowMultiple":false,"paramType":"string"},{"name":"secret","required":false,"allowMultiple":false,"paramType":"string"},{"name":"farm","required":false,"allowMultiple":false,"paramType":"int"},{"name":"ispublic","required":false,"allowMultiple":false,"paramType":"int"},{"name":"isfriend","required":false,"allowMultiple":false,"paramType":"int"},{"name":"isfamily","required":false,"allowMultiple":false,"paramType":"int"},{"name":"ownerLink","required":false,"allowMultiple":false,"paramType":"string"},{"name":"linkUri","required":false,"allowMultiple":false,"paramType":"string"},{"name":"size","required":false,"allowMultiple":false,"paramType":"size"}]},{"name":"category","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"RelationshipType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"relatedData","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"source","required":false,"allowMultiple":false,"paramType":"RelatedDataSource"},{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"sourceWordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"targetWordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"relationshipType","required":false,"allowMultiple":false,"paramType":"RelationshipType"},{"name":"frequency","required":false,"allowMultiple":false,"paramType":"long"},{"name":"partOfSpeech","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"targetWordId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"sourceWordId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"sense","required":false,"allowMultiple":false,"paramType":"integer"},{"name":"direction","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"root","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"categories","required":false,"allowMultiple":false,"paramType":"List[category]"}]},{"name":"ExampleUsage","fields":[{"name":"text","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"entry","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"header","required":false,"allowMultiple":false,"paramType":"header"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"note","required":false,"wrapperName":"notes","allowMultiple":false,"paramType":"List[note]"},{"name":"definition","required":false,"wrapperName":"definitions","allowMultiple":false,"paramType":"List[definition]"},{"name":"syll","required":false,"wrapperName":"syllabified","allowMultiple":false,"paramType":"List[syllable]"},{"name":"relWord","required":false,"wrapperName":"relatedWords","allowMultiple":false,"paramType":"List[related]"},{"name":"sourceDictionary","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"scoredWord","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordType","required":false,"allowMultiple":false,"paramType":"string"},{"name":"position","required":false,"allowMultiple":false,"paramType":"int"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"score","required":false,"allowMultiple":false,"paramType":"float"},{"name":"sentenceId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"partOfSpeech","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"facetValue","fields":[{"name":"value","required":false,"allowMultiple":false,"paramType":"string"},{"name":"count","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"sentence","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"scoredWord","required":false,"wrapperName":"scoredWords","allowMultiple":false,"paramType":"List[scoredWord]"},{"name":"display","required":false,"allowMultiple":false,"paramType":"string"},{"name":"documentMetadataId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"rating","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"type","fields":[{"name":"typeId","required":false,"allowMultiple":false,"paramType":"int"},{"name":"text","required":false,"allowMultiple":false,"paramType":"string"},{"name":"enteredAt","required":false,"allowMultiple":false,"paramType":"string"},{"name":"mapping","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"punctuationFactor","fields":[{"name":"totalCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"periodCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"exclamationPointCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"questionMarkCount","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"bigram","fields":[{"name":"count","required":false,"allowMultiple":false,"paramType":"long"},{"name":"gram1","required":false,"allowMultiple":false,"paramType":"string"},{"name":"gram2","required":false,"allowMultiple":false,"paramType":"string"},{"name":"mi","required":false,"allowMultiple":false,"paramType":"double"},{"name":"wlmi","required":false,"allowMultiple":false,"paramType":"double"}]},{"name":"yearType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"related","fields":[{"name":"word","required":false,"wrapperName":"words","allowMultiple":false,"paramType":"List[string]"},{"name":"relationshipType","required":false,"allowMultiple":false,"paramType":"string"},{"name":"label1","required":false,"allowMultiple":false,"paramType":"string"},{"name":"label2","required":false,"allowMultiple":false,"paramType":"string"},{"name":"label3","required":false,"allowMultiple":false,"paramType":"string"},{"name":"label4","required":false,"allowMultiple":false,"paramType":"string"},{"name":"gram","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"documentMetadata","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"year","required":false,"allowMultiple":false,"paramType":"integer"},{"name":"contentType","required":false,"allowMultiple":false,"paramType":"contentType"},{"name":"provider","required":false,"allowMultiple":false,"paramType":"contentProvider"},{"name":"tag","required":false,"wrapperName":"tags","allowMultiple":false,"paramType":"List[string]"},{"name":"title","required":false,"allowMultiple":false,"paramType":"string"},{"name":"rating","required":false,"allowMultiple":false,"paramType":"double"},{"name":"medium","required":false,"allowMultiple":false,"paramType":"documentMedium"},{"name":"sourceUrl","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"classification","required":false,"allowMultiple":false,"paramType":"subjectClassificationType"},{"name":"date","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"yearType","required":false,"allowMultiple":false,"paramType":"yearType"},{"name":"primaryAuthor","required":false,"allowMultiple":false,"paramType":"string"},{"name":"primaryAuthorType","required":false,"allowMultiple":false,"paramType":"authorType"},{"name":"primaryAuthorId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"guid","required":false,"allowMultiple":false,"paramType":"string"},{"name":"extendedMetadata","required":false,"allowMultiple":false,"paramType":"extendedMetadata"},{"name":"author","required":false,"wrapperName":"authors","allowMultiple":false,"paramType":"List[author]"},{"name":"expirationDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"stats","required":false,"allowMultiple":false,"paramType":"basicDocumentStats"}]},{"name":"ExampleSearchQuery","fields":[{"name":"year","required":false,"allowMultiple":false,"paramType":"int"},{"name":"contentType","required":false,"allowMultiple":false,"paramType":"string"},{"name":"filter","required":false,"allowMultiple":false,"paramType":"string"},{"name":"limit","required":false,"allowMultiple":false,"paramType":"int"},{"name":"wordType","required":false,"allowMultiple":false,"paramType":"string"},{"name":"wordString","required":false,"allowMultiple":false,"paramType":"string"},{"name":"contentProvider","required":false,"allowMultiple":false,"paramType":"string"},{"name":"partOfSpeech","required":false,"allowMultiple":false,"paramType":"string"},{"name":"skip","required":false,"allowMultiple":false,"paramType":"int"},{"name":"medium","required":false,"allowMultiple":false,"paramType":"string"},{"name":"subject","required":false,"allowMultiple":false,"paramType":"string"},{"name":"dateRange","required":false,"allowMultiple":false,"paramType":"string"},{"name":"beginDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"endDate","required":false,"allowMultiple":false,"paramType":"Date"}]},{"name":"wordStats","fields":[{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"sentencesCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"documentsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"frequencyStats","required":false,"allowMultiple":false,"paramType":"frequencyStats"},{"name":"dictionaryStats","required":false,"allowMultiple":false,"paramType":"Map[string,dictionaryWordStats]"},{"name":"partOfSpeechStats","required":false,"allowMultiple":false,"paramType":"Map[string,integer]"}]},{"name":"syllable","fields":[{"name":"type","required":false,"allowMultiple":false,"paramType":"string"},{"name":"seq","required":false,"allowMultiple":false,"paramType":"int"},{"name":"text","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"textPron","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"seq","required":false,"allowMultiple":false,"paramType":"int"},{"name":"raw","required":false,"allowMultiple":false,"paramType":"string"},{"name":"rawType","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"wordList","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"type","required":false,"allowMultiple":false,"paramType":"string"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"permalink","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"username","required":false,"allowMultiple":false,"paramType":"string"},{"name":"updatedAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"numberWordsInList","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"ExampleDataStore","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"frequencyStats","fields":[{"name":"corpusCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"yearWise","required":false,"allowMultiple":false,"paramType":"Map[integer,long]"},{"name":"contentType","required":false,"allowMultiple":false,"paramType":"Map[integer,long]"},{"name":"contentProvider","required":false,"allowMultiple":false,"paramType":"Map[integer,long]"},{"name":"medium","required":false,"allowMultiple":false,"paramType":"Map[integer,long]"},{"name":"subject","required":false,"allowMultiple":false,"paramType":"Map[integer,long]"},{"name":"author","required":false,"allowMultiple":false,"paramType":"Map[long,long]"}]},{"name":"suggestion","fields":[{"name":"type","required":false,"allowMultiple":false,"paramType":"int"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"user","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"displayName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"status","required":false,"allowMultiple":false,"paramType":"int"},{"name":"password","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"email","required":false,"allowMultiple":false,"paramType":"string"},{"name":"faceBookId","required":false,"allowMultiple":false,"paramType":"string"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/api_docs/wordList.json

@@ -1 +1 @@
-{"endPoints":[{"path":"/wordList.{format}/{wordListId}","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to update","required":true,"dataType":"string","paramType":"path"},{"description":"Updated WordList","required":false,"dataType":"wordList","paramType":"body"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","paramType":"header"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not Authorized to update WordList","code":403},{"reason":"WordList not found","code":404}],"condition":"any"}],"category":"WordListInfo","summary":"Updates an existing WordList","suggestedName":"updateWordList","deprecated":false,"open":false,"httpMethod":"PUT"},{"parameters":[{"name":"wordListId","description":"ID of WordList to delete","required":true,"dataType":"string","paramType":"path"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","paramType":"header"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not Authorized to delete WordList","code":403},{"reason":"WordList not found","code":404}],"condition":"any"}],"category":"WordListInfo","summary":"Deletes an existing WordList","suggestedName":"deleteWordList","deprecated":false,"open":false,"httpMethod":"DELETE"},{"parameters":[{"name":"wordListId","description":"ID of WordList to fetch","required":true,"dataType":"string","paramType":"path"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","paramType":"header"}],"response":[{"valueType":"wordList","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not Authorized to access WordList","code":403},{"reason":"WordList not found","code":404}],"condition":"any"}],"category":"WordListInfo","summary":"Fetches a WordList by ID","suggestedName":"getWordListById","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/words","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to user","required":true,"dataType":"string","paramType":"path"},{"name":"username","description":"Username to add words on behalf of","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"},{"description":"Array of words to add to WordList","required":false,"dataType":"StringValue[]","paramType":"body"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","paramType":"header"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not Authorized to access WordList","code":403},{"reason":"WordList not found","code":404}],"condition":"any"}],"category":"WordListInfo","summary":"Adds words to a WordList","suggestedName":"addWordsToWordList","deprecated":false,"open":false,"httpMethod":"POST"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","paramType":"path"},{"name":"sortBy","defaultValue":"createDate","description":"Field to sort by","required":false,"dataType":"string","allowableValues":"createDate,alpha","paramType":"query"},{"name":"sortOrder","defaultValue":"desc","description":"Direction to sort","required":false,"dataType":"string","allowableValues":"asc,desc","paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","paramType":"header"}],"response":[{"valueType":"List[wordListWord]","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not Authorized to access WordList","code":403},{"reason":"WordList not found","code":404}],"condition":"any"}],"category":"WordListInfo","summary":"Fetches words in a WordList","suggestedName":"getWordListWords","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/wordList","description":"","operations":[{"response":[{"valueType":"doc","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Help","summary":"Returns information about API parameters","suggestedName":"getHelp","deprecated":false,"open":true,"httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/isFavorite","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to check","required":false,"dataType":"string","paramType":"path"},{"name":"username","description":"Username to check for Favorite status","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"BooleanValue","errorResponses":[{"reason":"Invalid ID supplied.","code":400},{"reason":"Not Authorized to favorite WordList.","code":403},{"reason":"WordList not found.","code":404}],"condition":"any"}],"category":"WordListFavorites","summary":"Checks to see if a WordList has been favorited for a user","suggestedName":"isFavoriteWordList","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/favorite","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to fetch","required":false,"dataType":"string","paramType":"path"},{"name":"username","description":"Username to favorite on behalf of","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid ID supplied.","code":400},{"reason":"Not Authorized to favorite WordList.","code":403},{"reason":"WordList not found.","code":404}],"condition":"any"}],"category":"WordListFavorites","summary":"Favorites a WordList for a User","suggestedName":"favoriteWordList","deprecated":false,"open":false,"httpMethod":"POST"},{"parameters":[{"name":"wordListId","description":"ID of WordList to fetch","required":false,"dataType":"string","paramType":"path"},{"name":"username","description":"Username to unfavorite on behalf of","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid ID supplied.","code":400},{"reason":"Not Authorized to favorite WordList.","code":403},{"reason":"WordList not found.","code":404}],"condition":"any"}],"category":"WordListFavorites","summary":"Unfavorites a WordList for a User","suggestedName":"unFavoriteWordList","deprecated":false,"open":false,"httpMethod":"DELETE"}]},{"path":"/wordList.{format}/{wordListId}/tags","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","paramType":"path"},{"name":"username","description":"Username to get Tags for","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[tag]","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"condition":"any"}],"category":"WordListTags","summary":"Fetches Tags on a WordList","suggestedName":"getWordListTags","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/tagCount","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","paramType":"path"},{"name":"username","description":"Username to get Tags for","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"condition":"any"}],"category":"WordListTags","summary":"Fetches Tag count on a WordList","suggestedName":"getWordListTagCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/tag","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","paramType":"path"},{"name":"username","description":"Username to add Tags for","required":false,"dataType":"string","paramType":"query"},{"name":"tags","description":"Tags to add","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"condition":"any"}],"category":"WordListTags","summary":"Adds a Tag on a WordList","suggestedName":"addWordListTag","deprecated":false,"open":false,"httpMethod":"POST"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","paramType":"path"},{"name":"username","description":"Username to delete Tags for","required":false,"dataType":"string","paramType":"query"},{"name":"tags","description":"Tags to delete","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"condition":"any"}],"category":"WordListTags","summary":"Deletes a tag on a WordList","suggestedName":"deleteWordListTag","deprecated":false,"open":false,"httpMethod":"DELETE"}]},{"path":"/wordList.{format}/{wordListId}/comments","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"},{"name":"sortOrder","description":"Direction to sort","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[comment]","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"condition":"any"}],"category":"WordListComments","summary":"Fetches comments on a WordList","suggestedName":"getWordListComments","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/comment","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","paramType":"path"},{"description":"Comment to add","required":false,"dataType":"comment","paramType":"body"}],"response":[{"valueType":"comment","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"Not Authorized to access WordList.","code":403},{"reason":"WordList not found.","code":404}],"condition":"any"}],"category":"WordListComments","summary":"Adds a Comment on a WordList","suggestedName":"addCommentToWordList","deprecated":false,"open":false,"httpMethod":"POST"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","paramType":"path"},{"description":"Updated Comment","required":false,"dataType":"comment","paramType":"body"}],"response":[{"valueType":"comment","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"Not Authorized to access WordList.","code":403},{"reason":"WordList not found.","code":404}],"condition":"any"}],"category":"WordListComments","summary":"Updates a Comment on a WordList","suggestedName":"updateCommentOnWordList","deprecated":false,"open":false,"httpMethod":"PUT"}]},{"path":"/wordList.{format}/{wordListId}/comment/{commentId}","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","paramType":"path"},{"name":"commentId","description":"Comment ID to fetch","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"comment","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList or Comment not found.","code":404}],"condition":"any"}],"category":"WordListComments","summary":"Fetches a WordList comment by ID","suggestedName":"getWordListCommentById","deprecated":false,"open":false,"httpMethod":"GET"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","paramType":"path"},{"name":"commentId","description":"Comment ID to delete","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList or Comment not found.","code":404}],"condition":"any"}],"category":"WordListComments","summary":"Deletes a WordList comment by ID","suggestedName":"deleteWordListCommentById","deprecated":false,"open":false,"httpMethod":"DELETE"}]},{"path":"/wordList.{format}/{wordListId}/commentCount","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"condition":"any"}],"category":"WordListComments","summary":"Fetches WordList Comment count","suggestedName":"getWordListCommentCount","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/deleteWords","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","paramType":"path"},{"name":"username","description":"Username to remove words on behalf of","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"},{"description":"Words to remove from WordList","required":false,"dataType":"StringValue[]","paramType":"body"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","paramType":"header"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not Authorized to modify WordList","code":403},{"reason":"WordList not found","code":404}],"condition":"any"}],"category":"WordListInfo","summary":"Removes words from a WordList","suggestedName":"deleteWordsFromWordList","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/wordList.{format}/{wordListId}/wordsCount","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","paramType":"path"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","paramType":"header"}],"response":[{"valueType":"long","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not Authorized to access WordList","code":403},{"reason":"WordList not found","code":404}],"condition":"any"}],"category":"WordListInfo","summary":"Gets a count of Words in a WordList","suggestedName":"getWordListWordsCount","deprecated":false,"open":false,"httpMethod":"GET"}]}],"models":[{"name":"BooleanValue","fields":[{"name":"value","required":false,"paramType":"boolean"}]},{"name":"error","fields":[{"name":"reason","required":false,"paramType":"string"},{"name":"code","required":false,"paramType":"int"}]},{"name":"tag","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"long"},{"name":"count","required":false,"paramType":"long"}]},{"name":"wordListWord","fields":[{"name":"userId","required":false,"paramType":"long"},{"name":"word","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"username","required":false,"paramType":"string"},{"name":"numberCommentsOnWord","required":false,"paramType":"long"},{"name":"numberLists","required":false,"paramType":"long"}]},{"name":"long","fields":[{"name":"value","required":false,"paramType":"long"}]},{"name":"object","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"fields","required":false,"paramType":"List[parameter]"},{"name":"uniqueFieldName","required":false,"paramType":"string"}]},{"name":"comment","fields":[{"name":"objectType","required":false,"paramType":"string"},{"name":"objectId","required":false,"paramType":"long"},{"name":"commentedBy","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"updatedAt","required":false,"paramType":"Date"},{"name":"commentedOn","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"string"},{"name":"body","required":false,"paramType":"string"}]},{"name":"response","fields":[{"name":"valueType","required":false,"paramType":"string"},{"name":"errorResponses","required":false,"paramType":"List[error]"},{"name":"occurs","required":false,"paramType":"string"},{"name":"condition","required":false,"paramType":"string"}]},{"name":"parameter","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"defaultValue","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"required","required":false,"paramType":"boolean"},{"name":"dataType","required":false,"paramType":"string"},{"name":"allowableValues","required":false,"paramType":"string"},{"name":"wrapperName","required":false,"paramType":"string"},{"name":"internalDescription","required":false,"paramType":"string"},{"name":"paramAccess","required":false,"paramType":"string"},{"name":"paramType","required":false,"paramType":"string"}]},{"name":"wordList","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"long"},{"name":"type","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"userId","required":false,"paramType":"long"},{"name":"permalink","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"username","required":false,"paramType":"string"},{"name":"updatedAt","required":false,"paramType":"Date"},{"name":"numberWordsInList","required":false,"paramType":"long"}]},{"name":"doc","fields":[{"name":"endPoints","required":false,"paramType":"List[endpoint]"},{"name":"models","required":false,"paramType":"List[object]"}]},{"name":"operation","fields":[{"name":"parameters","required":false,"paramType":"List[parameter]"},{"name":"response","required":false,"paramType":"List[response]"},{"name":"category","required":false,"paramType":"string"},{"name":"summary","required":false,"paramType":"string"},{"name":"suggestedName","required":false,"paramType":"string"},{"name":"deprecated","required":false,"paramType":"boolean"},{"name":"open","required":false,"paramType":"boolean"},{"name":"notes","required":false,"paramType":"string"},{"name":"httpMethod","required":false,"paramType":"string"}]},{"name":"endpoint","fields":[{"name":"path","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"operations","required":false,"paramType":"List[operation]"}]}]}
+{"resourcePath":"/wordList","models":{"BooleanValue":{"properties":{"value":{"type":"boolean","required":false,"uniqueItems":false}},"id":"BooleanValue","type":"any","required":false,"uniqueItems":false},"tag":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"count":{"type":"long","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"tag","type":"any","required":false,"uniqueItems":false},"comment":{"properties":{"updatedAt":{"type":"Date","required":false,"uniqueItems":false},"id":{"type":"string","required":false,"uniqueItems":false},"body":{"type":"string","required":false,"uniqueItems":false},"commentedOn":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"objectId":{"type":"long","required":false,"uniqueItems":false},"commentedBy":{"type":"string","required":false,"uniqueItems":false},"objectType":{"type":"string","required":false,"uniqueItems":false}},"id":"comment","type":"any","required":false,"uniqueItems":false},"long":{"properties":{"value":{"type":"long","required":false,"uniqueItems":false}},"id":"long","type":"any","required":false,"uniqueItems":false},"wordListWord":{"properties":{"username":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"numberCommentsOnWord":{"type":"long","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"numberLists":{"type":"long","required":false,"uniqueItems":false}},"id":"wordListWord","type":"any","required":false,"uniqueItems":false},"wordList":{"properties":{"updatedAt":{"type":"Date","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"username":{"type":"string","required":false,"uniqueItems":false},"permalink":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false},"numberWordsInList":{"type":"long","required":false,"uniqueItems":false},"type":{"type":"string","required":false,"uniqueItems":false}},"id":"wordList","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/wordList.{format}/{wordListId}","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to update","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Updated WordList","required":false,"dataType":"wordList","allowableValues":[],"allowMultiple":false,"paramType":"body"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"}],"summary":"Updates an existing WordList","httpMethod":"PUT","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not Authorized to update WordList","code":403},{"reason":"WordList not found","code":404}],"nickname":"updateWordList","responseClass":"ok"},{"parameters":[{"name":"wordListId","description":"ID of WordList to delete","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"}],"summary":"Deletes an existing WordList","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not Authorized to delete WordList","code":403},{"reason":"WordList not found","code":404}],"nickname":"deleteWordList","responseClass":"ok"},{"parameters":[{"name":"wordListId","description":"ID of WordList to fetch","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"}],"summary":"Fetches a WordList by ID","httpMethod":"GET","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not Authorized to access WordList","code":403},{"reason":"WordList not found","code":404}],"nickname":"getWordListById","responseClass":"wordList"}]},{"path":"/wordList.{format}/{wordListId}/words","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to user","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to add words on behalf of","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"description":"Array of words to add to WordList","required":false,"dataType":"StringValue[]","allowableValues":[],"allowMultiple":false,"paramType":"body"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"}],"summary":"Adds words to a WordList","httpMethod":"POST","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not Authorized to access WordList","code":403},{"reason":"WordList not found","code":404}],"nickname":"addWordsToWordList","responseClass":"ok"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"sortBy","defaultValue":"createDate","description":"Field to sort by","required":false,"dataType":"string","allowableValues":["createDate","alpha"],"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","defaultValue":"desc","description":"Direction to sort","required":false,"dataType":"string","allowableValues":["asc","desc"],"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"}],"summary":"Fetches words in a WordList","httpMethod":"GET","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not Authorized to access WordList","code":403},{"reason":"WordList not found","code":404}],"nickname":"getWordListWords","responseClass":"List[wordListWord]"}]},{"path":"/wordList.{format}/{wordListId}/isFavorite","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to check","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to check for Favorite status","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Checks to see if a WordList has been favorited for a user","httpMethod":"GET","errorResponses":[{"reason":"Invalid ID supplied.","code":400},{"reason":"Not Authorized to favorite WordList.","code":403},{"reason":"WordList not found.","code":404}],"nickname":"isFavoriteWordList","responseClass":"BooleanValue"}]},{"path":"/wordList.{format}/{wordListId}/favorite","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to fetch","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to favorite on behalf of","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Favorites a WordList for a User","httpMethod":"POST","errorResponses":[{"reason":"Invalid ID supplied.","code":400},{"reason":"Not Authorized to favorite WordList.","code":403},{"reason":"WordList not found.","code":404}],"nickname":"favoriteWordList","responseClass":"ok"},{"parameters":[{"name":"wordListId","description":"ID of WordList to fetch","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to unfavorite on behalf of","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Unfavorites a WordList for a User","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid ID supplied.","code":400},{"reason":"Not Authorized to favorite WordList.","code":403},{"reason":"WordList not found.","code":404}],"nickname":"unFavoriteWordList","responseClass":"ok"}]},{"path":"/wordList.{format}/{wordListId}/tags","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to get Tags for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches Tags on a WordList","httpMethod":"GET","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"getWordListTags","responseClass":"List[tag]"}]},{"path":"/wordList.{format}/{wordListId}/tagCount","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to get Tags for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches Tag count on a WordList","httpMethod":"GET","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"getWordListTagCount","responseClass":"long"}]},{"path":"/wordList.{format}/{wordListId}/tag","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to add Tags for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"tags","description":"Tags to add","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Adds a Tag on a WordList","httpMethod":"POST","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"addWordListTag","responseClass":"ok"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to delete Tags for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"tags","description":"Tags to delete","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Deletes a tag on a WordList","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"deleteWordListTag","responseClass":"ok"}]},{"path":"/wordList.{format}/{wordListId}/comments","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Direction to sort","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches comments on a WordList","httpMethod":"GET","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"getWordListComments","responseClass":"List[comment]"}]},{"path":"/wordList.{format}/{wordListId}/comment","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Comment to add","required":false,"dataType":"comment","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Adds a Comment on a WordList","httpMethod":"POST","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"Not Authorized to access WordList.","code":403},{"reason":"WordList not found.","code":404}],"nickname":"addCommentToWordList","responseClass":"comment"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Updated Comment","required":false,"dataType":"comment","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Updates a Comment on a WordList","httpMethod":"PUT","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"Not Authorized to access WordList.","code":403},{"reason":"WordList not found.","code":404}],"nickname":"updateCommentOnWordList","responseClass":"comment"}]},{"path":"/wordList.{format}/{wordListId}/comment/{commentId}","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Comment ID to fetch","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches a WordList comment by ID","httpMethod":"GET","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList or Comment not found.","code":404}],"nickname":"getWordListCommentById","responseClass":"comment"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Comment ID to delete","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Deletes a WordList comment by ID","httpMethod":"DELETE","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList or Comment not found.","code":404}],"nickname":"deleteWordListCommentById","responseClass":"ok"}]},{"path":"/wordList.{format}/{wordListId}/commentCount","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches WordList Comment count","httpMethod":"GET","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"getWordListCommentCount","responseClass":"long"}]},{"path":"/wordList.{format}/{wordListId}/deleteWords","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to remove words on behalf of","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"description":"Words to remove from WordList","required":false,"dataType":"StringValue[]","allowableValues":[],"allowMultiple":false,"paramType":"body"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"}],"summary":"Removes words from a WordList","httpMethod":"POST","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not Authorized to modify WordList","code":403},{"reason":"WordList not found","code":404}],"nickname":"deleteWordsFromWordList","responseClass":"ok"}]},{"path":"/wordList.{format}/{wordListId}/wordsCount","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"}],"summary":"Gets a count of Words in a WordList","httpMethod":"GET","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not Authorized to access WordList","code":403},{"reason":"WordList not found","code":404}],"nickname":"getWordListWordsCount","responseClass":"long"}]}],"models1":[{"name":"BooleanValue","fields":[{"name":"value","required":false,"allowMultiple":false,"paramType":"boolean"}]},{"name":"tag","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"count","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"wordList","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"type","required":false,"allowMultiple":false,"paramType":"string"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"permalink","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"username","required":false,"allowMultiple":false,"paramType":"string"},{"name":"updatedAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"numberWordsInList","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"wordListWord","fields":[{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"username","required":false,"allowMultiple":false,"paramType":"string"},{"name":"numberCommentsOnWord","required":false,"allowMultiple":false,"paramType":"long"},{"name":"numberLists","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"long","fields":[{"name":"value","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"comment","fields":[{"name":"objectType","required":false,"allowMultiple":false,"paramType":"string"},{"name":"objectId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"commentedBy","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"id","required":false,"allowMultiple":false,"paramType":"string"},{"name":"commentedOn","required":false,"allowMultiple":false,"paramType":"string"},{"name":"body","required":false,"allowMultiple":false,"paramType":"string"},{"name":"updatedAt","required":false,"allowMultiple":false,"paramType":"Date"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/api_docs/wordLists.json

@@ -1 +1 @@
-{"endPoints":[{"path":"/wordLists.{format}/find/{searchString}","description":"","operations":[{"parameters":[{"name":"searchString","description":"String to search for","required":false,"dataType":"string","paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[wordList]","errorResponses":[{"reason":"Not authenticated.","code":403}],"condition":"any"}],"category":"WordLists","summary":"Fetches WordList objects by name.","suggestedName":"findByName","deprecated":false,"open":false,"notes":"The term supplied is effectively given a wildcard before and after so 'cat' becomes '%cat%'","httpMethod":"GET"}]},{"path":"/wordLists.{format}","description":"","operations":[{"parameters":[{"description":"WordList to create","required":false,"dataType":"wordList","paramType":"body"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","paramType":"header"}],"response":[{"valueType":"wordList","errorResponses":[{"reason":"Invalid WordList supplied or mandatory fields are missing.","code":400},{"reason":"Not authenticated.","code":403},{"reason":"WordList owner not found.","code":404}],"condition":"any"}],"category":"WordLists","summary":"Creates a WordList.","suggestedName":"createWordList","deprecated":false,"open":false,"httpMethod":"POST"},{"response":[{"valueType":"doc","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Help","summary":"Returns information about API parameters","suggestedName":"getHelp","deprecated":false,"open":true,"httpMethod":"GET"}]},{"path":"/wordLists.{format}/mostCommentedOn","description":"","operations":[{"parameters":[{"name":"dayInterval","description":"Interval in days","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[commentSummary]","errorResponses":[{"reason":"Not authenticated.","code":403}],"condition":"any"}],"category":"WordLists","summary":"Fetches a CommentSummary for WordList objects.","suggestedName":"findMostCommentedOn","deprecated":false,"open":false,"notes":"The CommentSummary is sorted by comment count, descending","httpMethod":"GET"}]},{"path":"/wordLists.{format}/containing/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to find lists for","required":false,"dataType":"string","paramType":"path"},{"name":"username","description":"Username to add words on behalf of","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"List[wordList]","errorResponses":[{"reason":"Invalid word or username supplied.","code":400},{"reason":"Not authenticated.","code":403}],"condition":"any"}],"category":"WordLists","summary":"Fetches WordList objects containing a word.","suggestedName":"findContainingWord","deprecated":false,"open":false,"notes":"Results are scoped to the supplied user.","httpMethod":"GET"}]},{"path":"/wordLists.{format}/recentLists","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"},{"name":"type","description":"WordListType to filter by","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[wordList]","errorResponses":[{"reason":"Not authenticated.","code":403}],"condition":"any"}],"category":"WordLists","summary":"Fetches recently created WordList objects.","suggestedName":"findRecentLists","deprecated":false,"open":false,"httpMethod":"GET"}]}],"models":[{"name":"error","fields":[{"name":"reason","required":false,"paramType":"string"},{"name":"code","required":false,"paramType":"int"}]},{"name":"response","fields":[{"name":"valueType","required":false,"paramType":"string"},{"name":"errorResponses","required":false,"paramType":"List[error]"},{"name":"occurs","required":false,"paramType":"string"},{"name":"condition","required":false,"paramType":"string"}]},{"name":"parameter","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"defaultValue","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"required","required":false,"paramType":"boolean"},{"name":"dataType","required":false,"paramType":"string"},{"name":"allowableValues","required":false,"paramType":"string"},{"name":"wrapperName","required":false,"paramType":"string"},{"name":"internalDescription","required":false,"paramType":"string"},{"name":"paramAccess","required":false,"paramType":"string"},{"name":"paramType","required":false,"paramType":"string"}]},{"name":"wordList","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"long"},{"name":"type","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"userId","required":false,"paramType":"long"},{"name":"permalink","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"username","required":false,"paramType":"string"},{"name":"updatedAt","required":false,"paramType":"Date"},{"name":"numberWordsInList","required":false,"paramType":"long"}]},{"name":"doc","fields":[{"name":"endPoints","required":false,"paramType":"List[endpoint]"},{"name":"models","required":false,"paramType":"List[object]"}]},{"name":"commentSummary","fields":[{"name":"objectType","required":false,"paramType":"string"},{"name":"totalCount","required":false,"paramType":"long"},{"name":"objectName","required":false,"paramType":"string"},{"name":"countInInterval","required":false,"paramType":"long"},{"name":"intervalInMilliseconds","required":false,"paramType":"long"},{"name":"objectDisplayName","required":false,"paramType":"string"}]},{"name":"object","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"fields","required":false,"paramType":"List[parameter]"},{"name":"uniqueFieldName","required":false,"paramType":"string"}]},{"name":"endpoint","fields":[{"name":"path","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"operations","required":false,"paramType":"List[operation]"}]},{"name":"operation","fields":[{"name":"parameters","required":false,"paramType":"List[parameter]"},{"name":"response","required":false,"paramType":"List[response]"},{"name":"category","required":false,"paramType":"string"},{"name":"summary","required":false,"paramType":"string"},{"name":"suggestedName","required":false,"paramType":"string"},{"name":"deprecated","required":false,"paramType":"boolean"},{"name":"open","required":false,"paramType":"boolean"},{"name":"notes","required":false,"paramType":"string"},{"name":"httpMethod","required":false,"paramType":"string"}]}]}
+{"resourcePath":"/wordLists","models":{"commentSummary":{"properties":{"objectDisplayName":{"type":"string","required":false,"uniqueItems":false},"objectName":{"type":"string","required":false,"uniqueItems":false},"totalCount":{"type":"long","required":false,"uniqueItems":false},"countInInterval":{"type":"long","required":false,"uniqueItems":false},"intervalInMilliseconds":{"type":"long","required":false,"uniqueItems":false},"objectType":{"type":"string","required":false,"uniqueItems":false}},"id":"commentSummary","type":"any","required":false,"uniqueItems":false},"wordList":{"properties":{"updatedAt":{"type":"Date","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"username":{"type":"string","required":false,"uniqueItems":false},"permalink":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"userId":{"type":"long","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false},"numberWordsInList":{"type":"long","required":false,"uniqueItems":false},"type":{"type":"string","required":false,"uniqueItems":false}},"id":"wordList","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/wordLists.{format}/find/{searchString}","description":"","operations":[{"parameters":[{"name":"searchString","description":"String to search for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordList objects by name.","httpMethod":"GET","errorResponses":[{"reason":"Not authenticated.","code":403}],"nickname":"findByName","responseClass":"List[wordList]","notes":"The term supplied is effectively given a wildcard before and after so 'cat' becomes '%cat%'"}]},{"path":"/wordLists.{format}","description":"","operations":[{"parameters":[{"description":"WordList to create","required":false,"dataType":"wordList","allowableValues":[],"allowMultiple":false,"paramType":"body"},{"name":"auth_token","description":"The auth token of the logged-in user, obtained by calling /account.{format}/authenticate/{username} (described above)","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"}],"summary":"Creates a WordList.","httpMethod":"POST","errorResponses":[{"reason":"Invalid WordList supplied or mandatory fields are missing.","code":400},{"reason":"Not authenticated.","code":403},{"reason":"WordList owner not found.","code":404}],"nickname":"createWordList","responseClass":"wordList"}]},{"path":"/wordLists.{format}/mostCommentedOn","description":"","operations":[{"parameters":[{"name":"dayInterval","description":"Interval in days","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches a CommentSummary for WordList objects.","httpMethod":"GET","errorResponses":[{"reason":"Not authenticated.","code":403}],"nickname":"findMostCommentedOn","responseClass":"List[commentSummary]","notes":"The CommentSummary is sorted by comment count, descending"}]},{"path":"/wordLists.{format}/containing/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to find lists for","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to add words on behalf of","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordList objects containing a word.","httpMethod":"GET","errorResponses":[{"reason":"Invalid word or username supplied.","code":400},{"reason":"Not authenticated.","code":403}],"nickname":"findContainingWord","responseClass":"List[wordList]","notes":"Results are scoped to the supplied user."}]},{"path":"/wordLists.{format}/recentLists","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"type","description":"WordListType to filter by","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches recently created WordList objects.","httpMethod":"GET","errorResponses":[{"reason":"Not authenticated.","code":403}],"nickname":"findRecentLists","responseClass":"List[wordList]"}]}],"models1":[{"name":"wordList","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"type","required":false,"allowMultiple":false,"paramType":"string"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"userId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"permalink","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"username","required":false,"allowMultiple":false,"paramType":"string"},{"name":"updatedAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"numberWordsInList","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"commentSummary","fields":[{"name":"objectType","required":false,"allowMultiple":false,"paramType":"string"},{"name":"totalCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"objectName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"objectDisplayName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"countInInterval","required":false,"allowMultiple":false,"paramType":"long"},{"name":"intervalInMilliseconds","required":false,"allowMultiple":false,"paramType":"long"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/api_docs/words.json

@@ -1 +1 @@
-{"endPoints":[{"path":"/words.{format}/search","description":"","operations":[{"parameters":[{"name":"allowRegex","defaultValue":"false","description":"Search term is a Regular Expression","required":false,"dataType":"string","allowableValues":"true | false","paramAccess":"internal","paramType":"query"},{"name":"query","description":"Search term","required":true,"dataType":"string","paramType":"query"},{"name":"caseSensitive","defaultValue":"true","description":"Search case sensitive","required":false,"dataType":"string","allowableValues":"true | false","paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"dataType":"string","allowableValues":"noun,adjective,verb,adverb,interjection,pronoun,preposition,abbreviation,affix,article,auxiliary-verb,conjunction,definite-article,family-name,given-name,idiom,imperative,noun-plural,noun-posessive,past-participle,phrasal-prefix,proper-noun,proper-noun-plural,proper-noun-posessive,suffix,verb-intransitive,verb-transitive","paramType":"query"},{"name":"excludePartOfSpeech","description":"Exclude these comma-delimited parts of speech","required":false,"dataType":"string","paramType":"query"},{"name":"minCorpusCount","defaultValue":"5","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowableValues":"non-negative integer","paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":"non-negative integer","paramType":"query"},{"name":"minDictionaryCount","defaultValue":"1","description":"Minimum number of dictionary entries","required":false,"dataType":"string","allowableValues":"non-negative integer","paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count","required":false,"dataType":"string","allowableValues":"non-negative integer","paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":"0 to 1024","paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":"0 to 1024","paramType":"query"},{"name":"minLexicalityRating","defaultValue":"0","description":"Minimum lexicality","required":false,"dataType":"string","allowableValues":"0 to 100","paramAccess":"internal","paramType":"query"},{"name":"maxLexicalityRating","defaultValue":"0","description":"Maximum lexicality","required":false,"dataType":"string","allowableValues":"0 to 100","paramAccess":"internal","paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":"0 to 1000","paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":"1 to 1000","paramType":"query"}],"response":[{"valueType":"List[wordFrequency]","errorResponses":[{"reason":"Invalid term supplied.","code":400},{"reason":"No results.","code":404}],"condition":"any"}],"category":"WordDetails","summary":"Searches words.","suggestedName":"searchWords","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}","description":"","operations":[{"parameters":[{"name":"permalink","description":"ID of WordOfTheDayList","required":false,"dataType":"string","paramType":"path"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"wordOfTheDayList","errorResponses":[{"reason":"Invalid id supplied","code":400},{"reason":"WordOfTheDayList not found","code":404}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Fetches a WordOfTheDayList by ID","suggestedName":"getWordOfTheDayList","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDay","description":"","operations":[{"parameters":[{"name":"date","description":"Fetches by date in yyyy-MM-dd","required":false,"dataType":"string","paramType":"query"},{"name":"category","description":"Filters response by category","required":false,"dataType":"string","paramType":"query"},{"name":"creator","description":"Filters response by username","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"WordOfTheDay","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"WordOfTheDay","summary":"Returns a specific WordOfTheDay","suggestedName":"getWordOfTheDay","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words","description":"","operations":[{"response":[{"valueType":"doc","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"Help","summary":"Returns information about API parameters","suggestedName":"getHelp","deprecated":false,"open":true,"httpMethod":"GET"}]},{"path":"/words.{format}/searchDefinitions","description":"","operations":[{"parameters":[{"name":"query","description":"Search term","required":true,"dataType":"string","paramType":"query"},{"name":"definedWordSearchTerm","description":"Defined word search term","required":false,"dataType":"string","paramType":"query"},{"name":"includeSourceDictionaries","description":"Only include these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":"ahd, century, wiktionary, webster, wordnet","paramType":"query"},{"name":"excludeSourceDictionaries","description":"Exclude these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":"ahd, century, wiktionary, webster, wordnet","paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"dataType":"string","paramType":"query"},{"name":"excludePartOfSpeech","description":"Exclude these comma-delimited parts of speech","required":false,"dataType":"string","paramType":"query"},{"name":"minCorpusCount","defaultValue":"5","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowableValues":"non-negative integer","paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":"non-negative integer","paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":"0 to 1024","paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":"0 to 1024","paramType":"query"},{"name":"expandTerms","description":"Expand terms","required":false,"dataType":"string","allowableValues":"synonym,hypernym","paramType":"query"},{"name":"wordTypes","description":"Word types","required":false,"dataType":"string","allowableValues":"word,multi-word-unit","paramType":"query"},{"name":"returnWordsOnly","defaultValue":"false","description":"Return words only","required":false,"dataType":"string","allowableValues":"false,true","paramAccess":"internal","paramType":"query"},{"name":"includeTags","defaultValue":"false","description":"Return a closed set of XML tags in response","required":false,"dataType":"string","allowableValues":"false,true","paramType":"query"},{"name":"useTagsForRanking","defaultValue":"true","description":"Use user tags, dictionary labels and hypernyms for ranking","required":false,"dataType":"string","allowableValues":"false,true","paramAccess":"internal","paramType":"query"},{"name":"sortBy","description":"Attribute to sort by","required":false,"dataType":"string","allowableValues":"alpha,count,length","paramType":"query"},{"name":"sortOrder","description":"Sort direction","required":false,"dataType":"string","allowableValues":"asc,desc","paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":"0 to 1000","paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":"1 to 1000","paramType":"query"}],"response":[{"valueType":"DefinitionSearchResults","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Searches definitions.","suggestedName":"searchDefinitions","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words.{format}/searchEntries","description":"","operations":[{"parameters":[{"name":"query","description":"Search term","required":true,"dataType":"string","paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":"0 to 1000","paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":"1 to 1000","paramType":"query"}],"response":[{"valueType":"EntrySearchResults","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Searches dictionary entries.","suggestedName":"searchEntries","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words.{format}/frequency","description":"","operations":[{"response":[{"valueType":"frequencySummary","errorResponses":[{"reason":"No data found.","code":404}],"condition":"any"}],"category":"WordDetails","summary":"Fetches corpus-level word frequency","suggestedName":"getFrequency","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words.{format}/surfaceForms","description":"","operations":[{"parameters":[{"name":"term","description":"Word to get surface forms for.","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"String","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Fetches surface forms of a word","suggestedName":"getSurfaceForms","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words.{format}/id/{id}","description":"","operations":[{"parameters":[{"name":"id","description":"ID of word","required":false,"dataType":"string","paramType":"path"}],"response":[{"valueType":"wordObject","errorResponses":[{"reason":"Invalid ID supplied.","code":400},{"reason":"No word found.","code":404}],"condition":"any"}],"category":"WordDetails","summary":"Fetches a word by ID","suggestedName":"getWordById","deprecated":false,"open":false,"notes":"Deprecated.","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDay/range","description":"","operations":[{"parameters":[{"name":"category","description":"Filters response by category","required":false,"dataType":"string","paramType":"query"},{"name":"creator","description":"Filters response by username","required":false,"dataType":"string","paramType":"query"},{"name":"provider","description":"Filters response by ContentProvider","required":false,"dataType":"string","paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[WordOfTheDay]","errorResponses":[{"reason":"No data available","code":404}],"condition":"any"}],"category":"WordOfTheDay","summary":"Returns a WordOfTheDay range","suggestedName":"getWordOfTheDayRange","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words.{format}/canonicalForms","description":"","operations":[{"parameters":[{"name":"term","description":"Word to get canonical forms for.","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"String","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Fetches canonical forms of a word","suggestedName":"getCanonicalForms","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words.{format}/search/{query}","description":"","operations":[{"parameters":[{"name":"allowRegex","defaultValue":"false","description":"Search query is a Regular Expression","required":false,"dataType":"string","allowableValues":"true | false","paramAccess":"internal","paramType":"query"},{"name":"query","description":"Search query","required":true,"dataType":"string","paramType":"path"},{"name":"caseSensitive","defaultValue":"true","description":"Search case sensitive","required":false,"dataType":"string","allowableValues":"true | false","paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"dataType":"string","allowableValues":"noun,adjective,verb,adverb,interjection,pronoun,preposition,abbreviation,affix,article,auxiliary-verb,conjunction,definite-article,family-name,given-name,idiom,imperative,noun-plural,noun-posessive,past-participle,phrasal-prefix,proper-noun,proper-noun-plural,proper-noun-posessive,suffix,verb-intransitive,verb-transitive","paramType":"query"},{"name":"excludePartOfSpeech","description":"Exclude these comma-delimited parts of speech","required":false,"dataType":"string","paramType":"query"},{"name":"minCorpusCount","defaultValue":"5","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowableValues":"non-negative integer","paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":"non-negative integer","paramType":"query"},{"name":"minDictionaryCount","defaultValue":"1","description":"Minimum number of dictionary entries","required":false,"dataType":"string","allowableValues":"non-negative integer","paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count","required":false,"dataType":"string","allowableValues":"non-negative integer","paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":"0 to 1024","paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":"0 to 1024","paramType":"query"},{"name":"minLexicalityRating","defaultValue":"0","description":"Minimum lexicality","required":false,"dataType":"string","allowableValues":"0 to 100","paramAccess":"internal","paramType":"query"},{"name":"maxLexicalityRating","defaultValue":"0","description":"Maximum lexicality","required":false,"dataType":"string","allowableValues":"0 to 100","paramAccess":"internal","paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":"0 to 1000","paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":"1 to 1000","paramType":"query"}],"response":[{"valueType":"wordSearchResults","errorResponses":[{"reason":"Invalid query supplied.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Searches words.","suggestedName":"searchWordsNew","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words.{format}/randomWords","description":"","operations":[{"parameters":[{"name":"hasDictionaryDef","description":"Only return words with dictionary definitions","required":false,"dataType":"string","allowableValues":"false,true","paramType":"query"},{"name":"includePartOfSpeech","description":"CSV part-of-speech values to include","required":false,"dataType":"string","allowableValues":"noun,adjective,verb,adverb,interjection,pronoun,preposition,abbreviation,affix,article,auxiliary-verb,conjunction,definite-article,family-name,given-name,idiom,imperative,noun-plural,noun-posessive,past-participle,phrasal-prefix,proper-noun,proper-noun-plural,proper-noun-posessive,suffix,verb-intransitive,verb-transitive","paramType":"query"},{"name":"excludePartOfSpeech","description":"CSV part-of-speech values to exclude","required":false,"dataType":"string","allowableValues":"noun,adjective,verb,adverb,interjection,pronoun,preposition,abbreviation,affix,article,auxiliary-verb,conjunction,definite-article,family-name,given-name,idiom,imperative,noun-plural,noun-posessive,past-participle,phrasal-prefix,proper-noun,proper-noun-plural,proper-noun-posessive,suffix,verb-intransitive,verb-transitive","paramType":"query"},{"name":"minCorpusCount","description":"Minimum corpus frequency for terms (integer)","required":false,"dataType":"string","paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms (integer)","required":false,"dataType":"string","paramType":"query"},{"name":"minDictionaryCount","description":"Minimum dictionary count (integer)","required":false,"dataType":"string","paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count (integer)","required":false,"dataType":"string","paramType":"query"},{"name":"minLength","description":"Minimum word length (characters)","required":false,"dataType":"string","paramType":"query"},{"name":"maxLength","description":"Maximum word length (characters)","required":false,"dataType":"string","paramType":"query"},{"name":"minLexicalityRating","description":"Minimum lexicality","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"},{"name":"maxLexicalityRating","description":"Maximum lexicality","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"},{"name":"sortBy","description":"Attribute to sort by","required":false,"dataType":"string","allowableValues":"alpha,count","paramType":"query"},{"name":"sortOrder","description":"Sort direction","required":false,"dataType":"string","allowableValues":"asc,desc","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[wordObject]","errorResponses":[{"reason":"Invalid term supplied.","code":400},{"reason":"No results.","code":404}],"condition":"any"}],"category":"WordDetails","summary":"Returns an array of random WordObjects, in the format specified by the URL","suggestedName":"getRandomWords","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words.{format}/randomWord","description":"","operations":[{"parameters":[{"name":"hasDictionaryDef","defaultValue":"true","description":"Only return words with dictionary definitions","required":false,"dataType":"string","allowableValues":"false,true","paramType":"query"},{"name":"includePartOfSpeech","description":"CSV part-of-speech values to include","required":false,"dataType":"string","allowableValues":"noun,adjective,verb,adverb,interjection,pronoun,preposition,abbreviation,affix,article,auxiliary-verb,conjunction,definite-article,family-name,given-name,idiom,imperative,noun-plural,noun-posessive,past-participle,phrasal-prefix,proper-noun,proper-noun-plural,proper-noun-posessive,suffix,verb-intransitive,verb-transitive","paramType":"query"},{"name":"excludePartOfSpeech","description":"CSV part-of-speech values to exclude","required":false,"dataType":"string","allowableValues":"noun,adjective,verb,adverb,interjection,pronoun,preposition,abbreviation,affix,article,auxiliary-verb,conjunction,definite-article,family-name,given-name,idiom,imperative,noun-plural,noun-posessive,past-participle,phrasal-prefix,proper-noun,proper-noun-plural,proper-noun-posessive,suffix,verb-intransitive,verb-transitive","paramType":"query"},{"name":"minCorpusCount","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","paramType":"query"},{"name":"minDictionaryCount","description":"Minimum dictionary count","required":false,"dataType":"string","paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count","required":false,"dataType":"string","paramType":"query"},{"name":"minLength","description":"Minimum word length","required":false,"dataType":"string","paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","paramType":"query"},{"name":"minLexicalityRating","description":"Minimum lexicality","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"},{"name":"maxLexicalityRating","description":"Maximum lexicality","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"wordObject","errorResponses":[{"reason":"No word found.","code":404}],"condition":"any"}],"category":"WordDetails","summary":"Returns a single random WordObject, in the format specified by the URL","suggestedName":"getRandomWord","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words.{format}/examples","description":"","operations":[{"parameters":[{"description":"Words to fetch examples for","required":false,"dataType":"String[]","paramType":"body"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[example]","errorResponses":[{"reason":"Invalid words to search with.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Fetches examples for multiple words.","suggestedName":"getExamplesForWords","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/words.{format}/mostCommentedOn","description":"","operations":[{"parameters":[{"name":"dayInterval","description":"Number of days to consider","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[commentSummary]","errorResponses":[{"reason":"Invalid time interval.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Fetches words most commented on.","suggestedName":"getWordsMostCommentedOn","deprecated":false,"open":false,"notes":"Set the dayInterval to determine the time frame.","httpMethod":"GET"}]},{"path":"/words.{format}/firstUsed/{statsType}/{object}","description":"","operations":[{"parameters":[{"name":"statsType","description":"DocumentStatsType dimension to filter by","required":false,"dataType":"string","paramType":"path"},{"name":"object","description":"Identifier of DocumentStatsType object","required":false,"dataType":"string","paramType":"path"},{"name":"detailed","description":"Return detailed data","required":false,"dataType":"string","paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[detailedWordUsage]","errorResponses":[{"reason":"Invalid time interval.","code":400}],"condition":"any"},{"valueType":"List[basicWordUsage]","errorResponses":[{"reason":"Invalid time interval.","code":400}],"condition":"any"}],"category":"WordDetails","summary":"Fetches words most commented on.","suggestedName":"getWordsMostCommentedOn","deprecated":false,"open":false,"notes":"Set the dayInterval to determine the time frame.","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}/invite","description":"","operations":[{"parameters":[{"name":"permalink","description":"ID of WordOfTheDayList","required":false,"dataType":"string","paramType":"path"},{"description":"Invitation to send","required":false,"dataType":"wotdListInvitation","paramType":"body"}],"response":[{"valueType":"void","errorResponses":[{"reason":"User is not eligible to send invitations","code":400},{"reason":"WordOfTheDayList not found.","code":404}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Invites users to a WordOfTheDayList","suggestedName":"inviteToWordOfTheDayList","deprecated":false,"open":false,"notes":"A user can invite up to 20 people in a single day. The users being invited will be checked to see if they have opted out of email communications","httpMethod":"POST"}]},{"path":"/words.{format}/wordOfTheDayLists/recent","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[wordOfTheDayList]","errorResponses":[{"reason":"No WordOfTheDayLists found.","code":404}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Fetches recently created WordOfTheDayLists","suggestedName":"getRecentWordOfTheDayLists","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}/{specifier}","description":"","operations":[{"parameters":[{"name":"permalink","description":"ID of WordOfTheDayList","required":false,"dataType":"string","paramType":"path"},{"name":"specifier","description":"Specifier for the item to fetch.  Either 'current' or a date.","required":false,"dataType":"string","paramType":"path"},{"name":"includeExtraHtml","description":"Include extra HTML if available","required":false,"dataType":"string","paramAccess":"internal","paramType":"query"}],"response":[{"valueType":"WordOfTheDay","errorResponses":[{"reason":"Invalid id supplied","code":400},{"reason":"WordOfTheDayList not found","code":404}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Fetches a WordOfTheDayList by ID","suggestedName":"getWordOfTheDayListItem","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayLists","description":"","operations":[{"parameters":[{"name":"containsWord","description":"Lists must contain a specific word","required":false,"dataType":"string","paramType":"query"},{"name":"subscriberCount","description":"Lists must have the specified number of subscribers","required":false,"dataType":"string","paramType":"query"},{"name":"itemCount","description":"Lists must have the specified number of items","required":true,"dataType":"string","paramType":"query"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[wordOfTheDayList]","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Fetches an array of WordOfTheDayList basd on a criteria","suggestedName":"getWordOfTheDayListsContainingWord","deprecated":false,"open":false,"httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayLists/subscriptionProcess","description":"","operations":[{"parameters":[{"name":"date","description":"Date string to fetch for.","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"String","errorResponses":[{"reason":"Invalid date format supplied.","code":400}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Returns whether or not a subscription process has been run.","suggestedName":"getWordOfTheDayListSubscriptionProcessStatus","deprecated":false,"open":false,"notes":"Uses the current server time (day resolution) as the default date to check for, optionally a dateString can be supplied for a specific date to check for.","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}/subscription","description":"","operations":[{"parameters":[{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","paramType":"header"},{"name":"permalink","description":"ID of WordOfTheDayList","required":false,"dataType":"string","paramType":"path"},{"name":"medium","description":"Medium to subscribe with","required":false,"dataType":"string","paramType":"query"},{"description":"Username to subscribe","required":false,"dataType":"string","paramType":"body"}],"response":[{"valueType":"void","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not authorized to subscribe","code":403},{"reason":"WordOfTheDayList or User not found","code":404}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Subscribes a user to a WordOfTheDayList","suggestedName":"subscribeToList","deprecated":false,"open":false,"httpMethod":"POST"}]},{"path":"/words.{format}/wordOfTheDayLists/{date}","description":"","operations":[{"parameters":[{"name":"date","description":"ID of WordOfTheDayList","required":false,"dataType":"string","paramType":"path"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","paramType":"query"}],"response":[{"valueType":"List[WordOfTheDay]","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"WordOfTheDayList or User not found","code":404}],"condition":"any"}],"category":"WordOfTheDayList","summary":"Fetches WordOfTheDay objects for a specific date","suggestedName":"getWordOfTheDayListsForDate","deprecated":false,"open":false,"httpMethod":"GET"}]}],"models":[{"name":"EntrySearchResult","fields":[{"name":"definition","required":false,"wrapperName":"definitions","paramType":"List[definition]"},{"name":"sourceDictionary","required":false,"paramType":"string"},{"name":"headWord","required":false,"paramType":"string"},{"name":"entryId","required":false,"paramType":"long"}]},{"name":"commentSummary","fields":[{"name":"objectType","required":false,"paramType":"string"},{"name":"totalCount","required":false,"paramType":"long"},{"name":"objectName","required":false,"paramType":"string"},{"name":"countInInterval","required":false,"paramType":"long"},{"name":"intervalInMilliseconds","required":false,"paramType":"long"},{"name":"objectDisplayName","required":false,"paramType":"string"}]},{"name":"object","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"fields","required":false,"paramType":"List[parameter]"},{"name":"uniqueFieldName","required":false,"paramType":"string"}]},{"name":"wordOfTheDayList","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":true,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"category","required":false,"paramType":"string"},{"name":"createdBy","required":false,"paramType":"string"},{"name":"items","required":false,"paramType":"List[WordOfTheDay]"},{"name":"subscriberCount","required":false,"paramType":"int"},{"name":"subscriptionStatus","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"commentCount","required":false,"paramType":"int"},{"name":"voteCount","required":false,"paramType":"integer"},{"name":"voteAverage","required":false,"paramType":"float"},{"name":"voteWeightedAverage","required":false,"paramType":"float"},{"name":"itemCount","required":false,"paramType":"int"},{"name":"firstItemDate","required":false,"paramType":"Date"},{"name":"lastItemDate","required":false,"paramType":"Date"},{"name":"subscriptionSchedule","required":false,"paramType":"string"},{"name":"subscriptionNamespace","required":false,"paramType":"string"},{"name":"subscriptionIdentifier","required":false,"paramType":"string"}]},{"name":"example","fields":[{"name":"year","required":false,"paramType":"integer"},{"name":"provider","required":false,"paramType":"contentProvider"},{"name":"url","required":false,"paramType":"string"},{"name":"word","required":false,"paramType":"string"},{"name":"text","required":false,"paramType":"string"},{"name":"title","required":false,"paramType":"string"},{"name":"rating","required":false,"paramType":"float"},{"name":"exampleId","required":false,"paramType":"long"},{"name":"documentId","required":false,"paramType":"long"}]},{"name":"WordSearchResult","fields":[{"name":"count","required":false,"paramType":"long"},{"name":"word","required":false,"paramType":"string"},{"name":"lexicality","required":false,"paramType":"double"}]},{"name":"definition","fields":[{"name":"exampleUsage","required":false,"wrapperName":"exampleUses","paramType":"List[ExampleUsage]"},{"name":"word","required":false,"paramType":"string"},{"name":"text","required":false,"paramType":"string"},{"name":"textPron","required":false,"wrapperName":"textProns","paramType":"List[textPron]"},{"name":"score","required":false,"paramType":"float"},{"name":"partOfSpeech","required":false,"paramType":"string"},{"name":"note","required":false,"wrapperName":"notes","paramType":"List[note]"},{"name":"citation","required":false,"wrapperName":"citations","paramType":"List[citation]"},{"name":"relWord","required":false,"wrapperName":"relatedWords","paramType":"List[related]"},{"name":"sourceDictionary","required":false,"paramType":"string"},{"name":"label","required":false,"wrapperName":"labels","paramType":"List[Label]"},{"name":"sequence","required":false,"paramType":"string"},{"name":"seqString","required":false,"paramType":"string"},{"name":"extendedText","required":false,"paramType":"string"}]},{"name":"category","fields":[{"name":"name","required":false,"paramType":"string"}]},{"name":"basicWordUsage","fields":[{"name":"year","required":false,"paramType":"integer"},{"name":"wordstring","required":false,"paramType":"string"},{"name":"documentId","required":false,"paramType":"long"},{"name":"sentenceId","required":false,"paramType":"long"}]},{"name":"response","fields":[{"name":"valueType","required":false,"paramType":"string"},{"name":"errorResponses","required":false,"paramType":"List[error]"},{"name":"occurs","required":false,"paramType":"string"},{"name":"condition","required":false,"paramType":"string"}]},{"name":"frequency","fields":[{"name":"year","required":false,"paramType":"int"},{"name":"count","required":false,"paramType":"long"}]},{"name":"contentProvider","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"doc","fields":[{"name":"endPoints","required":false,"paramType":"List[endpoint]"},{"name":"models","required":false,"paramType":"List[object]"}]},{"name":"root","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"categories","required":false,"paramType":"List[category]"}]},{"name":"frequencySummary","fields":[{"name":"word","required":false,"paramType":"string"},{"name":"totalCount","required":false,"paramType":"long"},{"name":"frequency","required":false,"paramType":"List[frequency]"},{"name":"unknownYearCount","required":false,"paramType":"int"}]},{"name":"detailedWordUsage","fields":[{"name":"wordstring","required":false,"paramType":"string"},{"name":"sentence","required":false,"paramType":"sentence"},{"name":"metadata","required":false,"paramType":"documentMetadata"}]},{"name":"scoredWord","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"wordType","required":false,"paramType":"string"},{"name":"position","required":false,"paramType":"int"},{"name":"word","required":false,"paramType":"string"},{"name":"score","required":false,"paramType":"float"},{"name":"sentenceId","required":false,"paramType":"long"},{"name":"partOfSpeech","required":false,"paramType":"string"}]},{"name":"SimpleDefinition","fields":[{"name":"text","required":false,"paramType":"string"},{"name":"partOfSpeech","required":false,"paramType":"string"},{"name":"note","required":false,"paramType":"string"},{"name":"source","required":false,"paramType":"string"}]},{"name":"endpoint","fields":[{"name":"path","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"operations","required":false,"paramType":"List[operation]"}]},{"name":"operation","fields":[{"name":"parameters","required":false,"paramType":"List[parameter]"},{"name":"response","required":false,"paramType":"List[response]"},{"name":"category","required":false,"paramType":"string"},{"name":"summary","required":false,"paramType":"string"},{"name":"suggestedName","required":false,"paramType":"string"},{"name":"deprecated","required":false,"paramType":"boolean"},{"name":"open","required":false,"paramType":"boolean"},{"name":"notes","required":false,"paramType":"string"},{"name":"httpMethod","required":false,"paramType":"string"}]},{"name":"wordFrequency","fields":[{"name":"count","required":false,"paramType":"long"},{"name":"wordstring","required":false,"paramType":"string"}]},{"name":"sentence","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"scoredWord","required":false,"wrapperName":"scoredWords","paramType":"List[scoredWord]"},{"name":"display","required":false,"paramType":"string"},{"name":"documentMetadataId","required":false,"paramType":"long"},{"name":"rating","required":false,"paramType":"int"}]},{"name":"error","fields":[{"name":"reason","required":false,"paramType":"string"},{"name":"code","required":false,"paramType":"int"}]},{"name":"wordObject","fields":[{"name":"word","required":false,"paramType":"string"},{"name":"vulgar","required":false,"paramType":"string"}]},{"name":"documentMetadata","fields":[{"name":"id","required":false,"paramType":"long"},{"name":"year","required":false,"paramType":"integer"},{"name":"contentType","required":false,"paramType":"contentType"},{"name":"provider","required":false,"paramType":"contentProvider"},{"name":"tag","required":false,"wrapperName":"tags","paramType":"List[string]"},{"name":"title","required":false,"paramType":"string"},{"name":"rating","required":false,"paramType":"double"},{"name":"medium","required":false,"paramType":"documentMedium"},{"name":"sourceUrl","required":false,"paramType":"string"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"stats","required":false,"paramType":"basicDocumentStats"},{"name":"date","required":false,"paramType":"Date"},{"name":"classification","required":false,"paramType":"subjectClassificationType"},{"name":"yearType","required":false,"paramType":"yearType"},{"name":"primaryAuthor","required":false,"paramType":"string"},{"name":"primaryAuthorType","required":false,"paramType":"authorType"},{"name":"primaryAuthorId","required":false,"paramType":"long"},{"name":"guid","required":false,"paramType":"string"},{"name":"extendedMetadata","required":false,"paramType":"extendedMetadata"},{"name":"author","required":false,"wrapperName":"authors","paramType":"List[author]"},{"name":"expirationDate","required":false,"paramType":"Date"}]},{"name":"partOfSpeech","fields":[{"name":"roots","required":false,"paramType":"List[root]"}]},{"name":"wordSearchResults","fields":[{"name":"totalResults","required":false,"paramType":"int"},{"name":"searchResult","required":false,"wrapperName":"searchResults","paramType":"List[WordSearchResult]"}]},{"name":"parameter","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"defaultValue","required":false,"paramType":"string"},{"name":"description","required":false,"paramType":"string"},{"name":"required","required":false,"paramType":"boolean"},{"name":"dataType","required":false,"paramType":"string"},{"name":"allowableValues","required":false,"paramType":"string"},{"name":"wrapperName","required":false,"paramType":"string"},{"name":"internalDescription","required":false,"paramType":"string"},{"name":"paramAccess","required":false,"paramType":"string"},{"name":"paramType","required":false,"paramType":"string"}]},{"name":"WordOfTheDay","fields":[{"name":"id","required":true,"paramType":"long"},{"name":"category","required":false,"paramType":"string"},{"name":"example","required":false,"wrapperName":"examples","paramType":"List[SimpleExample]"},{"name":"word","required":false,"paramType":"string"},{"name":"createdBy","required":false,"paramType":"string"},{"name":"definition","required":false,"wrapperName":"definitions","paramType":"List[SimpleDefinition]"},{"name":"contentProvider","required":false,"paramType":"contentProvider"},{"name":"createdAt","required":false,"paramType":"Date"},{"name":"publishDate","required":false,"paramType":"Date"},{"name":"parentId","required":false,"paramType":"string"},{"name":"note","required":false,"paramType":"string"},{"name":"htmlExtra","required":false,"paramType":"string"}]},{"name":"DefinitionSearchResults","fields":[{"name":"totalResults","required":false,"paramType":"int"},{"name":"result","required":false,"wrapperName":"results","paramType":"List[definition]"}]},{"name":"SubscriptionStatus","fields":[{"name":"name","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"int"}]},{"name":"EntrySearchResults","fields":[{"name":"totalResults","required":false,"paramType":"int"},{"name":"searchResult","required":false,"wrapperName":"searchResults","paramType":"List[EntrySearchResult]"}]},{"name":"SimpleExample","fields":[{"name":"url","required":false,"paramType":"string"},{"name":"text","required":false,"paramType":"string"},{"name":"title","required":false,"paramType":"string"},{"name":"id","required":false,"paramType":"long"}]}]}
+{"resourcePath":"/words","models":{"SubscriptionStatus":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"SubscriptionStatus","type":"any","required":false,"uniqueItems":false},"wordOfTheDayList":{"properties":{"subscriptionNamespace":{"type":"string","required":false,"uniqueItems":false},"subscriberCount":{"type":"int","required":false,"uniqueItems":false},"commentCount":{"type":"int","required":false,"uniqueItems":false},"subscriptionIdentifier":{"type":"string","required":false,"uniqueItems":false},"firstItemDate":{"type":"Date","required":false,"uniqueItems":false},"voteCount":{"type":"integer","required":false,"uniqueItems":false},"id":{"type":"string","required":true,"uniqueItems":false},"category":{"type":"string","required":false,"uniqueItems":false},"createdBy":{"type":"string","required":false,"uniqueItems":false},"items":{"type":"array","required":false,"items":{"$ref":"WordOfTheDay","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false},"voteWeightedAverage":{"type":"float","required":false,"uniqueItems":false},"subscriptionSchedule":{"type":"string","required":false,"uniqueItems":false},"lastItemDate":{"type":"Date","required":false,"uniqueItems":false},"voteAverage":{"type":"float","required":false,"uniqueItems":false},"itemCount":{"type":"int","required":false,"uniqueItems":false},"subscriptionStatus":{"type":"string","required":false,"uniqueItems":false}},"id":"wordOfTheDayList","type":"any","required":false,"uniqueItems":false},"detailedWordUsage":{"properties":{"sentence":{"type":"sentence","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false},"metadata":{"type":"documentMetadata","required":false,"uniqueItems":false}},"id":"detailedWordUsage","type":"any","required":false,"uniqueItems":false},"yearType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"yearType","type":"any","required":false,"uniqueItems":false},"extendedMetadata":{"properties":{"sourceFileSize":{"type":"long","required":false,"uniqueItems":false},"issn":{"type":"string","required":false,"uniqueItems":false},"isbn":{"type":"string","required":false,"uniqueItems":false},"lccn":{"type":"string","required":false,"uniqueItems":false},"documentMetadataId":{"type":"long","required":false,"uniqueItems":false}},"id":"extendedMetadata","type":"any","required":false,"uniqueItems":false},"WordOfTheDay":{"properties":{"id":{"type":"long","required":true,"uniqueItems":false},"parentId":{"type":"string","required":false,"uniqueItems":false},"category":{"type":"string","required":false,"uniqueItems":false},"definition":{"type":"array","required":false,"items":{"$ref":"SimpleDefinition","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"createdBy":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"contentProvider":{"type":"contentProvider","required":false,"uniqueItems":false},"htmlExtra":{"type":"string","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"example":{"type":"array","required":false,"items":{"$ref":"SimpleExample","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"note":{"type":"string","required":false,"uniqueItems":false},"publishDate":{"type":"Date","required":false,"uniqueItems":false}},"id":"WordOfTheDay","type":"any","required":false,"uniqueItems":false},"sentence":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"display":{"type":"string","required":false,"uniqueItems":false},"rating":{"type":"int","required":false,"uniqueItems":false},"documentMetadataId":{"type":"long","required":false,"uniqueItems":false},"scoredWord":{"type":"array","required":false,"items":{"$ref":"scoredWord","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"sentence","type":"any","required":false,"uniqueItems":false},"documentMedium":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"documentMedium","type":"any","required":false,"uniqueItems":false},"frequency":{"properties":{"count":{"type":"long","required":false,"uniqueItems":false},"year":{"type":"int","required":false,"uniqueItems":false}},"id":"frequency","type":"any","required":false,"uniqueItems":false},"contentType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"contentType","type":"any","required":false,"uniqueItems":false},"documentMetadata":{"properties":{"yearType":{"type":"yearType","required":false,"uniqueItems":false},"expirationDate":{"type":"Date","required":false,"uniqueItems":false},"extendedMetadata":{"type":"extendedMetadata","required":false,"uniqueItems":false},"stats":{"type":"basicDocumentStats","required":false,"uniqueItems":false},"tag":{"type":"array","required":false,"items":{"type":"string","required":false,"uniqueItems":false},"uniqueItems":false},"provider":{"type":"contentProvider","required":false,"uniqueItems":false},"contentType":{"type":"contentType","required":false,"uniqueItems":false},"sourceUrl":{"type":"string","required":false,"uniqueItems":false},"date":{"type":"Date","required":false,"uniqueItems":false},"medium":{"type":"documentMedium","required":false,"uniqueItems":false},"guid":{"type":"string","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"author":{"type":"array","required":false,"items":{"$ref":"author","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"title":{"type":"string","required":false,"uniqueItems":false},"primaryAuthorType":{"type":"authorType","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"classification":{"type":"subjectClassificationType","required":false,"uniqueItems":false},"year":{"type":"integer","required":false,"uniqueItems":false},"primaryAuthor":{"type":"string","required":false,"uniqueItems":false},"rating":{"type":"double","required":false,"uniqueItems":false},"primaryAuthorId":{"type":"long","required":false,"uniqueItems":false}},"id":"documentMetadata","type":"any","required":false,"uniqueItems":false},"author":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"authorType":{"type":"authorType","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"description":{"type":"string","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false},"uniqueName":{"type":"string","required":false,"uniqueItems":false}},"id":"author","type":"any","required":false,"uniqueItems":false},"wordSearchResults":{"properties":{"searchResult":{"type":"array","required":false,"items":{"$ref":"WordSearchResult","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"totalResults":{"type":"int","required":false,"uniqueItems":false}},"id":"wordSearchResults","type":"any","required":false,"uniqueItems":false},"SimpleDefinition":{"properties":{"text":{"type":"string","required":false,"uniqueItems":false},"source":{"type":"string","required":false,"uniqueItems":false},"note":{"type":"string","required":false,"uniqueItems":false},"partOfSpeech":{"type":"string","required":false,"uniqueItems":false}},"id":"SimpleDefinition","type":"any","required":false,"uniqueItems":false},"wordObject":{"properties":{"word":{"type":"string","required":false,"uniqueItems":false},"vulgar":{"type":"string","required":false,"uniqueItems":false}},"id":"wordObject","type":"any","required":false,"uniqueItems":false},"wotdListInvitation":{"properties":{"failure":{"type":"array","required":false,"items":{"type":"string","required":false,"uniqueItems":false},"uniqueItems":false},"permalink":{"type":"string","required":false,"uniqueItems":false},"createdBy":{"type":"string","required":false,"uniqueItems":false},"createdAt":{"type":"Date","required":false,"uniqueItems":false},"recipient":{"type":"array","required":false,"items":{"type":"string","required":false,"uniqueItems":false},"uniqueItems":false},"note":{"type":"string","required":false,"uniqueItems":false}},"id":"wotdListInvitation","type":"any","required":false,"uniqueItems":false},"wordFrequency":{"properties":{"count":{"type":"long","required":false,"uniqueItems":false},"wordstring":{"type":"string","required":false,"uniqueItems":false}},"id":"wordFrequency","type":"any","required":false,"uniqueItems":false},"authorType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"authorType","type":"any","required":false,"uniqueItems":false},"definition":{"properties":{"extendedText":{"type":"string","required":false,"uniqueItems":false},"citation":{"type":"array","required":false,"items":{"$ref":"citation","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"text":{"type":"string","required":false,"uniqueItems":false},"sourceDictionary":{"type":"string","required":false,"uniqueItems":false},"exampleUsage":{"type":"array","required":false,"items":{"$ref":"ExampleUsage","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"relWord":{"type":"array","required":false,"items":{"$ref":"related","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"score":{"type":"float","required":false,"uniqueItems":false},"label":{"type":"array","required":false,"items":{"$ref":"Label","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"seqString":{"type":"string","required":false,"uniqueItems":false},"sequence":{"type":"string","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"note":{"type":"array","required":false,"items":{"$ref":"note","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"textPron":{"type":"array","required":false,"items":{"$ref":"textPron","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"partOfSpeech":{"type":"string","required":false,"uniqueItems":false}},"id":"definition","type":"any","required":false,"uniqueItems":false},"WordSearchResult":{"properties":{"count":{"type":"long","required":false,"uniqueItems":false},"lexicality":{"type":"double","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false}},"id":"WordSearchResult","type":"any","required":false,"uniqueItems":false},"commentSummary":{"properties":{"objectDisplayName":{"type":"string","required":false,"uniqueItems":false},"objectName":{"type":"string","required":false,"uniqueItems":false},"totalCount":{"type":"long","required":false,"uniqueItems":false},"countInInterval":{"type":"long","required":false,"uniqueItems":false},"intervalInMilliseconds":{"type":"long","required":false,"uniqueItems":false},"objectType":{"type":"string","required":false,"uniqueItems":false}},"id":"commentSummary","type":"any","required":false,"uniqueItems":false},"subjectClassificationType":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"subjectClassificationType","type":"any","required":false,"uniqueItems":false},"EntrySearchResult":{"properties":{"sourceDictionary":{"type":"string","required":false,"uniqueItems":false},"definition":{"type":"array","required":false,"items":{"$ref":"definition","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"headWord":{"type":"string","required":false,"uniqueItems":false},"entryId":{"type":"long","required":false,"uniqueItems":false}},"id":"EntrySearchResult","type":"any","required":false,"uniqueItems":false},"DefinitionSearchResults":{"properties":{"result":{"type":"array","required":false,"items":{"$ref":"definition","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"totalResults":{"type":"int","required":false,"uniqueItems":false}},"id":"DefinitionSearchResults","type":"any","required":false,"uniqueItems":false},"scoredWord":{"properties":{"position":{"type":"int","required":false,"uniqueItems":false},"id":{"type":"long","required":false,"uniqueItems":false},"wordType":{"type":"string","required":false,"uniqueItems":false},"score":{"type":"float","required":false,"uniqueItems":false},"sentenceId":{"type":"long","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"partOfSpeech":{"type":"string","required":false,"uniqueItems":false}},"id":"scoredWord","type":"any","required":false,"uniqueItems":false},"basicDocumentStats":{"properties":{"uniqueBiGramsCount":{"type":"long","required":false,"uniqueItems":false},"wordsCount":{"type":"long","required":false,"uniqueItems":false},"documentsCount":{"type":"long","required":false,"uniqueItems":false},"firstUsedWordsCount":{"type":"long","required":false,"uniqueItems":false},"tokensCount":{"type":"long","required":false,"uniqueItems":false},"sentencesCount":{"type":"long","required":false,"uniqueItems":false},"viableSentencesCount":{"type":"long","required":false,"uniqueItems":false},"type":{"type":"string","required":false,"uniqueItems":false},"uniqueWordsCount":{"type":"long","required":false,"uniqueItems":false},"key":{"type":"string","required":false,"uniqueItems":false}},"id":"basicDocumentStats","type":"any","required":false,"uniqueItems":false},"contentProvider":{"properties":{"id":{"type":"int","required":false,"uniqueItems":false},"name":{"type":"string","required":false,"uniqueItems":false}},"id":"contentProvider","type":"any","required":false,"uniqueItems":false},"EntrySearchResults":{"properties":{"searchResult":{"type":"array","required":false,"items":{"$ref":"EntrySearchResult","type":"any","required":false,"uniqueItems":false},"uniqueItems":false},"totalResults":{"type":"int","required":false,"uniqueItems":false}},"id":"EntrySearchResults","type":"any","required":false,"uniqueItems":false},"example":{"properties":{"exampleId":{"type":"long","required":false,"uniqueItems":false},"title":{"type":"string","required":false,"uniqueItems":false},"text":{"type":"string","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"provider":{"type":"contentProvider","required":false,"uniqueItems":false},"year":{"type":"integer","required":false,"uniqueItems":false},"rating":{"type":"float","required":false,"uniqueItems":false},"documentId":{"type":"long","required":false,"uniqueItems":false},"url":{"type":"string","required":false,"uniqueItems":false}},"id":"example","type":"any","required":false,"uniqueItems":false},"SimpleExample":{"properties":{"id":{"type":"long","required":false,"uniqueItems":false},"title":{"type":"string","required":false,"uniqueItems":false},"text":{"type":"string","required":false,"uniqueItems":false},"url":{"type":"string","required":false,"uniqueItems":false}},"id":"SimpleExample","type":"any","required":false,"uniqueItems":false},"frequencySummary":{"properties":{"unknownYearCount":{"type":"int","required":false,"uniqueItems":false},"totalCount":{"type":"long","required":false,"uniqueItems":false},"word":{"type":"string","required":false,"uniqueItems":false},"frequency":{"type":"array","required":false,"items":{"$ref":"frequency","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"frequencySummary","type":"any","required":false,"uniqueItems":false},"partOfSpeech":{"properties":{"roots":{"type":"array","required":false,"items":{"$ref":"root","type":"any","required":false,"uniqueItems":false},"uniqueItems":false}},"id":"partOfSpeech","type":"any","required":false,"uniqueItems":false}},"apis":[{"path":"/words.{format}/search","description":"","operations":[{"parameters":[{"name":"allowRegex","defaultValue":"false","description":"Search term is a Regular Expression","required":false,"dataType":"string","allowableValues":["true | false"],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"query","description":"Search term","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"caseSensitive","defaultValue":"true","description":"Search case sensitive","required":false,"dataType":"string","allowableValues":["true | false"],"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"dataType":"string","allowableValues":["noun","adjective","verb","adverb","interjection","pronoun","preposition","abbreviation","affix","article","auxiliary-verb","conjunction","definite-article","family-name","given-name","idiom","imperative","noun-plural","noun-posessive","past-participle","phrasal-prefix","proper-noun","proper-noun-plural","proper-noun-posessive","suffix","verb-intransitive","verb-transitive"],"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"Exclude these comma-delimited parts of speech","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","defaultValue":"5","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowableValues":["non-negative integer"],"allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":["non-negative integer"],"allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","defaultValue":"1","description":"Minimum number of dictionary entries","required":false,"dataType":"string","allowableValues":["non-negative integer"],"allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count","required":false,"dataType":"string","allowableValues":["non-negative integer"],"allowMultiple":false,"paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":["0 to 1024"],"allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":["0 to 1024"],"allowMultiple":false,"paramType":"query"},{"name":"minLexicalityRating","defaultValue":"0","description":"Minimum lexicality","required":false,"dataType":"string","allowableValues":["0 to 100"],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","defaultValue":"0","description":"Maximum lexicality","required":false,"dataType":"string","allowableValues":["0 to 100"],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":["0 to 1000"],"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":["1 to 1000"],"allowMultiple":false,"paramType":"query"}],"summary":"Searches words.","httpMethod":"GET","errorResponses":[{"reason":"Invalid term supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"searchWords","responseClass":"List[wordFrequency]"}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}","description":"","operations":[{"parameters":[{"name":"permalink","description":"ID of WordOfTheDayList","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches a WordOfTheDayList by ID","httpMethod":"GET","errorResponses":[{"reason":"Invalid id supplied","code":400},{"reason":"WordOfTheDayList not found","code":404}],"nickname":"getWordOfTheDayList","responseClass":"wordOfTheDayList"}]},{"path":"/words.{format}/wordOfTheDay","description":"","operations":[{"parameters":[{"name":"date","description":"Fetches by date in yyyy-MM-dd","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"category","description":"Filters response by category","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"creator","description":"Filters response by username","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns a specific WordOfTheDay","httpMethod":"GET","nickname":"getWordOfTheDay","responseClass":"WordOfTheDay"}]},{"path":"/words.{format}/searchDefinitions","description":"","operations":[{"parameters":[{"name":"query","description":"Search term","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"definedWordSearchTerm","description":"Defined word search term","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"includeSourceDictionaries","description":"Only include these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":["ahd"," century"," wiktionary"," webster"," wordnet"],"allowMultiple":false,"paramType":"query"},{"name":"excludeSourceDictionaries","description":"Exclude these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":["ahd"," century"," wiktionary"," webster"," wordnet"],"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"Exclude these comma-delimited parts of speech","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","defaultValue":"5","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowableValues":["non-negative integer"],"allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":["non-negative integer"],"allowMultiple":false,"paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":["0 to 1024"],"allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":["0 to 1024"],"allowMultiple":false,"paramType":"query"},{"name":"expandTerms","description":"Expand terms","required":false,"dataType":"string","allowableValues":["synonym","hypernym"],"allowMultiple":false,"paramType":"query"},{"name":"wordTypes","description":"Word types","required":false,"dataType":"string","allowableValues":["word","multi-word-unit"],"allowMultiple":false,"paramType":"query"},{"name":"returnWordsOnly","defaultValue":"false","description":"Return words only","required":false,"dataType":"string","allowableValues":["false","true"],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"includeTags","defaultValue":"false","description":"Return a closed set of XML tags in response","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"},{"name":"useTagsForRanking","defaultValue":"true","description":"Use user tags, dictionary labels and hypernyms for ranking","required":false,"dataType":"string","allowableValues":["false","true"],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"sortBy","description":"Attribute to sort by","required":false,"dataType":"string","allowableValues":["alpha","count","length"],"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort direction","required":false,"dataType":"string","allowableValues":["asc","desc"],"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":["0 to 1000"],"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":["1 to 1000"],"allowMultiple":false,"paramType":"query"}],"summary":"Searches definitions.","httpMethod":"GET","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"searchDefinitions","responseClass":"DefinitionSearchResults"}]},{"path":"/words.{format}/searchEntries","description":"","operations":[{"parameters":[{"name":"query","description":"Search term","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":["0 to 1000"],"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":["1 to 1000"],"allowMultiple":false,"paramType":"query"}],"summary":"Searches dictionary entries.","httpMethod":"GET","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"searchEntries","responseClass":"EntrySearchResults"}]},{"path":"/words.{format}/frequency","description":"","operations":[{"summary":"Fetches corpus-level word frequency","httpMethod":"GET","errorResponses":[{"reason":"No data found.","code":404}],"nickname":"getFrequency","responseClass":"frequencySummary"}]},{"path":"/words.{format}/surfaceForms","description":"","operations":[{"parameters":[{"name":"term","description":"Word to get surface forms for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches surface forms of a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"getSurfaceForms","responseClass":"String"}]},{"path":"/words.{format}/id/{id}","description":"","operations":[{"parameters":[{"name":"id","description":"ID of word","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"}],"summary":"Fetches a word by ID","httpMethod":"GET","errorResponses":[{"reason":"Invalid ID supplied.","code":400},{"reason":"No word found.","code":404}],"nickname":"getWordById","responseClass":"wordObject","notes":"Deprecated."}]},{"path":"/words.{format}/wordOfTheDay/range","description":"","operations":[{"parameters":[{"name":"category","description":"Filters response by category","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"creator","description":"Filters response by username","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"provider","description":"Filters response by ContentProvider","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns a WordOfTheDay range","httpMethod":"GET","nickname":"getWordOfTheDayRange","responseClass":"List[WordOfTheDay]"}]},{"path":"/words.{format}/canonicalForms","description":"","operations":[{"parameters":[{"name":"term","description":"Word to get canonical forms for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches canonical forms of a word","httpMethod":"GET","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"getCanonicalForms","responseClass":"String"}]},{"path":"/words.{format}/search/{query}","description":"","operations":[{"parameters":[{"name":"allowRegex","defaultValue":"false","description":"Search query is a Regular Expression","required":false,"dataType":"string","allowableValues":["true | false"],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"query","description":"Search query","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"caseSensitive","defaultValue":"true","description":"Search case sensitive","required":false,"dataType":"string","allowableValues":["true | false"],"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"dataType":"string","allowableValues":["noun","adjective","verb","adverb","interjection","pronoun","preposition","abbreviation","affix","article","auxiliary-verb","conjunction","definite-article","family-name","given-name","idiom","imperative","noun-plural","noun-posessive","past-participle","phrasal-prefix","proper-noun","proper-noun-plural","proper-noun-posessive","suffix","verb-intransitive","verb-transitive"],"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"Exclude these comma-delimited parts of speech","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","defaultValue":"5","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowableValues":["non-negative integer"],"allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":["non-negative integer"],"allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","defaultValue":"1","description":"Minimum number of dictionary entries","required":false,"dataType":"string","allowableValues":["non-negative integer"],"allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count","required":false,"dataType":"string","allowableValues":["non-negative integer"],"allowMultiple":false,"paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":["0 to 1024"],"allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":["0 to 1024"],"allowMultiple":false,"paramType":"query"},{"name":"minLexicalityRating","defaultValue":"0","description":"Minimum lexicality","required":false,"dataType":"string","allowableValues":["0 to 100"],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","defaultValue":"0","description":"Maximum lexicality","required":false,"dataType":"string","allowableValues":["0 to 100"],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":["0 to 1000"],"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":["1 to 1000"],"allowMultiple":false,"paramType":"query"}],"summary":"Searches words.","httpMethod":"GET","errorResponses":[{"reason":"Invalid query supplied.","code":400}],"nickname":"searchWordsNew","responseClass":"wordSearchResults"}]},{"path":"/words.{format}/randomWords","description":"","operations":[{"parameters":[{"name":"hasDictionaryDef","description":"Only return words with dictionary definitions","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"CSV part-of-speech values to include","required":false,"dataType":"string","allowableValues":["noun","adjective","verb","adverb","interjection","pronoun","preposition","abbreviation","affix","article","auxiliary-verb","conjunction","definite-article","family-name","given-name","idiom","imperative","noun-plural","noun-posessive","past-participle","phrasal-prefix","proper-noun","proper-noun-plural","proper-noun-posessive","suffix","verb-intransitive","verb-transitive"],"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"CSV part-of-speech values to exclude","required":false,"dataType":"string","allowableValues":["noun","adjective","verb","adverb","interjection","pronoun","preposition","abbreviation","affix","article","auxiliary-verb","conjunction","definite-article","family-name","given-name","idiom","imperative","noun-plural","noun-posessive","past-participle","phrasal-prefix","proper-noun","proper-noun-plural","proper-noun-posessive","suffix","verb-intransitive","verb-transitive"],"allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","description":"Minimum corpus frequency for terms (integer)","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms (integer)","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","description":"Minimum dictionary count (integer)","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count (integer)","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"minLength","description":"Minimum word length (characters)","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length (characters)","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"minLexicalityRating","description":"Minimum lexicality","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","description":"Maximum lexicality","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"sortBy","description":"Attribute to sort by","required":false,"dataType":"string","allowableValues":["alpha","count"],"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort direction","required":false,"dataType":"string","allowableValues":["asc","desc"],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns an array of random WordObjects, in the format specified by the URL","httpMethod":"GET","errorResponses":[{"reason":"Invalid term supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getRandomWords","responseClass":"List[wordObject]"}]},{"path":"/words.{format}/randomWord","description":"","operations":[{"parameters":[{"name":"hasDictionaryDef","defaultValue":"true","description":"Only return words with dictionary definitions","required":false,"dataType":"string","allowableValues":["false","true"],"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"CSV part-of-speech values to include","required":false,"dataType":"string","allowableValues":["noun","adjective","verb","adverb","interjection","pronoun","preposition","abbreviation","affix","article","auxiliary-verb","conjunction","definite-article","family-name","given-name","idiom","imperative","noun-plural","noun-posessive","past-participle","phrasal-prefix","proper-noun","proper-noun-plural","proper-noun-posessive","suffix","verb-intransitive","verb-transitive"],"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"CSV part-of-speech values to exclude","required":false,"dataType":"string","allowableValues":["noun","adjective","verb","adverb","interjection","pronoun","preposition","abbreviation","affix","article","auxiliary-verb","conjunction","definite-article","family-name","given-name","idiom","imperative","noun-plural","noun-posessive","past-participle","phrasal-prefix","proper-noun","proper-noun-plural","proper-noun-posessive","suffix","verb-intransitive","verb-transitive"],"allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","description":"Minimum dictionary count","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"minLength","description":"Minimum word length","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"minLexicalityRating","description":"Minimum lexicality","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","description":"Maximum lexicality","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns a single random WordObject, in the format specified by the URL","httpMethod":"GET","errorResponses":[{"reason":"No word found.","code":404}],"nickname":"getRandomWord","responseClass":"wordObject"}]},{"path":"/words.{format}/examples","description":"","operations":[{"parameters":[{"description":"Words to fetch examples for","required":false,"dataType":"String[]","allowableValues":[],"allowMultiple":false,"paramType":"body"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches examples for multiple words.","httpMethod":"POST","errorResponses":[{"reason":"Invalid words to search with.","code":400}],"nickname":"getExamplesForWords","responseClass":"List[example]"}]},{"path":"/words.{format}/mostCommentedOn","description":"","operations":[{"parameters":[{"name":"dayInterval","description":"Number of days to consider","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches words most commented on.","httpMethod":"GET","errorResponses":[{"reason":"Invalid time interval.","code":400}],"nickname":"getWordsMostCommentedOn","responseClass":"List[commentSummary]","notes":"Set the dayInterval to determine the time frame."}]},{"path":"/words.{format}/firstUsed/{statsType}/{object}","description":"","operations":[{"parameters":[{"name":"statsType","description":"DocumentStatsType dimension to filter by","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"object","description":"Identifier of DocumentStatsType object","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"detailed","description":"Return detailed data","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches words most commented on.","httpMethod":"GET","errorResponses":[{"reason":"Invalid time interval.","code":400}],"nickname":"getWordsMostCommentedOn","responseClass":"List[detailedWordUsage]","notes":"Set the dayInterval to determine the time frame."}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}/invite","description":"","operations":[{"parameters":[{"name":"permalink","description":"ID of WordOfTheDayList","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"description":"Invitation to send","required":false,"dataType":"wotdListInvitation","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Invites users to a WordOfTheDayList","httpMethod":"POST","errorResponses":[{"reason":"User is not eligible to send invitations","code":400},{"reason":"WordOfTheDayList not found.","code":404}],"nickname":"inviteToWordOfTheDayList","responseClass":"ok","notes":"A user can invite up to 20 people in a single day. The users being invited will be checked to see if they have opted out of email communications"}]},{"path":"/words.{format}/wordOfTheDayLists/recent","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches recently created WordOfTheDayLists","httpMethod":"GET","errorResponses":[{"reason":"No WordOfTheDayLists found.","code":404}],"nickname":"getRecentWordOfTheDayLists","responseClass":"List[wordOfTheDayList]"}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}/{specifier}","description":"","operations":[{"parameters":[{"name":"permalink","description":"ID of WordOfTheDayList","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"specifier","description":"Specifier for the item to fetch.  Either 'current' or a date.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"includeExtraHtml","description":"Include extra HTML if available","required":false,"dataType":"string","allowableValues":[],"paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Fetches a WordOfTheDayList by ID","httpMethod":"GET","errorResponses":[{"reason":"Invalid id supplied","code":400},{"reason":"WordOfTheDayList not found","code":404}],"nickname":"getWordOfTheDayListItem","responseClass":"WordOfTheDay"}]},{"path":"/words.{format}/wordOfTheDayLists","description":"","operations":[{"parameters":[{"name":"containsWord","description":"Lists must contain a specific word","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"subscriberCount","description":"Lists must have the specified number of subscribers","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"itemCount","description":"Lists must have the specified number of items","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches an array of WordOfTheDayList basd on a criteria","httpMethod":"GET","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getWordOfTheDayListsContainingWord","responseClass":"List[wordOfTheDayList]"}]},{"path":"/words.{format}/wordOfTheDayLists/subscriptionProcess","description":"","operations":[{"parameters":[{"name":"date","description":"Date string to fetch for.","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Returns whether or not a subscription process has been run.","httpMethod":"GET","errorResponses":[{"reason":"Invalid date format supplied.","code":400}],"nickname":"getWordOfTheDayListSubscriptionProcessStatus","responseClass":"String","notes":"Uses the current server time (day resolution) as the default date to check for, optionally a dateString can be supplied for a specific date to check for."}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}/subscription","description":"","operations":[{"parameters":[{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"header"},{"name":"permalink","description":"ID of WordOfTheDayList","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"medium","description":"Medium to subscribe with","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"},{"description":"Username to subscribe","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"body"}],"summary":"Subscribes a user to a WordOfTheDayList","httpMethod":"POST","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not authorized to subscribe","code":403},{"reason":"WordOfTheDayList or User not found","code":404}],"nickname":"subscribeToList","responseClass":"ok"}]},{"path":"/words.{format}/wordOfTheDayLists/{date}","description":"","operations":[{"parameters":[{"name":"date","description":"ID of WordOfTheDayList","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"path"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","allowableValues":[],"allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordOfTheDay objects for a specific date","httpMethod":"GET","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"WordOfTheDayList or User not found","code":404}],"nickname":"getWordOfTheDayListsForDate","responseClass":"List[WordOfTheDay]"}]}],"models1":[{"name":"EntrySearchResult","fields":[{"name":"definition","required":false,"wrapperName":"definitions","allowMultiple":false,"paramType":"List[definition]"},{"name":"sourceDictionary","required":false,"allowMultiple":false,"paramType":"string"},{"name":"headWord","required":false,"allowMultiple":false,"paramType":"string"},{"name":"entryId","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"extendedMetadata","fields":[{"name":"documentMetadataId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"isbn","required":false,"allowMultiple":false,"paramType":"string"},{"name":"issn","required":false,"allowMultiple":false,"paramType":"string"},{"name":"lccn","required":false,"allowMultiple":false,"paramType":"string"},{"name":"sourceFileSize","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"commentSummary","fields":[{"name":"objectType","required":false,"allowMultiple":false,"paramType":"string"},{"name":"totalCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"objectName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"objectDisplayName","required":false,"allowMultiple":false,"paramType":"string"},{"name":"countInInterval","required":false,"allowMultiple":false,"paramType":"long"},{"name":"intervalInMilliseconds","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"author","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"authorType","required":false,"allowMultiple":false,"paramType":"authorType"},{"name":"uniqueName","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"wotdListInvitation","fields":[{"name":"createdBy","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"note","required":false,"allowMultiple":false,"paramType":"string"},{"name":"permalink","required":false,"allowMultiple":false,"paramType":"string"},{"name":"recipient","required":false,"wrapperName":"recipients","allowMultiple":false,"paramType":"List[string]"},{"name":"failure","required":false,"wrapperName":"failures","allowMultiple":false,"paramType":"List[string]"}]},{"name":"wordOfTheDayList","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":true,"allowMultiple":false,"paramType":"string"},{"name":"description","required":false,"allowMultiple":false,"paramType":"string"},{"name":"category","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdBy","required":false,"allowMultiple":false,"paramType":"string"},{"name":"items","required":false,"allowMultiple":false,"paramType":"List[WordOfTheDay]"},{"name":"subscriberCount","required":false,"allowMultiple":false,"paramType":"int"},{"name":"subscriptionStatus","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"commentCount","required":false,"allowMultiple":false,"paramType":"int"},{"name":"voteCount","required":false,"allowMultiple":false,"paramType":"integer"},{"name":"voteAverage","required":false,"allowMultiple":false,"paramType":"float"},{"name":"voteWeightedAverage","required":false,"allowMultiple":false,"paramType":"float"},{"name":"itemCount","required":false,"allowMultiple":false,"paramType":"int"},{"name":"firstItemDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"lastItemDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"subscriptionSchedule","required":false,"allowMultiple":false,"paramType":"string"},{"name":"subscriptionNamespace","required":false,"allowMultiple":false,"paramType":"string"},{"name":"subscriptionIdentifier","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"example","fields":[{"name":"year","required":false,"allowMultiple":false,"paramType":"integer"},{"name":"provider","required":false,"allowMultiple":false,"paramType":"contentProvider"},{"name":"url","required":false,"allowMultiple":false,"paramType":"string"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"text","required":false,"allowMultiple":false,"paramType":"string"},{"name":"title","required":false,"allowMultiple":false,"paramType":"string"},{"name":"rating","required":false,"allowMultiple":false,"paramType":"float"},{"name":"exampleId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"documentId","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"WordSearchResult","fields":[{"name":"count","required":false,"allowMultiple":false,"paramType":"long"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"lexicality","required":false,"allowMultiple":false,"paramType":"double"}]},{"name":"definition","fields":[{"name":"exampleUsage","required":false,"wrapperName":"exampleUses","allowMultiple":false,"paramType":"List[ExampleUsage]"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"text","required":false,"allowMultiple":false,"paramType":"string"},{"name":"textPron","required":false,"wrapperName":"textProns","allowMultiple":false,"paramType":"List[textPron]"},{"name":"score","required":false,"allowMultiple":false,"paramType":"float"},{"name":"partOfSpeech","required":false,"allowMultiple":false,"paramType":"string"},{"name":"note","required":false,"wrapperName":"notes","allowMultiple":false,"paramType":"List[note]"},{"name":"relWord","required":false,"wrapperName":"relatedWords","allowMultiple":false,"paramType":"List[related]"},{"name":"sourceDictionary","required":false,"allowMultiple":false,"paramType":"string"},{"name":"label","required":false,"wrapperName":"labels","allowMultiple":false,"paramType":"List[Label]"},{"name":"citation","required":false,"wrapperName":"citations","allowMultiple":false,"paramType":"List[citation]"},{"name":"sequence","required":false,"allowMultiple":false,"paramType":"string"},{"name":"seqString","required":false,"allowMultiple":false,"paramType":"string"},{"name":"extendedText","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"documentMedium","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"contentProvider","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"frequency","fields":[{"name":"year","required":false,"allowMultiple":false,"paramType":"int"},{"name":"count","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"authorType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"frequencySummary","fields":[{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"totalCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"frequency","required":false,"allowMultiple":false,"paramType":"List[frequency]"},{"name":"unknownYearCount","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"detailedWordUsage","fields":[{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"},{"name":"sentence","required":false,"allowMultiple":false,"paramType":"sentence"},{"name":"metadata","required":false,"allowMultiple":false,"paramType":"documentMetadata"}]},{"name":"scoredWord","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordType","required":false,"allowMultiple":false,"paramType":"string"},{"name":"position","required":false,"allowMultiple":false,"paramType":"int"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"score","required":false,"allowMultiple":false,"paramType":"float"},{"name":"sentenceId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"partOfSpeech","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"SimpleDefinition","fields":[{"name":"text","required":false,"allowMultiple":false,"paramType":"string"},{"name":"partOfSpeech","required":false,"allowMultiple":false,"paramType":"string"},{"name":"note","required":false,"allowMultiple":false,"paramType":"string"},{"name":"source","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"basicDocumentStats","fields":[{"name":"key","required":false,"allowMultiple":false,"paramType":"string"},{"name":"type","required":false,"allowMultiple":false,"paramType":"string"},{"name":"sentencesCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"uniqueWordsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"documentsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"tokensCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"firstUsedWordsCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"viableSentencesCount","required":false,"allowMultiple":false,"paramType":"long"},{"name":"uniqueBiGramsCount","required":false,"allowMultiple":false,"paramType":"long"}]},{"name":"wordFrequency","fields":[{"name":"count","required":false,"allowMultiple":false,"paramType":"long"},{"name":"wordstring","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"sentence","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"scoredWord","required":false,"wrapperName":"scoredWords","allowMultiple":false,"paramType":"List[scoredWord]"},{"name":"display","required":false,"allowMultiple":false,"paramType":"string"},{"name":"documentMetadataId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"rating","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"wordObject","fields":[{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"vulgar","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"contentType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"yearType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"documentMetadata","fields":[{"name":"id","required":false,"allowMultiple":false,"paramType":"long"},{"name":"year","required":false,"allowMultiple":false,"paramType":"integer"},{"name":"contentType","required":false,"allowMultiple":false,"paramType":"contentType"},{"name":"provider","required":false,"allowMultiple":false,"paramType":"contentProvider"},{"name":"tag","required":false,"wrapperName":"tags","allowMultiple":false,"paramType":"List[string]"},{"name":"title","required":false,"allowMultiple":false,"paramType":"string"},{"name":"rating","required":false,"allowMultiple":false,"paramType":"double"},{"name":"medium","required":false,"allowMultiple":false,"paramType":"documentMedium"},{"name":"sourceUrl","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"classification","required":false,"allowMultiple":false,"paramType":"subjectClassificationType"},{"name":"date","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"yearType","required":false,"allowMultiple":false,"paramType":"yearType"},{"name":"primaryAuthor","required":false,"allowMultiple":false,"paramType":"string"},{"name":"primaryAuthorType","required":false,"allowMultiple":false,"paramType":"authorType"},{"name":"primaryAuthorId","required":false,"allowMultiple":false,"paramType":"long"},{"name":"guid","required":false,"allowMultiple":false,"paramType":"string"},{"name":"extendedMetadata","required":false,"allowMultiple":false,"paramType":"extendedMetadata"},{"name":"author","required":false,"wrapperName":"authors","allowMultiple":false,"paramType":"List[author]"},{"name":"expirationDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"stats","required":false,"allowMultiple":false,"paramType":"basicDocumentStats"}]},{"name":"partOfSpeech","fields":[{"name":"roots","required":false,"allowMultiple":false,"paramType":"List[root]"}]},{"name":"subjectClassificationType","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"wordSearchResults","fields":[{"name":"totalResults","required":false,"allowMultiple":false,"paramType":"int"},{"name":"searchResult","required":false,"wrapperName":"searchResults","allowMultiple":false,"paramType":"List[WordSearchResult]"}]},{"name":"WordOfTheDay","fields":[{"name":"id","required":true,"allowMultiple":false,"paramType":"long"},{"name":"category","required":false,"allowMultiple":false,"paramType":"string"},{"name":"example","required":false,"wrapperName":"examples","allowMultiple":false,"paramType":"List[SimpleExample]"},{"name":"word","required":false,"allowMultiple":false,"paramType":"string"},{"name":"createdBy","required":false,"allowMultiple":false,"paramType":"string"},{"name":"definition","required":false,"wrapperName":"definitions","allowMultiple":false,"paramType":"List[SimpleDefinition]"},{"name":"contentProvider","required":false,"allowMultiple":false,"paramType":"contentProvider"},{"name":"createdAt","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"publishDate","required":false,"allowMultiple":false,"paramType":"Date"},{"name":"parentId","required":false,"allowMultiple":false,"paramType":"string"},{"name":"note","required":false,"allowMultiple":false,"paramType":"string"},{"name":"htmlExtra","required":false,"allowMultiple":false,"paramType":"string"}]},{"name":"DefinitionSearchResults","fields":[{"name":"totalResults","required":false,"allowMultiple":false,"paramType":"int"},{"name":"result","required":false,"wrapperName":"results","allowMultiple":false,"paramType":"List[definition]"}]},{"name":"SubscriptionStatus","fields":[{"name":"name","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"int"}]},{"name":"EntrySearchResults","fields":[{"name":"totalResults","required":false,"allowMultiple":false,"paramType":"int"},{"name":"searchResult","required":false,"wrapperName":"searchResults","allowMultiple":false,"paramType":"List[EntrySearchResult]"}]},{"name":"SimpleExample","fields":[{"name":"url","required":false,"allowMultiple":false,"paramType":"string"},{"name":"text","required":false,"allowMultiple":false,"paramType":"string"},{"name":"title","required":false,"allowMultiple":false,"paramType":"string"},{"name":"id","required":false,"allowMultiple":false,"paramType":"long"}]}],"basePath":"url","swaggerVersion":"1.0"}

data/lib/wordnik.rb

@@ -33,39 +33,77 @@ module Wordnik
     #     config.password = 'i<3words'            # optional, but needed for user-related functions
     #     config.response_format = :json          # optional, defaults to json
     #   end
+    #
     def configure(build=true)
       self.configuration ||= Configuration.new
       yield(configuration) if block_given?
+      
+      # remove :// from scheme
+      configuration.scheme.sub!(/:\/\//, '')
+
+      # remove http(s):// and anything after a slash
+      configuration.host.sub!(/https?:\/\//, '')
+      configuration.host = configuration.host.split('/').first
+
+      # Add leading and trailing slashes to base_path
+      configuration.base_path = "/#{configuration.base_path}".gsub(/\/+/, '/')
+      configuration.base_path = "" if configuration.base_path == "/"
 
+      # The Rakefile needs to call Wordnik.configure, but can't
+      # attach resources because they haven't been downloaded.
       if build
-        self.build_resources
-        self.configuration.resource_names.each do |resource_name|
-          method_name = resource_name.underscore.to_sym
-          meta_def method_name do
-            Wordnik.resources[method_name]
-          end
-        end  
+        self.instantiate_resources
+        self.create_resource_shortcuts 
+      end
+    end
+    
+    # Remove old JSON documentation and generated modules,
+    # then download fresh JSON files.
+    #
+    def download_resource_descriptions
+      system "rm api_docs/*.json"
+      system "rm lib/wordnik/resource_modules/*.rb"
+      
+      Wordnik::Request.new(:get, "resources.json").response.body['apis'].each do |api|
+        resource_name = api['path'].split(".").first.gsub(/\//, '')
+        description = api['description']
+        puts "  #{resource_name} #{description}"
+        request = Wordnik::Request.new(:get, "#{resource_name}.json")
+        filename = "api_docs/#{resource_name}.json"
+        File.open(filename, 'w') {|f| f.write(request.response.raw.body) }
       end
-
     end
 
-    # Iterate over each disk-cached JSON resource documentation file
-    # 
-    def build_resources
+    # Iterate over each disk-cached JSON resource documentation file, and
+    # 1. Instantiate a Resource object
+    # 2. Stuff the Resource in Wordnik.resources
+    #
+    def instantiate_resources   
       self.resources = {}
-      self.configuration.resource_names.map do |resource_name|
-        
+      self.configuration.resource_names.each do |resource_name|
         name = resource_name.underscore.to_sym # 'fooBar' => :foo_bar
-        filename = File.join(File.dirname(__FILE__), "../api_docs/#{resource_name}.json")
-        
+        filename = File.join(File.dirname(__FILE__), "../api_docs/#{resource_name}.json")        
         resource = Resource.new(
           :name => name,
           :raw_data => JSON.parse(File.read(filename))
         )
         self.resources[name] = resource
+      end      
+    end
+    
+    # Use some magic ruby dust to make nice method shortcuts.
+    # Wordnik.word => Wordnik.resources[:word]
+    # Wordnik.users => Wordnik.resources[:user]
+    #
+    def create_resource_shortcuts
+      self.configuration.resource_names.each do |resource_name|
+        method_name = resource_name.underscore.to_sym
+        meta_def method_name do
+          Wordnik.resources[method_name]
+        end
       end
     end
-
+    
     def authenticated?
       Wordnik.configuration.user_id.present? && Wordnik.configuration.auth_token.present?
     end
@@ -85,7 +123,10 @@ module Wordnik
       request = Wordnik::Request.new(
         :get, 
         "account/authenticate/{username}", 
-        :params => {:username => Wordnik.configuration.username, :password => Wordnik.configuration.password}
+        :params => {
+          :username => Wordnik.configuration.username, 
+          :password => Wordnik.configuration.password
+        }
       )
       
       response_body = request.response.body