wordnik 4.06.10 → 4.06.11

data/.gitignore

@@ -1,4 +1,5 @@
 pkg/*
 *.gem
 .bundle
-USAGE.md
+USAGE.md
+spec/vcr/*

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    wordnik (4.06.08)
+    wordnik (4.06.11)
       activemodel (>= 3.0.3)
       addressable (>= 2.2.4)
       htmlentities (>= 4.2.4)
@@ -13,35 +13,36 @@ GEM
   remote: http://rubygems.org/
   specs:
     ZenTest (4.6.2)
-    activemodel (3.0.10)
-      activesupport (= 3.0.10)
-      builder (~> 2.1.2)
-      i18n (~> 0.5.0)
-    activesupport (3.0.10)
+    activemodel (3.1.2)
+      activesupport (= 3.1.2)
+      builder (~> 3.0.0)
+      i18n (~> 0.6)
+    activesupport (3.1.2)
+      multi_json (~> 1.0)
     addressable (2.2.6)
     autotest (4.4.6)
       ZenTest (>= 4.4.1)
     autotest-rails-pure (4.1.2)
-    builder (2.1.2)
+    builder (3.0.0)
     crack (0.1.8)
     diff-lcs (1.1.3)
     htmlentities (4.3.0)
-    i18n (0.5.0)
-    json (1.5.3)
-    mime-types (1.16)
+    i18n (0.6.0)
+    json (1.6.2)
+    mime-types (1.17.2)
+    multi_json (1.0.4)
     nokogiri (1.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)
+    rspec (2.7.0)
+      rspec-core (~> 2.7.0)
+      rspec-expectations (~> 2.7.0)
+      rspec-mocks (~> 2.7.0)
+    rspec-core (2.7.1)
+    rspec-expectations (2.7.0)
       diff-lcs (~> 1.1.2)
-    rspec-mocks (2.6.0)
-    typhoeus (0.2.4)
+    rspec-mocks (2.7.0)
+    typhoeus (0.3.3)
       mime-types
-      mime-types
-    vcr (1.11.2)
+    vcr (1.11.3)
     webmock (1.7.5)
       addressable (~> 2.2, > 2.2.5)
       crack (>= 0.1.7)
@@ -52,7 +53,7 @@ PLATFORMS
 DEPENDENCIES
   autotest
   autotest-rails-pure
-  rspec (>= 2.5.0)
-  vcr (>= 1.5.1)
+  rspec (~> 2.7.0)
+  vcr (~> 1.11.3)
   webmock (>= 1.6.2)
   wordnik!

data/README.md

@@ -29,13 +29,14 @@ If you're using Wordnik in a rails app, drop this into `config/initializers/word
 
 ```ruby
 Wordnik.configure do |config|
-  config.api_key = '12345abcde'     # required
-  config.username = 'bozo'          # optional, but needed for user-related functions
-  config.password = 'cl0wnt0wn'     # optional, but needed for user-related functions
-  config.response_format = :json    # defaults to json, but xml is also supported
+  config.api_key = '12345abcde'               # required
+  config.username = 'bozo'                    # optional, but needed for user-related functions
+  config.password = 'cl0wnt0wn'               # optional, but needed for user-related functions
+  config.response_format = 'json'             # defaults to json, but xml is also supported
+  config.logger = Logger.new('/dev/null')     # defaults to Rails.logger or Logger.new(STDOUT). Set to Logger.new('/dev/null') to disable logging.
 end
 ```
-	
+
 Example Usage
 -------------
 
@@ -75,6 +76,14 @@ Specs
 -----
 
 The wordnik gem uses rspec 2. To run the test suite, just type `rake` or `bundle exec rake spec` in the gem's base directory.
+
+Note
+----
+For testing locally, you will need to tunnel into the beta box
+
+  ssh -f -N -L 8001:localhost:8001 beta.wordnik.com
+
+And remember to update the spec_helper
 	
 Contributing
 ------------

data/api_docs/account.json

@@ -1 +1 @@
-{"resourcePath":"/account","models":{"User":{"properties":{"id":{"type":"long"},"username":{"type":"string"},"email":{"type":"string"},"status":{"type":"int"},"faceBookId":{"type":"string"},"userName":{"type":"string"},"displayName":{"type":"string"},"password":{"type":"string"}},"id":"user"},"ApiTokenStatus":{"properties":{"valid":{"type":"boolean"},"token":{"type":"string"},"resetsInMillis":{"type":"long"},"remainingCalls":{"type":"long"},"expiresInMillis":{"type":"long"},"totalRequests":{"type":"long"}},"id":"ApiTokenStatus"},"AuthenticationToken":{"properties":{"token":{"type":"string"},"userId":{"type":"long"},"userSignature":{"type":"string"}},"id":"AuthenticationToken"},"WordList":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"username":{"type":"string"},"permalink":{"type":"string"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"numberWordsInList":{"type":"long"},"type":{"type":"string"}},"id":"wordList"},"ApiResponse":{"properties":{"message":{"type":"string"},"type":{"type":"string"}},"id":"ApiResponse"},"UserHandle":{"properties":{"webService":{"type":"int"},"handle":{"type":"string"}},"id":"UserHandle"},"UserSettings":{"properties":{"notifyComments":{"type":"boolean"},"bossURL":{"type":"string"},"enableActivityFeed":{"type":"boolean"},"userId":{"type":"long"},"publicLookupHistory":{"type":"boolean"},"showImages":{"type":"boolean"},"notifyGeneralNews":{"type":"boolean"},"notifyWordOfTheDay":{"type":"boolean"},"showLookupHistory":{"type":"boolean"}},"id":"UserSettings"},"ApiApplication":{"properties":{"id":{"type":"long"},"createdAt":{"type":"Date"},"userId":{"type":"long"},"userName":{"type":"string"},"approvalState":{"type":"ApiApprovalState"},"comment":{"type":"string"}},"id":"apiApplication"},"UserTrackingInfo":{"properties":{"signupDate":{"type":"Date"},"lastLoginDate":{"type":"Date"},"noOfLogins":{"type":"int"},"userId":{"type":"long"},"lastUpdatedDate":{"type":"Date"},"signupIPAddress":{"type":"string"}},"id":"UserTrackingInfo"},"UserProfile":{"properties":{"publicProfile":{"type":"boolean"},"lastName":{"type":"string"},"mostFavoriteWord":{"type":"string"},"location":{"type":"string"},"seekingWord":{"type":"string"},"leastFavoriteWord":{"type":"string"},"onomaTopoeiaWord":{"type":"string"},"siteUrl":{"type":"string"},"bio":{"type":"string"},"userHandles":{"type":"array","items":{"$ref":"UserHandle"}},"userId":{"type":"long"},"youWord":{"type":"string"},"firstName":{"type":"string"},"siteName":{"type":"string"}},"id":"UserProfile"},"ApiApprovalState":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"ApiApprovalState"}},"apis":[{"path":"/account.{format}/authenticate/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"A confirmed Wordnik username","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"password","description":"The user's password","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Authenticates a User","responseTypeInternal":"com.wordnik.security.model.AuthenticationToken","errorResponses":[{"reason":"Account not available.","code":403},{"reason":"User not found.","code":404}],"nickname":"authenticate","responseClass":"AuthenticationToken","httpMethod":"GET"},{"parameters":[{"name":"username","description":"A confirmed Wordnik username","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"The user's password","required":true,"dataType":"string","allowMultiple":false,"paramType":"body"}],"summary":"Authenticates a user","responseTypeInternal":"com.wordnik.security.model.AuthenticationToken","errorResponses":[{"reason":"Account not available.","code":403},{"reason":"User not found.","code":404}],"nickname":"authenticatePost","responseClass":"AuthenticationToken","httpMethod":"POST"}]},{"path":"/account.{format}/wordLists","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordList objects for the logged-in user.","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Not authenticated.","code":403},{"reason":"User account not found.","code":404}],"nickname":"getWordListsForCurrentUser","responseClass":"List[wordList]","httpMethod":"GET"}]},{"path":"/account.{format}/forgotPassword/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"Username","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Authenticates a User","responseTypeInternal":"String","errorResponses":[{"reason":"User is Facebook Connected","code":400},{"reason":"User not found","code":404}],"nickname":"getForgotPassword","responseClass":"String","httpMethod":"GET"}]},{"path":"/account.{format}/resetPassword/{hashcode}","description":"","operations":[{"parameters":[{"name":"hashcode","description":"Password reset code","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches a User by code","responseTypeInternal":"com.wordnik.system.user.entity.User","errorResponses":[{"reason":"Invalid code supplied","code":400},{"reason":"User not found or code invalid.","code":404}],"nickname":"resetPassword","responseClass":"user","httpMethod":"GET"}]},{"path":"/account.{format}/apiAccountApplication","description":"","operations":[{"parameters":[{"description":"API Application Info","required":true,"dataType":"apiApplication","valueTypeInternal":"com.wordnik.security.entity.ApiApplication","allowMultiple":false,"paramType":"body"}],"summary":"Creates an API account application.","responseTypeInternal":"com.wordnik.resource.ApiResponse","errorResponses":[{"reason":"Account not available.","code":403},{"reason":"User not found.","code":404}],"nickname":"createApiAccount","responseClass":"ApiResponse","httpMethod":"POST"}]},{"path":"/account.{format}/regenerateApiToken","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"}],"summary":"Regenerates an API Token.  Currently not supported or tested.","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid token supplied.","code":400}],"nickname":"createApiAccount","responseClass":"ok","httpMethod":"GET"}]},{"path":"/account.{format}/apiTokenStatus","description":"","operations":[{"parameters":[{"name":"api_key","description":"Wordnik authentication token","required":false,"dataType":"string","allowMultiple":false,"paramType":"header"},{"name":"api_key","description":"Wordnik authentication token","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns usage statistics for the API account.","responseTypeInternal":"com.wordnik.security.model.ApiTokenStatus","errorResponses":[{"reason":"No token supplied.","code":400},{"reason":"No API account with supplied token.","code":404}],"nickname":"getApiTokenStatus","responseClass":"ApiTokenStatus","httpMethod":"GET"}]},{"path":"/account.{format}/logVisit","description":"","operations":[{"parameters":[{"name":"userId","description":"User ID to track data for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userGuid","description":"User's persistent GUID","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userSessionId","description":"User's session ID","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userIpAddress","description":"User IP address","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"serverIp","description":"Server IP address","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Logs a VisitAction for the user","responseTypeInternal":"String","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"logVisitForUser","responseClass":"String","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","allowMultiple":false,"paramType":"path"}],"summary":"Returns an activation code given a username","responseTypeInternal":"String","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.","httpMethod":"GET"}]},{"path":"/account.{format}/activate","description":"","operations":[{"parameters":[{"description":"Activation Code","required":true,"dataType":"string","allowMultiple":false,"paramType":"body"}],"summary":"Activates an account.","responseTypeInternal":"com.wordnik.system.user.entity.User","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"No activation code found.","code":404}],"nickname":"activateUser","responseClass":"user","httpMethod":"POST"}]},{"path":"/account.{format}/usernameAvailable/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"Username","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns an ApiResponse indicating whether or not a username is available","responseTypeInternal":"com.wordnik.resource.ApiResponse","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getUsernameAvailable","responseClass":"ApiResponse","httpMethod":"GET"}]},{"path":"/account.{format}/user","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","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","allowMultiple":false,"paramType":"header"}],"summary":"Returns the logged-in User","responseTypeInternal":"com.wordnik.system.user.entity.User","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.","httpMethod":"GET"}]},{"path":"/account.{format}/profile","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"}],"summary":"Returns profile info for the logged-in user","responseTypeInternal":"com.wordnik.system.user.entity.UserProfile","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.","httpMethod":"GET"}]},{"path":"/account.{format}/settings","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"}],"summary":"Returns logged-in User Settings","responseTypeInternal":"com.wordnik.system.user.entity.UserSettings","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.","httpMethod":"GET"}]},{"path":"/account.{format}/trackingInfo","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"}],"summary":"Returns logged-in User TrackingInfo.","responseTypeInternal":"com.wordnik.system.user.entity.UserTrackingInfo","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.","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1","apiVersion":"4.0"}
+{"resourcePath":"/account","models":{"User":{"properties":{"id":{"type":"long"},"username":{"type":"string"},"email":{"type":"string"},"status":{"type":"int"},"faceBookId":{"type":"string"},"userName":{"type":"string"},"displayName":{"type":"string"},"password":{"type":"string"}},"id":"user"},"ApiTokenStatus":{"properties":{"valid":{"type":"boolean"},"token":{"type":"string"},"resetsInMillis":{"type":"long"},"remainingCalls":{"type":"long"},"expiresInMillis":{"type":"long"},"totalRequests":{"type":"long"}},"id":"ApiTokenStatus"},"AuthenticationToken":{"properties":{"token":{"type":"string"},"userId":{"type":"long"},"userSignature":{"type":"string"}},"id":"AuthenticationToken"},"WordList":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"username":{"type":"string"},"permalink":{"type":"string"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"numberWordsInList":{"type":"long"},"type":{"type":"string"}},"id":"wordList"},"ApiResponse":{"properties":{"message":{"type":"string"},"type":{"type":"string"}},"id":"ApiResponse"},"UserHandle":{"properties":{"webService":{"type":"int"},"handle":{"type":"string"}},"id":"UserHandle"},"UserSettings":{"properties":{"notifyComments":{"type":"boolean"},"bossURL":{"type":"string"},"enableActivityFeed":{"type":"boolean"},"userId":{"type":"long"},"publicLookupHistory":{"type":"boolean"},"showImages":{"type":"boolean"},"notifyGeneralNews":{"type":"boolean"},"notifyWordOfTheDay":{"type":"boolean"},"showLookupHistory":{"type":"boolean"}},"id":"UserSettings"},"ApiApplication":{"properties":{"id":{"type":"long"},"createdAt":{"type":"Date"},"userId":{"type":"long"},"userName":{"type":"string"},"approvalState":{"type":"ApiApprovalState"},"comment":{"type":"string"}},"id":"apiApplication"},"UserTrackingInfo":{"properties":{"signupDate":{"type":"Date"},"lastLoginDate":{"type":"Date"},"noOfLogins":{"type":"int"},"userId":{"type":"long"},"lastUpdatedDate":{"type":"Date"},"signupIPAddress":{"type":"string"}},"id":"UserTrackingInfo"},"UserProfile":{"properties":{"publicProfile":{"type":"boolean"},"lastName":{"type":"string"},"mostFavoriteWord":{"type":"string"},"location":{"type":"string"},"seekingWord":{"type":"string"},"leastFavoriteWord":{"type":"string"},"onomaTopoeiaWord":{"type":"string"},"siteUrl":{"type":"string"},"bio":{"type":"string"},"userHandles":{"type":"array","items":{"$ref":"UserHandle"}},"userId":{"type":"long"},"youWord":{"type":"string"},"firstName":{"type":"string"},"siteName":{"type":"string"}},"id":"UserProfile"},"ApiApprovalState":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"ApiApprovalState"}},"apis":[{"path":"/account.{format}/authenticate/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"A confirmed Wordnik username","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"password","description":"The user's password","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Authenticates a User","responseTypeInternal":"com.wordnik.security.model.AuthenticationToken","errorResponses":[{"reason":"Account not available.","code":403},{"reason":"User not found.","code":404}],"nickname":"authenticate","responseClass":"AuthenticationToken","httpMethod":"GET"},{"parameters":[{"name":"username","description":"A confirmed Wordnik username","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"The user's password","required":true,"dataType":"string","allowMultiple":false,"paramType":"body"}],"summary":"Authenticates a user","responseTypeInternal":"com.wordnik.security.model.AuthenticationToken","errorResponses":[{"reason":"Account not available.","code":403},{"reason":"User not found.","code":404}],"nickname":"authenticatePost","responseClass":"AuthenticationToken","httpMethod":"POST"}]},{"path":"/account.{format}/wordLists","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordList objects for the logged-in user.","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Not authenticated.","code":403},{"reason":"User account not found.","code":404}],"nickname":"getWordListsForCurrentUser","responseClass":"List[wordList]","httpMethod":"GET"}]},{"path":"/account.{format}/forgotPassword/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"Username","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Authenticates a User","responseTypeInternal":"String","errorResponses":[{"reason":"User is Facebook Connected","code":400},{"reason":"User not found","code":404}],"nickname":"getForgotPassword","responseClass":"String","httpMethod":"GET"}]},{"path":"/account.{format}/resetPassword/{hashcode}","description":"","operations":[{"parameters":[{"name":"hashcode","description":"Password reset code","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches a User by code","responseTypeInternal":"com.wordnik.system.user.entity.User","errorResponses":[{"reason":"Invalid code supplied","code":400},{"reason":"User not found or code invalid.","code":404}],"nickname":"resetPassword","responseClass":"user","httpMethod":"GET"}]},{"path":"/account.{format}/apiAccountApplication","description":"","operations":[{"parameters":[{"description":"API Application Info","required":true,"dataType":"apiApplication","valueTypeInternal":"com.wordnik.security.entity.ApiApplication","allowMultiple":false,"paramType":"body"}],"summary":"Creates an API account application.","responseTypeInternal":"com.wordnik.resource.ApiResponse","errorResponses":[{"reason":"Account not available.","code":403},{"reason":"User not found.","code":404}],"nickname":"createApiAccount","responseClass":"ApiResponse","httpMethod":"POST"}]},{"path":"/account.{format}/regenerateApiToken","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"}],"summary":"Regenerates an API Token.  Currently not supported or tested.","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid token supplied.","code":400}],"nickname":"createApiAccount","responseClass":"ok","httpMethod":"GET"}]},{"path":"/account.{format}/apiTokenStatus","description":"","operations":[{"parameters":[{"name":"api_key","description":"Wordnik authentication token","required":false,"dataType":"string","allowMultiple":false,"paramType":"header"},{"name":"api_key","description":"Wordnik authentication token","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns usage statistics for the API account.","responseTypeInternal":"com.wordnik.security.model.ApiTokenStatus","errorResponses":[{"reason":"No token supplied.","code":400},{"reason":"No API account with supplied token.","code":404}],"nickname":"getApiTokenStatus","responseClass":"ApiTokenStatus","httpMethod":"GET"}]},{"path":"/account.{format}/logVisit","description":"","operations":[{"parameters":[{"name":"userId","description":"User ID to track data for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userGuid","description":"User's persistent GUID","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userSessionId","description":"User's session ID","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userIpAddress","description":"User IP address","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"serverIp","description":"Server IP address","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Logs a VisitAction for the user","responseTypeInternal":"String","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"logVisitForUser","responseClass":"String","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","allowMultiple":false,"paramType":"path"}],"summary":"Returns an activation code given a username","responseTypeInternal":"String","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.","httpMethod":"GET"}]},{"path":"/account.{format}/activate","description":"","operations":[{"parameters":[{"description":"Activation Code","required":true,"dataType":"string","allowMultiple":false,"paramType":"body"}],"summary":"Activates an account.","responseTypeInternal":"com.wordnik.system.user.entity.User","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"No activation code found.","code":404}],"nickname":"activateUser","responseClass":"user","httpMethod":"POST"}]},{"path":"/account.{format}/usernameAvailable/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"Username","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns an ApiResponse indicating whether or not a username is available","responseTypeInternal":"com.wordnik.resource.ApiResponse","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getUsernameAvailable","responseClass":"ApiResponse","httpMethod":"GET"}]},{"path":"/account.{format}/user","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","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","allowMultiple":false,"paramType":"header"}],"summary":"Returns the logged-in User","responseTypeInternal":"com.wordnik.system.user.entity.User","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.","httpMethod":"GET"}]},{"path":"/account.{format}/profile","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"}],"summary":"Returns profile info for the logged-in user","responseTypeInternal":"com.wordnik.system.user.entity.UserProfile","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.","httpMethod":"GET"}]},{"path":"/account.{format}/settings","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"}],"summary":"Returns logged-in User Settings","responseTypeInternal":"com.wordnik.system.user.entity.UserSettings","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.","httpMethod":"GET"}]},{"path":"/account.{format}/trackingInfo","description":"","operations":[{"parameters":[{"name":"api_key","description":"API Key","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"},{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"}],"summary":"Returns logged-in User TrackingInfo.","responseTypeInternal":"com.wordnik.system.user.entity.UserTrackingInfo","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.","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/api_docs/analytics.json

@@ -1 +1 @@
-{"resourcePath":"/analytics","models":{"WordHitsCollection":{"properties":{"wordHitsList":{"type":"array","items":{"$ref":"wordHits"}}},"id":"wordHitsCollection"},"WordHits":{"properties":{"timeMillis":{"type":"long"}},"id":"wordHits"}},"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":{"values":["site.word"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"year","description":"Year","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"month","description":"Month","required":false,"dataType":"string","allowableValues":{"values":["1","2","3","4","5","6","7","8","9","10","11","12"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"week","description":"Week","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"day","description":"Day","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"hour","description":"Hour","required":false,"dataType":"string","allowableValues":{"values":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Number of results to skip by","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"50","description":"Number of results to fetch","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns top hits over a year, month, week, day or hour","responseTypeInternal":"com.wordnik.analytics.model.WordHitsCollection","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).","httpMethod":"GET"}]},{"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":{"values":["site.word"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"year","description":"Year","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"month","description":"Month","required":false,"dataType":"string","allowableValues":{"values":["1","2","3","4","5","6","7","8","9","10","11","12"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"week","description":"Week","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Number of results to skip by","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"50","description":"Number of results to fetch","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns words which were trending on a given week or month","responseTypeInternal":"com.wordnik.analytics.model.WordHitsCollection","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).","httpMethod":"GET"}]},{"path":"/analytics.{format}/word/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"Word","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"namespace","defaultValue":"site.word","description":"The namespace for which to return hits","required":false,"dataType":"string","allowableValues":{"values":["site.word"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"year","description":"Year","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"month","description":"Month","required":false,"dataType":"string","allowableValues":{"values":["1","2","3","4","5","6","7","8","9","10","11","12"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"week","description":"Week","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"day","description":"Day","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Number of results to skip by","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"50","description":"Number of results to fetch","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns hits a word received in a given year, month, week or day","responseTypeInternal":"com.wordnik.analytics.model.WordHitsCollection","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)","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1","apiVersion":"4.0"}
+{"resourcePath":"/analytics","models":{"WordHitsCollection":{"properties":{"wordHitsList":{"type":"array","items":{"$ref":"wordHits"}}},"id":"wordHitsCollection"},"WordHits":{"properties":{"timeMillis":{"type":"long"}},"id":"wordHits"}},"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":{"values":["site.word"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"year","description":"Year","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"month","description":"Month","required":false,"dataType":"string","allowableValues":{"values":["1","2","3","4","5","6","7","8","9","10","11","12"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"week","description":"Week","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"day","description":"Day","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"hour","description":"Hour","required":false,"dataType":"string","allowableValues":{"values":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Number of results to skip by","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"50","description":"Number of results to fetch","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns top hits over a year, month, week, day or hour","responseTypeInternal":"com.wordnik.analytics.model.WordHitsCollection","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).","httpMethod":"GET"}]},{"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":{"values":["site.word"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"year","description":"Year","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"month","description":"Month","required":false,"dataType":"string","allowableValues":{"values":["1","2","3","4","5","6","7","8","9","10","11","12"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"week","description":"Week","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Number of results to skip by","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"50","description":"Number of results to fetch","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns words which were trending on a given week or month","responseTypeInternal":"com.wordnik.analytics.model.WordHitsCollection","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).","httpMethod":"GET"}]},{"path":"/analytics.{format}/word/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"Word","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"namespace","defaultValue":"site.word","description":"The namespace for which to return hits","required":false,"dataType":"string","allowableValues":{"values":["site.word"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"year","description":"Year","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"month","description":"Month","required":false,"dataType":"string","allowableValues":{"values":["1","2","3","4","5","6","7","8","9","10","11","12"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"week","description":"Week","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"day","description":"Day","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Number of results to skip by","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"50","description":"Number of results to fetch","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns hits a word received in a given year, month, week or day","responseTypeInternal":"com.wordnik.analytics.model.WordHitsCollection","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)","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/api_docs/corpus.json

@@ -1 +1 @@
-{"resourcePath":"/corpus","models":{"Long":{"properties":{"value":{"type":"long"}},"id":"long"},"WordResult":{"properties":{"count":{"type":"long"},"wordstring":{"type":"string"}},"id":"wordResult"},"PunctuationFactor":{"properties":{"periodCount":{"type":"long"},"exclamationPointCount":{"type":"long"},"wordId":{"type":"long"},"questionMarkCount":{"type":"long"},"totalCount":{"type":"long"}},"id":"punctuationFactor"},"WordListingHistory":{"properties":{"wordId":{"type":"long"},"listingCount":{"type":"long"},"wordString":{"type":"string"}},"id":"wordListingHistory"},"ContextualLookupRequest":{"properties":{"partnerId":{"type":"string"},"documentTitle":{"type":"string"},"contextString":{"type":"string"},"sourceUrl":{"type":"string"},"wordstring":{"type":"string"},"metadataId":{"type":"string"}},"id":"contextualLookupRequest"},"BasicWordUsage":{"properties":{"sentenceId":{"type":"long"},"year":{"type":"integer"},"wordstring":{"type":"string"},"documentId":{"type":"long"}},"id":"basicWordUsage"},"WordView":{"properties":{"id":{"type":"long","required":true},"word":{"type":"string"}},"id":"wordView"},"ScoredWord":{"properties":{"position":{"type":"int"},"id":{"type":"long"},"wordType":{"type":"string"},"score":{"type":"float"},"sentenceId":{"type":"long"},"word":{"type":"string"},"partOfSpeech":{"type":"string"}},"id":"scoredWord"},"LookupExample":{"properties":{"sourceName":{"type":"string"},"uRL":{"type":"string"},"exampleString":{"type":"string"}},"id":"lookupExample"},"DictionaryStats":{"properties":{"dictionaryName":{"type":"string"},"exampleCount":{"type":"int"},"defintionCount":{"type":"int"},"relationshipLinks":{"type":"Map[string,integer]"},"textPronunciationCount":{"type":"int"},"wordCount":{"type":"int"},"wordsWithRelationship":{"type":"Map[string,integer]"}},"id":"dictionaryStats"},"ContextualLookupResponse":{"properties":{"examples":{"type":"array","items":{"$ref":"lookupExample"}},"wordstring":{"type":"string"}},"id":"contextualLookupResponse"},"WordFrequency":{"properties":{"count":{"type":"long"},"wordstring":{"type":"string"}},"id":"wordFrequency"},"Sentence":{"properties":{"id":{"type":"long"},"display":{"type":"string"},"rating":{"type":"int"},"documentMetadataId":{"type":"long"},"scoredWord":{"type":"array","items":{"$ref":"scoredWord"}}},"id":"sentence"},"BasicDocumentStats":{"properties":{"uniqueBiGramsCount":{"type":"long"},"wordsCount":{"type":"long"},"documentsCount":{"type":"long"},"firstUsedWordsCount":{"type":"long"},"tokensCount":{"type":"long"},"sentencesCount":{"type":"long"},"viableSentencesCount":{"type":"long"},"type":{"type":"string"},"uniqueWordsCount":{"type":"long"},"key":{"type":"string"}},"id":"basicDocumentStats"}},"apis":[{"path":"/corpus.{format}/recentViews","description":"","operations":[{"parameters":[{"name":"limit","description":"Limits results","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"humanOnly","description":"Returns results only from human visitors","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sortByFrequency","description":"Sorts results by frequency","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches recent views from the website.","responseTypeInternal":"com.wordnik.corpus.model.WordResult","nickname":"getRecentViews","responseClass":"List[wordResult]","httpMethod":"GET"}]},{"path":"/corpus.{format}/words/{statsType}/{object}","description":"","operations":[{"parameters":[{"name":"statsType","description":"Stats type to fetch","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"object","description":"Object identifier","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Gets WordFrequency data","responseTypeInternal":"com.wordnik.corpus.stats.entity.WordFrequency","errorResponses":[{"reason":"Invalid dimension for WordFrequency data or Object Identifier not found.","code":400}],"nickname":"getWordFrequencies","responseClass":"List[wordFrequency]","httpMethod":"GET"}]},{"path":"/corpus.{format}/dictionaryStats","description":"","operations":[{"parameters":[{"name":"sourceDictionary","description":"Dictionary name to fetch stats for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Gets Dictionary Statistics data","responseTypeInternal":"com.wordnik.corpus.stats.entity.DictionaryStats","errorResponses":[{"reason":"Invalid dictionary name supplied.","code":404}],"nickname":"getWordFrequencies","responseClass":"dictionaryStats","httpMethod":"GET"}]},{"path":"/corpus.{format}/firstUsed","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Gets Dictionary Statistics data","responseTypeInternal":"com.wordnik.corpus.stats.entity.BasicWordUsage","errorResponses":[{"reason":"No data found for corpus.","code":404}],"nickname":"getWordFrequencies","responseClass":"List[basicWordUsage]","httpMethod":"GET"}]},{"path":"/corpus.{format}/totalDocumentCount","description":"","operations":[{"summary":"Returns the count of documents in the Corpus.","responseTypeInternal":"com.wordnik.system.model.LongResult","nickname":"getTotalDocumentCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/corpus.{format}/processText","description":"","operations":[{"parameters":[{"description":"Text body to process.","required":false,"dataType":"string","allowMultiple":false,"paramType":"body"},{"name":"split","description":"Tells the processor to split multiple sentences from the input.  Default is true.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"rank","description":"Flag to invoke the ranking logic.  Default is false.","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Processes text input.","responseTypeInternal":"com.wordnik.corpus.entity.Sentence","errorResponses":[{"reason":"Invalid text supplied.","code":400}],"nickname":"processText","responseClass":"List[sentence]","notes":"Returns tagged and processed text based on the input string.","httpMethod":"POST"}]},{"path":"/corpus.{format}/punctuationFactor","description":"","operations":[{"summary":"Returns corpus-wide PunctuationFactor.","responseTypeInternal":"com.wordnik.corpus.entity.BangFactor","errorResponses":[{"reason":"No data available.","code":404}],"nickname":"getPunctuationFactor","responseClass":"punctuationFactor","httpMethod":"GET"}]},{"path":"/corpus.{format}/documentStats","description":"","operations":[{"parameters":[{"name":"documentStatsType","description":"Type of statistics to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"id","description":"ID of statistics type to return.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"split","description":"Flag to invoke the ranking logic.  Default is false.","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns document-level stats.","responseTypeInternal":"com.wordnik.corpus.stats.entity.BasicDocumentStats","errorResponses":[{"reason":"Invalid stats type supplied.","code":400}],"nickname":"getDocumentStats","responseClass":"basicDocumentStats","httpMethod":"GET"}]},{"path":"/corpus.{format}/words","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Gets corpus-level WordFrequency","responseTypeInternal":"com.wordnik.corpus.stats.entity.WordFrequency","errorResponses":[{"reason":"No corpus frequency data available.","code":400}],"nickname":"getCorpusWordFrequencies","responseClass":"List[wordFrequency]","httpMethod":"GET"}]},{"path":"/corpus.{format}/recentListedWords","description":"","operations":[{"parameters":[{"name":"limit","description":"Maximun results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns recently listed words.","responseTypeInternal":"com.wordnik.community.entity.WordListingHistory","nickname":"getRecentListedWords","responseClass":"List[wordListingHistory]","httpMethod":"GET"}]},{"path":"/corpus.{format}/views","description":"","operations":[{"parameters":[{"name":"word","description":"Filter by word","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userId","description":"filter by user id","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userGuid","description":"Filter by user guid","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sessionId","description":"Filter by user session id","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"callingClass","description":"Filter by calling class","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"method","description":"Filter by calling method","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"environment","description":"Deployment environment to find results from","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"serverIp","description":"Server IP to query from","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"createdAfter","description":"Date to find results after","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches views from the website.","responseTypeInternal":"com.wordnik.community.entity.WordView","nickname":"getViews","responseClass":"List[wordView]","httpMethod":"GET"}]},{"path":"/corpus.{format}/contextualLookup","description":"","operations":[{"parameters":[{"name":"word","description":"Word of interest","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"contextString","description":"Sentence word appears in","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"title","description":"Word of interest","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"metadataId","description":"Word of interest","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"partnerId","description":"Partner Id","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sourceUrl","description":"Document source URL","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Mock method to return Contextual Lookup info.","responseTypeInternal":"com.wordnik.corpus.model.ContextualLookupResponse","nickname":"getMockContextualLookupInfo","responseClass":"contextualLookupResponse","notes":"Internal Only","httpMethod":"GET"},{"parameters":[{"name":"category","description":"Filters response by category","required":false,"dataType":"contextualLookupRequest","valueTypeInternal":"com.wordnik.corpus.model.ContextualLookupRequest","allowMultiple":false,"paramType":"query"}],"summary":"Fetches ContextualLookup info.","responseTypeInternal":"com.wordnik.corpus.model.ContextualLookupResponse","nickname":"getContextualLookupInfo","responseClass":"contextualLookupResponse","httpMethod":"POST"}]},{"path":"/corpus.{format}/totalWordCount","description":"","operations":[{"summary":"Returns the count of tokens in the Corpus.","responseTypeInternal":"com.wordnik.system.model.LongResult","nickname":"getTotalTokensCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/corpus.{format}/sentenceCount","description":"","operations":[{"summary":"Returns the count of sentences in the Corpus.","responseTypeInternal":"com.wordnik.system.model.LongResult","nickname":"getTotalSentencesCount","responseClass":"long","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1","apiVersion":"4.0"}
+{"resourcePath":"/corpus","models":{"Long":{"properties":{"value":{"type":"long"}},"id":"long"},"WordResult":{"properties":{"count":{"type":"long"},"wordstring":{"type":"string"}},"id":"wordResult"},"PunctuationFactor":{"properties":{"periodCount":{"type":"long"},"exclamationPointCount":{"type":"long"},"wordId":{"type":"long"},"questionMarkCount":{"type":"long"},"totalCount":{"type":"long"}},"id":"punctuationFactor"},"WordListingHistory":{"properties":{"wordId":{"type":"long"},"listingCount":{"type":"long"},"wordString":{"type":"string"}},"id":"wordListingHistory"},"ContextualLookupRequest":{"properties":{"partnerId":{"type":"string"},"documentTitle":{"type":"string"},"contextString":{"type":"string"},"sourceUrl":{"type":"string"},"wordstring":{"type":"string"},"metadataId":{"type":"string"}},"id":"contextualLookupRequest"},"BasicWordUsage":{"properties":{"sentenceId":{"type":"long"},"year":{"type":"integer"},"wordstring":{"type":"string"},"documentId":{"type":"long"}},"id":"basicWordUsage"},"WordView":{"properties":{"id":{"type":"long"},"word":{"type":"string"}},"id":"wordView"},"ScoredWord":{"properties":{"position":{"type":"int"},"id":{"type":"long"},"docTermCount":{"type":"int"},"lemma":{"type":"string"},"wordType":{"type":"string"},"score":{"type":"float"},"sentenceId":{"type":"long"},"word":{"type":"string"},"stopword":{"type":"boolean"},"baseWordScore":{"type":"double"},"partOfSpeech":{"type":"string"}},"id":"scoredWord"},"LookupExample":{"properties":{"sourceName":{"type":"string"},"uRL":{"type":"string"},"exampleString":{"type":"string"}},"id":"lookupExample"},"DictionaryStats":{"properties":{"dictionaryName":{"type":"string"},"exampleCount":{"type":"int"},"defintionCount":{"type":"int"},"relationshipLinks":{"type":"Map[string,integer]"},"textPronunciationCount":{"type":"int"},"wordCount":{"type":"int"},"wordsWithRelationship":{"type":"Map[string,integer]"}},"id":"dictionaryStats"},"ContextualLookupResponse":{"properties":{"lookupExamples":{"type":"array","items":{"$ref":"lookupExample"}},"wordstring":{"type":"string"}},"id":"contextualLookupResponse"},"WordFrequency":{"properties":{"count":{"type":"long"},"wordstring":{"type":"string"}},"id":"wordFrequency"},"Sentence":{"properties":{"id":{"type":"long"},"scoredWords":{"type":"array","items":{"$ref":"scoredWord"}},"display":{"type":"string"},"rating":{"type":"int"},"documentMetadataId":{"type":"long"}},"id":"sentence"},"BasicDocumentStats":{"properties":{"uniqueBiGramsCount":{"type":"long"},"wordsCount":{"type":"long"},"documentsCount":{"type":"long"},"firstUsedWordsCount":{"type":"long"},"tokensCount":{"type":"long"},"sentencesCount":{"type":"long"},"viableSentencesCount":{"type":"long"},"type":{"type":"string"},"uniqueWordsCount":{"type":"long"},"key":{"type":"string"}},"id":"basicDocumentStats"}},"apis":[{"path":"/corpus.{format}/recentViews","description":"","operations":[{"parameters":[{"name":"limit","defaultValue":"5","description":"Limits results","required":false,"dataType":"string","allowableValues":{"max":10000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"humanOnly","defaultValue":"false","description":"Returns results only from human visitors","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sortByFrequency","defaultValue":"false","description":"Sorts results by frequency","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Fetches recent views from the website","responseTypeInternal":"com.wordnik.corpus.model.WordResult","nickname":"getRecentViews","responseClass":"List[wordResult]","httpMethod":"GET"}]},{"path":"/corpus.{format}/words/{statsType}/{object}","description":"","operations":[{"parameters":[{"name":"statsType","description":"Stats type to fetch","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"object","description":"Object identifier","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Gets WordFrequency data","responseTypeInternal":"com.wordnik.corpus.stats.entity.WordFrequency","errorResponses":[{"reason":"Invalid dimension for WordFrequency data or Object Identifier not found.","code":400}],"nickname":"getWordFrequencies","responseClass":"List[wordFrequency]","httpMethod":"GET"}]},{"path":"/corpus.{format}/dictionaryStats","description":"","operations":[{"parameters":[{"name":"sourceDictionary","description":"Dictionary name to fetch stats for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Gets Dictionary Statistics data","responseTypeInternal":"com.wordnik.corpus.stats.entity.DictionaryStats","errorResponses":[{"reason":"Invalid dictionary name supplied.","code":404}],"nickname":"getWordFrequencies","responseClass":"dictionaryStats","httpMethod":"GET"}]},{"path":"/corpus.{format}/firstUsed","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Gets Dictionary Statistics data","responseTypeInternal":"com.wordnik.corpus.stats.entity.BasicWordUsage","errorResponses":[{"reason":"No data found for corpus.","code":404}],"nickname":"getWordFrequencies","responseClass":"List[basicWordUsage]","httpMethod":"GET"}]},{"path":"/corpus.{format}/totalDocumentCount","description":"","operations":[{"summary":"Returns the count of documents in the Corpus.","responseTypeInternal":"com.wordnik.system.model.LongResult","nickname":"getTotalDocumentCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/corpus.{format}/processText","description":"","operations":[{"parameters":[{"description":"Text body to process.","required":false,"dataType":"string","allowMultiple":false,"paramType":"body"},{"name":"split","description":"Tells the processor to split multiple sentences from the input.  Default is true.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"rank","description":"Flag to invoke the ranking logic.  Default is false.","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Processes text input.","responseTypeInternal":"com.wordnik.corpus.entity.Sentence","errorResponses":[{"reason":"Invalid text supplied.","code":400}],"nickname":"processText","responseClass":"List[sentence]","notes":"Returns tagged and processed text based on the input string.","httpMethod":"POST"}]},{"path":"/corpus.{format}/punctuationFactor","description":"","operations":[{"summary":"Returns corpus-wide PunctuationFactor.","responseTypeInternal":"com.wordnik.corpus.entity.BangFactor","errorResponses":[{"reason":"No data available.","code":404}],"nickname":"getPunctuationFactor","responseClass":"punctuationFactor","httpMethod":"GET"}]},{"path":"/corpus.{format}/documentStats","description":"","operations":[{"parameters":[{"name":"documentStatsType","description":"Type of statistics to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"id","description":"ID of statistics type to return.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"split","description":"Flag to invoke the ranking logic.  Default is false.","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns document-level stats.","responseTypeInternal":"com.wordnik.corpus.stats.entity.BasicDocumentStats","errorResponses":[{"reason":"Invalid stats type supplied.","code":400}],"nickname":"getDocumentStats","responseClass":"basicDocumentStats","httpMethod":"GET"}]},{"path":"/corpus.{format}/words","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Gets corpus-level WordFrequency","responseTypeInternal":"com.wordnik.corpus.stats.entity.WordFrequency","errorResponses":[{"reason":"No corpus frequency data available.","code":400}],"nickname":"getCorpusWordFrequencies","responseClass":"List[wordFrequency]","httpMethod":"GET"}]},{"path":"/corpus.{format}/recentListedWords","description":"","operations":[{"parameters":[{"name":"limit","description":"Maximun results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns recently listed words.","responseTypeInternal":"com.wordnik.community.entity.WordListingHistory","nickname":"getRecentListedWords","responseClass":"List[wordListingHistory]","httpMethod":"GET"}]},{"path":"/corpus.{format}/views","description":"","operations":[{"parameters":[{"name":"word","description":"Filter by word","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userId","description":"filter by user id","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userGuid","description":"Filter by user guid","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sessionId","description":"Filter by user session id","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"callingClass","description":"Filter by calling class","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"method","description":"Filter by calling method","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"environment","description":"Deployment environment to find results from","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"serverIp","description":"Server IP to query from","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"createdAfter","description":"Date to find results after","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches views from the website","responseTypeInternal":"com.wordnik.community.entity.WordView","nickname":"getViews","responseClass":"List[wordView]","httpMethod":"GET"}]},{"path":"/corpus.{format}/contextualLookup","description":"","operations":[{"parameters":[{"name":"word","description":"Word of interest","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"contextString","description":"Sentence word appears in","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"title","description":"Word of interest","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"metadataId","description":"Word of interest","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"partnerId","description":"Partner Id","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sourceUrl","description":"Document source URL","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Mock method to return Contextual Lookup info.","responseTypeInternal":"com.wordnik.corpus.model.ContextualLookupResponse","nickname":"getMockContextualLookupInfo","responseClass":"contextualLookupResponse","notes":"Internal Only","httpMethod":"GET"},{"parameters":[{"name":"category","description":"Filters response by category","required":false,"dataType":"contextualLookupRequest","valueTypeInternal":"com.wordnik.corpus.model.ContextualLookupRequest","allowMultiple":false,"paramType":"query"}],"summary":"Fetches ContextualLookup info.","responseTypeInternal":"com.wordnik.corpus.model.ContextualLookupResponse","nickname":"getContextualLookupInfo","responseClass":"contextualLookupResponse","httpMethod":"POST"}]},{"path":"/corpus.{format}/totalWordCount","description":"","operations":[{"summary":"Returns the count of tokens in the Corpus.","responseTypeInternal":"com.wordnik.system.model.LongResult","nickname":"getTotalTokensCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/corpus.{format}/sentenceCount","description":"","operations":[{"summary":"Returns the count of sentences in the Corpus.","responseTypeInternal":"com.wordnik.system.model.LongResult","nickname":"getTotalSentencesCount","responseClass":"long","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/api_docs/document.json

@@ -1 +1 @@
-{"resourcePath":"/document","models":{"DocumentMetadata":{"properties":{"yearType":{"type":"yearType"},"expirationDate":{"type":"Date"},"extendedMetadata":{"type":"extendedMetadata"},"tag":{"type":"array","items":{"type":"string"}},"stats":{"type":"basicDocumentStats"},"provider":{"type":"contentProvider"},"contentType":{"type":"contentType"},"sourceUrl":{"type":"string"},"date":{"type":"Date"},"medium":{"type":"documentMedium"},"guid":{"type":"string"},"id":{"type":"long"},"author":{"type":"array","items":{"$ref":"author"}},"title":{"type":"string"},"primaryAuthorType":{"type":"authorType"},"createdAt":{"type":"Date"},"classification":{"type":"subjectClassificationType"},"year":{"type":"integer"},"primaryAuthor":{"type":"string"},"rating":{"type":"double"},"primaryAuthorId":{"type":"long"}},"id":"documentMetadata"},"DocumentModel":{"properties":{"biGramFrequency":{"type":"array","items":{"$ref":"biGramFrequency"}},"sentence":{"type":"array","items":{"$ref":"sentence"}},"wordFrequency":{"type":"array","items":{"$ref":"wordFrequency"}},"documentMetadata":{"type":"documentMetadata"},"basicDocumentStats":{"type":"basicDocumentStats"}},"id":"documentModel"},"ExtendedMetadata":{"properties":{"sourceFileSize":{"type":"long"},"issn":{"type":"string"},"isbn":{"type":"string"},"lccn":{"type":"string"},"documentMetadataId":{"type":"long"}},"id":"extendedMetadata"},"Author":{"properties":{"id":{"type":"long"},"authorType":{"type":"authorType"},"createdAt":{"type":"Date"},"description":{"type":"string"},"name":{"type":"string"},"uniqueName":{"type":"string"}},"id":"author"},"ScoredWord":{"properties":{"position":{"type":"int"},"id":{"type":"long"},"wordType":{"type":"string"},"score":{"type":"float"},"sentenceId":{"type":"long"},"word":{"type":"string"},"partOfSpeech":{"type":"string"}},"id":"scoredWord"},"DocumentMedium":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"documentMedium"},"YearType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"yearType"},"BiGramFrequency":{"properties":{"count":{"type":"long"},"bigram":{"type":"bigram"},"wlmi":{"type":"double"},"mi":{"type":"double"}},"id":"biGramFrequency"},"WordFrequency":{"properties":{"count":{"type":"long"},"wordstring":{"type":"string"}},"id":"wordFrequency"},"Sentence":{"properties":{"id":{"type":"long"},"display":{"type":"string"},"rating":{"type":"int"},"documentMetadataId":{"type":"long"},"scoredWord":{"type":"array","items":{"$ref":"scoredWord"}}},"id":"sentence"},"SubjectClassificationType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"subjectClassificationType"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"},"Bigram":{"properties":{"count":{"type":"long"},"gram2":{"type":"string"},"gram1":{"type":"string"},"wlmi":{"type":"double"},"mi":{"type":"double"}},"id":"bigram"},"AuthorType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"authorType"},"BasicDocumentStats":{"properties":{"uniqueBiGramsCount":{"type":"long"},"wordsCount":{"type":"long"},"documentsCount":{"type":"long"},"firstUsedWordsCount":{"type":"long"},"tokensCount":{"type":"long"},"sentencesCount":{"type":"long"},"viableSentencesCount":{"type":"long"},"type":{"type":"string"},"uniqueWordsCount":{"type":"long"},"key":{"type":"string"}},"id":"basicDocumentStats"},"ContentType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentType"}},"apis":[{"path":"/document.{format}/id/{document_id}/words","description":"","operations":[{"parameters":[{"name":"document_id","description":"Document ID to fetch frequency data for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches Document objects by Content Provider code.","responseTypeInternal":"com.wordnik.corpus.stats.entity.WordFrequency","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getWordFrequencies","responseClass":"List[wordFrequency]","httpMethod":"GET"}]},{"path":"/document.{format}/{contentProvider}/documents","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code to fetch for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"filterByWordScore","description":"Filter document model by word scores.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minWordScore","description":"Minimum word score to return.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches examples for a specific provider matching a criteria.","responseTypeInternal":"com.wordnik.corpus.document.entity.DocumentModel","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"nickname":"getGlossaries","responseClass":"List[documentModel]","httpMethod":"GET"}]},{"path":"/document.{format}/provider/{provider}","description":"","operations":[{"parameters":[{"name":"provider","description":"Content provider","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches Document objects by Content Provider code.","responseTypeInternal":"com.wordnik.corpus.document.entity.DocumentMetadata","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getDocumentsByContentProvider","responseClass":"List[documentMetadata]","httpMethod":"GET"}]},{"path":"/document.{format}/{id}/metadata","description":"","operations":[{"parameters":[{"name":"id","description":"Document ID","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches Document objects by document identifier.","responseTypeInternal":"com.wordnik.corpus.document.entity.DocumentMetadata","errorResponses":[{"reason":"Invalid document ID supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getMetadataById","responseClass":"documentMetadata","httpMethod":"GET"}]},{"path":"/document.{format}/{id}/model","description":"","operations":[{"parameters":[{"name":"scores","description":"Return word scores","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"id","description":"Document ID","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches Document objects by id.","responseTypeInternal":"com.wordnik.corpus.document.entity.DocumentModel","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getModelById","responseClass":"documentModel","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1","apiVersion":"4.0"}
+{"resourcePath":"/document","models":{"DocumentMetadata":{"properties":{"tags":{"type":"array","items":{"type":"string"}},"yearType":{"type":"yearType"},"expirationDate":{"type":"Date"},"extendedMetadata":{"type":"extendedMetadata"},"stats":{"type":"basicDocumentStats"},"provider":{"type":"contentProvider"},"contentType":{"type":"contentType"},"sourceUrl":{"type":"string"},"date":{"type":"Date"},"medium":{"type":"documentMedium"},"guid":{"type":"string"},"id":{"type":"long"},"authors":{"type":"array","items":{"$ref":"author"}},"title":{"type":"string"},"primaryAuthorType":{"type":"authorType"},"createdAt":{"type":"Date"},"classification":{"type":"subjectClassificationType"},"year":{"type":"integer"},"primaryAuthor":{"type":"string"},"rating":{"type":"double"},"primaryAuthorId":{"type":"long"}},"id":"documentMetadata"},"DocumentModel":{"properties":{"bigramFrequencies":{"type":"array","items":{"$ref":"biGramFrequency"}},"sentences":{"type":"array","items":{"$ref":"sentence"}},"wordFrequencies":{"type":"array","items":{"$ref":"wordFrequency"}},"documentMetadata":{"type":"documentMetadata"},"basicDocumentStats":{"type":"basicDocumentStats"}},"id":"documentModel"},"ExtendedMetadata":{"properties":{"sourceFileSize":{"type":"long"},"issn":{"type":"string"},"isbn":{"type":"string"},"lccn":{"type":"string"},"documentMetadataId":{"type":"long"}},"id":"extendedMetadata"},"Author":{"properties":{"id":{"type":"long"},"authorType":{"type":"authorType"},"createdAt":{"type":"Date"},"description":{"type":"string"},"name":{"type":"string"},"uniqueName":{"type":"string"}},"id":"author"},"ScoredWord":{"properties":{"position":{"type":"int"},"id":{"type":"long"},"docTermCount":{"type":"int"},"lemma":{"type":"string"},"wordType":{"type":"string"},"score":{"type":"float"},"sentenceId":{"type":"long"},"word":{"type":"string"},"stopword":{"type":"boolean"},"baseWordScore":{"type":"double"},"partOfSpeech":{"type":"string"}},"id":"scoredWord"},"DocumentMedium":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"documentMedium"},"YearType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"yearType"},"BiGramFrequency":{"properties":{"count":{"type":"long"},"bigram":{"type":"bigram"},"wlmi":{"type":"double"},"mi":{"type":"double"}},"id":"biGramFrequency"},"WordFrequency":{"properties":{"count":{"type":"long"},"wordstring":{"type":"string"}},"id":"wordFrequency"},"Sentence":{"properties":{"id":{"type":"long"},"scoredWords":{"type":"array","items":{"$ref":"scoredWord"}},"display":{"type":"string"},"rating":{"type":"int"},"documentMetadataId":{"type":"long"}},"id":"sentence"},"SubjectClassificationType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"subjectClassificationType"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"},"Bigram":{"properties":{"count":{"type":"long"},"gram2":{"type":"string"},"gram1":{"type":"string"},"wlmi":{"type":"double"},"mi":{"type":"double"}},"id":"bigram"},"AuthorType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"authorType"},"BasicDocumentStats":{"properties":{"uniqueBiGramsCount":{"type":"long"},"wordsCount":{"type":"long"},"documentsCount":{"type":"long"},"firstUsedWordsCount":{"type":"long"},"tokensCount":{"type":"long"},"sentencesCount":{"type":"long"},"viableSentencesCount":{"type":"long"},"type":{"type":"string"},"uniqueWordsCount":{"type":"long"},"key":{"type":"string"}},"id":"basicDocumentStats"},"ContentType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentType"}},"apis":[{"path":"/document.{format}/id/{document_id}/words","description":"","operations":[{"parameters":[{"name":"document_id","description":"Document ID to fetch frequency data for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches Document objects by Content Provider code.","responseTypeInternal":"com.wordnik.corpus.stats.entity.WordFrequency","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getWordFrequencies","responseClass":"List[wordFrequency]","httpMethod":"GET"}]},{"path":"/document.{format}/{contentProvider}/documents","description":"","operations":[{"parameters":[{"name":"contentProvider","description":"Partner Code to fetch for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"filterByWordScore","description":"Filter document model by word scores.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minWordScore","description":"Minimum word score to return.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches examples for a specific provider matching a criteria.","responseTypeInternal":"com.wordnik.corpus.document.entity.DocumentModel","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":404}],"nickname":"getGlossaries","responseClass":"List[documentModel]","httpMethod":"GET"}]},{"path":"/document.{format}/provider/{provider}","description":"","operations":[{"parameters":[{"name":"provider","description":"Content provider","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches Document objects by Content Provider code.","responseTypeInternal":"com.wordnik.corpus.document.entity.DocumentMetadata","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getDocumentsByContentProvider","responseClass":"List[documentMetadata]","httpMethod":"GET"}]},{"path":"/document.{format}/{id}/metadata","description":"","operations":[{"parameters":[{"name":"id","description":"Document ID","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches Document objects by document identifier.","responseTypeInternal":"com.wordnik.corpus.document.entity.DocumentMetadata","errorResponses":[{"reason":"Invalid document ID supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getMetadataById","responseClass":"documentMetadata","httpMethod":"GET"}]},{"path":"/document.{format}/{id}/model","description":"","operations":[{"parameters":[{"name":"scores","description":"Return word scores","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"id","description":"Document ID","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches Document objects by id.","responseTypeInternal":"com.wordnik.corpus.document.entity.DocumentModel","errorResponses":[{"reason":"Invalid Content Provider code supplied.","code":400},{"reason":"No activation code available.","code":404}],"nickname":"getModelById","responseClass":"documentModel","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/api_docs/feeds.json

@@ -0,0 +1 @@
+{"resourcePath":"/feeds","models":{"Rss":{"properties":{"channel":{"type":"Channel"},"version":{"type":"double"}},"id":"rss"},"Channel":{"properties":{"title":{"type":"string"},"description":{"type":"string"},"link":{"type":"string"},"item":{"type":"array","items":{"$ref":"Item"}},"generator":{"type":"string"}},"id":"Channel"},"Item":{"properties":{"guid":{"type":"tony"},"pubDate":{"type":"Date"},"title":{"type":"string"},"description":{"type":"string"},"link":{"type":"string"}},"id":"Item"},"Tony":{"properties":{"isPermaLink":{"type":"boolean"},"permaLink":{"type":"boolean"},"description":{"type":"string"}},"id":"tony"}},"apis":[{"path":"/feeds.{format}/pronunciations","description":"","operations":[{"parameters":[{"name":"limit","description":"limit","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns recent pronunciations","responseTypeInternal":"com.wordnik.resource.model.RSSFeed","nickname":"getRecentPronunciations","responseClass":"rss","httpMethod":"GET"}]},{"path":"/feeds.{format}/wordOfTheDay","description":"","operations":[{"parameters":[{"name":"limit","description":"limit","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns the word-of-the-day","responseTypeInternal":"com.wordnik.resource.model.RSSFeed","errorResponses":[{"reason":"No word of the day available","code":404}],"nickname":"getWordOfTheDay","responseClass":"rss","httpMethod":"GET"}]},{"path":"/feeds.{format}/people/{username}/commentsBy","description":"","operations":[{"parameters":[{"name":"username","description":"username","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"limit","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns comments made by the specified user","responseTypeInternal":"com.wordnik.resource.model.RSSFeed","errorResponses":[{"reason":"Invalid username supplied.","code":400}],"nickname":"getCommentsByUser","responseClass":"rss","httpMethod":"GET"}]},{"path":"/feeds.{format}/people/{username}/commentsOn","description":"","operations":[{"parameters":[{"name":"username","description":"username","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"limit","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns comments made on the specified user","responseTypeInternal":"com.wordnik.resource.model.RSSFeed","errorResponses":[{"reason":"Invalid username supplied.","code":400}],"nickname":"getCommentsOnUser","responseClass":"rss","httpMethod":"GET"}]},{"path":"/feeds.{format}/favorites","description":"","operations":[{"parameters":[{"name":"limit","description":"limit","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns recently favorited words","responseTypeInternal":"com.wordnik.resource.model.RSSFeed","nickname":"getRecentFavorites","responseClass":"rss","httpMethod":"GET"}]},{"path":"/feeds.{format}/people/{username}/lists","description":"","operations":[{"parameters":[{"name":"username","description":"username","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"limit","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns lists for the specified user","responseTypeInternal":"com.wordnik.resource.model.RSSFeed","errorResponses":[{"reason":"Invalid username supplied.","code":400}],"nickname":"getUserLists","responseClass":"rss","httpMethod":"GET"}]},{"path":"/feeds.{format}/people/{username}/favorites","description":"","operations":[{"parameters":[{"name":"username","description":"username","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"limit","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns favorites for the specified user","responseTypeInternal":"com.wordnik.resource.model.RSSFeed","errorResponses":[{"reason":"Invalid username supplied.","code":400}],"nickname":"getUserFavorites","responseClass":"rss","httpMethod":"GET"}]},{"path":"/feeds.{format}/lookups","description":"","operations":[{"parameters":[{"name":"limit","description":"limit","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns recent lookups","responseTypeInternal":"com.wordnik.resource.model.RSSFeed","nickname":"getRecentLookups","responseClass":"rss","httpMethod":"GET"}]},{"path":"/feeds.{format}/lists","description":"","operations":[{"parameters":[{"name":"limit","description":"limit","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns recent lists","responseTypeInternal":"com.wordnik.resource.model.RSSFeed","nickname":"getRecentUserLists","responseClass":"rss","httpMethod":"GET"}]},{"path":"/feeds.{format}/lists/{permalinkId}/comments","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"permalinkId","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"limit","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns comments on the specified list","responseTypeInternal":"com.wordnik.resource.model.RSSFeed","nickname":"getUserListComments","responseClass":"rss","httpMethod":"GET"}]},{"path":"/feeds.{format}/lists/{permalinkId}","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"permalinkId","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns the specified wordList","responseTypeInternal":"com.wordnik.resource.model.RSSFeed","nickname":"getUserList","responseClass":"rss","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/api_docs/glossary.json

@@ -1 +1 @@
-{"resourcePath":"/glossary","models":{"Glossary":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"permalinkId":{"type":"string"},"status":{"type":"glossaryStatus"},"createdAt":{"type":"Date"},"description":{"type":"string"},"name":{"type":"string"},"partnerId":{"type":"string"},"totalEntries":{"type":"int"},"publishedDate":{"type":"Date"},"version":{"type":"double"}},"id":"Glossary"},"AudioType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"audioType"},"Note":{"properties":{"noteType":{"type":"string"},"appliesTo":{"type":"array","items":{"type":"string"}},"value":{"type":"string"},"pos":{"type":"int"}},"id":"note"},"Related":{"properties":{"label1":{"type":"string"},"label2":{"type":"string"},"relationshipType":{"type":"string"},"label3":{"type":"string"},"word":{"type":"array","items":{"type":"string"}},"gram":{"type":"string"},"label4":{"type":"string"}},"id":"related"},"ScoredWord":{"properties":{"position":{"type":"int"},"id":{"type":"long"},"wordType":{"type":"string"},"score":{"type":"float"},"sentenceId":{"type":"long"},"word":{"type":"string"},"partOfSpeech":{"type":"string"}},"id":"scoredWord"},"Citation":{"properties":{"cite":{"type":"string"},"source":{"type":"string"}},"id":"citation"},"GlossaryStatus":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"glossaryStatus"},"GlossaryEntry":{"properties":{"definition":{"type":"array","items":{"$ref":"definition"}},"example":{"type":"array","items":{"$ref":"example"}},"glossaryId":{"type":"long"},"audioFile":{"type":"array","items":{"$ref":"audioFile"}},"wordstring":{"type":"string"}},"id":"GlossaryEntry"},"Category":{"properties":{"name":{"type":"string"}},"id":"category"},"Example":{"properties":{"exampleId":{"type":"long"},"title":{"type":"string"},"text":{"type":"string"},"word":{"type":"string"},"provider":{"type":"contentProvider"},"year":{"type":"integer"},"rating":{"type":"float"},"documentId":{"type":"long"},"url":{"type":"string"}},"id":"example"},"Root":{"properties":{"name":{"type":"string"},"categories":{"type":"array","items":{"$ref":"category"}}},"id":"root"},"Sentence":{"properties":{"id":{"type":"long"},"display":{"type":"string"},"rating":{"type":"int"},"documentMetadataId":{"type":"long"},"scoredWord":{"type":"array","items":{"$ref":"scoredWord"}}},"id":"sentence"},"ExampleUsage":{"properties":{"text":{"type":"string"}},"id":"ExampleUsage"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"},"AudioFile":{"properties":{"attributedWordLink":{"type":"string"},"commentCount":{"type":"int"},"voteCount":{"type":"integer"},"fileUrl":{"type":"string"},"audioType":{"type":"string"},"id":{"type":"long","required":true},"duration":{"type":"double"},"createdBy":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"Date"},"dictionaryAttribution":{"type":"string"},"voteWeightedAverage":{"type":"float"},"voteAverage":{"type":"float"},"word":{"type":"string"}},"id":"audioFile"},"Label":{"properties":{"text":{"type":"string"},"type":{"type":"string"}},"id":"Label"},"Definition":{"properties":{"extendedText":{"type":"string"},"citation":{"type":"array","items":{"$ref":"citation"}},"text":{"type":"string"},"sourceDictionary":{"type":"string"},"exampleUsage":{"type":"array","items":{"$ref":"ExampleUsage"}},"relWord":{"type":"array","items":{"$ref":"related"}},"score":{"type":"float"},"label":{"type":"array","items":{"$ref":"Label"}},"seqString":{"type":"string"},"dictionaryAttribution":{"type":"string"},"sequence":{"type":"string"},"word":{"type":"string"},"note":{"type":"array","items":{"$ref":"note"}},"textPron":{"type":"array","items":{"$ref":"textPron"}},"partOfSpeech":{"type":"string"}},"id":"definition"},"PartOfSpeech":{"properties":{"roots":{"type":"array","items":{"$ref":"root"}}},"id":"partOfSpeech"},"TextPron":{"properties":{"raw":{"type":"string"},"id":{"type":"long"},"seq":{"type":"int"},"rawType":{"type":"string"}},"id":"textPron"}},"apis":[{"path":"/glossary.{format}/{permalinkId}/search","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary. This will be provided by wordnik and will be different in staging and production.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"wordPattern","description":"Word pattern to fetch with. You can use * and ?.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sourceDictionaries","description":"Gets defintions for the matched word from dictionaries in the supplied order of precedence","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"definitionsLimit","description":"Maximum number of definitions to return for the word that matches the exact input","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"examplesLimit","description":"Maximum number of examples to return for the word that matches the exact input","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"audioPronunciationsLimit","description":"Maximum number of audio pronunciations to return for the word that matches the exact input","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches GlossaryEntry objects for the specified Glossary. The definitions will come as per the dictionary source order. The first definition can be used to give quick overview of the word. If exact match is found, first record from the search result will be the exact match. First record will also have all the data needed to display definition, pronunciation and example usages. if it is exact match.","responseTypeInternal":"com.wordnik.community.entity.GlossaryEntry","errorResponses":[{"reason":"Invalid permalinkId supplied.","code":404}],"nickname":"getGlossaryEntries","responseClass":"List[GlossaryEntry]","httpMethod":"GET"}]},{"path":"/glossary.{format}/{permalinkId}/publish","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary to publish.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Version to publish.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Publishes a Glossary.","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"publishGlossary","responseClass":"ok","httpMethod":"POST"}]},{"path":"/glossary.{format}/{permalinkId}/clone","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary to version.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"New version number to assign.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Creates a new version of a Glossary.","responseTypeInternal":"com.wordnik.community.entity.Glossary","errorResponses":[{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"createVersion","responseClass":"Glossary","httpMethod":"POST"}]},{"path":"/glossary.{format}/{permalinkId}/entries","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"description":"Glossary Entries to add","required":false,"dataType":"GlossaryEntry[]","valueTypeInternal":"[Lcom.wordnik.community.entity.GlossaryEntry;","allowMultiple":false,"paramType":"body"}],"summary":"Adds GlossaryEntry objects for the specified Glossary.","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"addGlossaryEntry","responseClass":"ok","httpMethod":"POST"}]},{"path":"/glossary.{format}/{permalinkId}/entries/{word}","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"word","description":"Word to remove.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Removes a GlossaryEntry object from the specified Glossary.","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word being removed.","code":400},{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"deleteGlossaryEntry","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/glossary.{format}/{permalinkId}/deleteEntries","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Words to remove.","required":false,"dataType":"StringValue[]","valueTypeInternal":"[Lcom.wordnik.resource.StringValue;","allowMultiple":false,"paramType":"body"},{"name":"version","description":"Specific Glossary version to remove Entries from","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Removes a GlossaryEntry object from the specified Glossary.","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word being removed.","code":400},{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"deleteGlossaryEntries","responseClass":"ok","httpMethod":"POST"}]},{"path":"/glossary.{format}/{permalinkId}/randomEntry","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sourceDictionaries","description":"Gets definitions from dictionaries in the supplied order of precedence","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"definitionsLimit","description":"Maximum number of definitions to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"examplesLimit","description":"Maximum number of examples to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"audioPronunciationsLimit","description":"Maximum number of audio pronunciations to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches a random GlossaryEntry object for the specified Glossary.","responseTypeInternal":"com.wordnik.community.entity.GlossaryEntry","errorResponses":[{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"getRandomGlossaryEntry","responseClass":"GlossaryEntry","httpMethod":"GET"}]},{"path":"/glossary.{format}/{permalinkId}/entry","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"word","description":"The word for which the Glossary Entry is requested","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sourceDictionaries","description":"Gets definitions from dictionaries in the supplied order of precedence","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"definitionsLimit","description":"Maximum number of definitions to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"examplesLimit","description":"Maximum number of examples to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"audioPronunciationsLimit","description":"Maximum number of audio pronunciations to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches the GlossaryEntry object for the specified word in the Glossary.","responseTypeInternal":"com.wordnik.community.entity.GlossaryEntry","errorResponses":[{"reason":"Invalid word being removed.","code":400},{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"getGlossaryEntry","responseClass":"GlossaryEntry","httpMethod":"GET"}]},{"path":"/glossary.{format}/{permalinkId}/{word}/examples","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"word","description":"The word for which the Glossary Entry is requested","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Fetches examples for the Glossary entry","responseTypeInternal":"com.wordnik.corpus.model.Example","errorResponses":[{"reason":"Invalid word being removed.","code":400},{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"getGlossaryEntryExamples","responseClass":"example","httpMethod":"GET"}]},{"path":"/glossary.{format}/{permalinkId}/{word}/pronunciation/{pronId}","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"word","description":"The word for which the Glossary Entry is requested","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"pronId","description":"The pronunciation id for which the audio metadata is requested","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches audio pronunciation for the given id.","responseTypeInternal":"com.wordnik.community.entity.AudioFileMetadata","errorResponses":[{"reason":"Invalid pronunciation id supplied.","code":404}],"nickname":"getAudioFile","responseClass":"audioFile","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1","apiVersion":"4.0"}
+{"resourcePath":"/glossary","models":{"GlossaryStatus":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"glossaryStatus"},"GlossaryEntry":{"properties":{"audioFiles":{"type":"array","items":{"$ref":"audioFile"}},"definitions":{"type":"array","items":{"$ref":"definition"}},"glossaryId":{"type":"long"},"examples":{"type":"array","items":{"$ref":"example"}},"wordstring":{"type":"string"}},"id":"GlossaryEntry"},"Glossary":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"permalinkId":{"type":"string"},"status":{"type":"glossaryStatus"},"createdAt":{"type":"Date"},"description":{"type":"string"},"name":{"type":"string"},"partnerId":{"type":"string"},"totalEntries":{"type":"int"},"publishedDate":{"type":"Date"},"version":{"type":"double"}},"id":"Glossary"},"Example":{"properties":{"exampleId":{"type":"long"},"title":{"type":"string"},"text":{"type":"string"},"word":{"type":"string"},"provider":{"type":"contentProvider"},"year":{"type":"integer"},"rating":{"type":"float"},"documentId":{"type":"long"},"url":{"type":"string"}},"id":"example"},"Sentence":{"properties":{"id":{"type":"long"},"scoredWords":{"type":"array","items":{"$ref":"scoredWord"}},"display":{"type":"string"},"rating":{"type":"int"},"documentMetadataId":{"type":"long"}},"id":"sentence"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"},"AudioFile":{"properties":{"creatorId":{"type":"long"},"attributionUrl":{"type":"string"},"commentCount":{"type":"int"},"voteCount":{"type":"integer"},"fileUrl":{"type":"string"},"audioType":{"type":"string"},"id":{"type":"long"},"duration":{"type":"double"},"attributionText":{"type":"string"},"createdBy":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"Date"},"voteWeightedAverage":{"type":"float"},"voteAverage":{"type":"float"},"word":{"type":"string"}},"id":"audioFile"},"ScoredWord":{"properties":{"position":{"type":"int"},"id":{"type":"long"},"docTermCount":{"type":"int"},"lemma":{"type":"string"},"wordType":{"type":"string"},"score":{"type":"float"},"sentenceId":{"type":"long"},"word":{"type":"string"},"stopword":{"type":"boolean"},"baseWordScore":{"type":"double"},"partOfSpeech":{"type":"string"}},"id":"scoredWord"},"Definition":{"properties":{"extendedText":{"type":"string"},"text":{"type":"string"},"sourceDictionary":{"type":"string"},"citations":{"type":"array","items":{"$ref":"citation"}},"labels":{"type":"array","items":{"$ref":"Label"}},"score":{"type":"float"},"exampleUses":{"type":"array","items":{"$ref":"ExampleUsage"}},"attributionUrl":{"type":"string"},"seqString":{"type":"string"},"attributionText":{"type":"string"},"relatedWords":{"type":"array","items":{"$ref":"related"}},"sequence":{"type":"string"},"word":{"type":"string"},"textProns":{"type":"array","items":{"$ref":"textPron"}},"notes":{"type":"array","items":{"$ref":"note"}},"partOfSpeech":{"type":"string"}},"id":"definition"}},"apis":[{"path":"/glossary.{format}/{permalinkId}","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary to fetch.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Version to fetch","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches a glossary.","responseTypeInternal":"com.wordnik.community.entity.Glossary","errorResponses":[{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"getGlossary","responseClass":"Glossary","httpMethod":"GET"},{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary to fetch.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Version to fetch","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"description":"Updated Glossary","required":false,"dataType":"Glossary","valueTypeInternal":"com.wordnik.community.entity.Glossary","allowMultiple":false,"paramType":"body"}],"summary":"Updates a Glossary.","responseTypeInternal":"com.wordnik.community.entity.Glossary","errorResponses":[{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"updateGlossary","responseClass":"Glossary","httpMethod":"PUT"},{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary to delete.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Version to delete","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Deletes the Glossary.","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"deleteGlossary","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/glossary.{format}/{permalinkId}/entries","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"description":"Glossary Entries to add","required":false,"dataType":"GlossaryEntry[]","valueTypeInternal":"[Lcom.wordnik.community.entity.GlossaryEntry;","allowMultiple":false,"paramType":"body"}],"summary":"Adds GlossaryEntry objects for the specified Glossary.","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"addGlossaryEntry","responseClass":"ok","httpMethod":"POST"}]},{"path":"/glossary.{format}/{permalinkId}/publish","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary to publish.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Version to publish.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Publishes a Glossary.","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"publishGlossary","responseClass":"ok","httpMethod":"POST"}]},{"path":"/glossary.{format}/{permalinkId}/clone","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary to version.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"New version number to assign.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Creates a new version of a Glossary.","responseTypeInternal":"com.wordnik.community.entity.Glossary","errorResponses":[{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"createVersion","responseClass":"Glossary","httpMethod":"POST"}]},{"path":"/glossary.{format}/{permalinkId}/entries/{word}","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"word","description":"Word to remove.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Removes a GlossaryEntry object from the specified Glossary.","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word being removed.","code":400},{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"deleteGlossaryEntry","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/glossary.{format}/{permalinkId}/deleteEntries","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Words to remove.","required":false,"dataType":"StringValue[]","valueTypeInternal":"[Lcom.wordnik.resource.StringValue;","allowMultiple":false,"paramType":"body"},{"name":"version","description":"Specific Glossary version to remove Entries from","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Removes a GlossaryEntry object from the specified Glossary.","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word being removed.","code":400},{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"deleteGlossaryEntries","responseClass":"ok","httpMethod":"POST"}]},{"path":"/glossary.{format}/{permalinkId}/randomEntry","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sourceDictionaries","description":"Gets definitions from dictionaries in the supplied order of precedence","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"definitionsLimit","description":"Maximum number of definitions to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"examplesLimit","description":"Maximum number of examples to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"audioPronunciationsLimit","description":"Maximum number of audio pronunciations to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches a random GlossaryEntry object for the specified Glossary.","responseTypeInternal":"com.wordnik.community.entity.GlossaryEntry","errorResponses":[{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"getRandomGlossaryEntry","responseClass":"GlossaryEntry","httpMethod":"GET"}]},{"path":"/glossary.{format}/{permalinkId}/entries/{word}/examples","description":"","operations":[{"parameters":[{"name":"permalinkId","description":"Permalink of Glossary.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"version","description":"Specific Glossary version to fetch Entries for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"word","description":"The word for which the Glossary Entry is requested","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Fetches examples for the Glossary entry","responseTypeInternal":"com.wordnik.corpus.model.Example","errorResponses":[{"reason":"Invalid word being removed.","code":400},{"reason":"Invalid Permalink ID supplied.","code":404}],"nickname":"getGlossaryEntryExamples","responseClass":"List[example]","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/api_docs/suggest.json

@@ -1 +1 @@
-{"resourcePath":"/suggest","models":{"WordResult":{"properties":{"count":{"type":"long"},"wordstring":{"type":"string"}},"id":"wordResult"},"SearchResult":{"properties":{"matches":{"type":"int"},"more":{"type":"int"},"searchTerm":{"type":"wordResult"},"match":{"type":"array","items":{"$ref":"wordResult"}}},"id":"searchResult"}},"apis":[{"path":"/suggest.{format}/tags/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"Word fragment to use.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns Word strings based on the input.","responseTypeInternal":"com.wordnik.resource.SearchResult","errorResponses":[{"reason":"Invalid Word Fragment supplied.","code":400}],"nickname":"getTagSuggestions","responseClass":"searchResult","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1","apiVersion":"4.0"}
+{"resourcePath":"/suggest","models":{"WordResult":{"properties":{"count":{"type":"long"},"wordstring":{"type":"string"}},"id":"wordResult"},"SearchResult":{"properties":{"matches":{"type":"int"},"more":{"type":"int"},"searchTerm":{"type":"wordResult"},"match":{"type":"array","items":{"$ref":"wordResult"}}},"id":"searchResult"}},"apis":[{"path":"/suggest.{format}/tags/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"Word fragment to use.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns Word strings based on the input.","responseTypeInternal":"com.wordnik.resource.SearchResult","errorResponses":[{"reason":"Invalid Word Fragment supplied.","code":400}],"nickname":"getTagSuggestions","responseClass":"searchResult","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/api_docs/system.json

@@ -1 +1 @@
-{"resourcePath":"/system","models":{"Long":{"properties":{"value":{"type":"long"}},"id":"long"},"Word":{"properties":{"numericProperties":{"type":"Map[string,double]"},"word":{"type":"string"},"stringProperties":{"type":"Map[string,string]"}},"id":"word"},"WordStats":{"properties":{"wordsListedCount":{"type":"long"},"externalApiCallsCount":{"type":"long"},"favoritesCount":{"type":"long"},"wordViewCount":{"type":"long"},"tokensCount":{"type":"long"},"sentencesCount":{"type":"long"},"apiUsersCount":{"type":"long"},"commentsCount":{"type":"long"},"audioPronsCount":{"type":"long"},"listsCount":{"type":"long"},"documentsCount":{"type":"long"},"createdAt":{"type":"Date"},"elapsedMillis":{"type":"long"},"userLoginCount":{"type":"long"},"prettyWordsCount":{"type":"long"},"usersCount":{"type":"long"},"taggedObjectsCount":{"type":"long"},"uniqueWordsCount":{"type":"long"},"tagsCount":{"type":"long"}},"id":"wordStats"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"}},"apis":[{"path":"/system.{format}/providers","description":"","operations":[{"summary":"Returns all defined ContentProviders.","responseTypeInternal":"com.wordnik.corpus.document.model.ContentProvider","nickname":"getProviders","responseClass":"List[contentProvider]","httpMethod":"GET"}]},{"path":"/system.{format}/{word}/related","description":"","operations":[{"parameters":[{"name":"word","description":"Word to find related items for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"type","description":"Relationship type","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Returns weighted terms related to the input word","responseTypeInternal":"com.wordnik.graph.WeightedRelatedWord","errorResponses":[{"reason":"No data found.","code":404}],"nickname":"getRelatedWords","responseClass":"relatedWord","httpMethod":"GET"}]},{"path":"/system.{format}/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to find attributes for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useLiteral","description":"Use exact word","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns a word with attributes","responseTypeInternal":"com.wordnik.graph.DetailedNode","errorResponses":[{"reason":"No data found.","code":404}],"nickname":"getRelatedWords","responseClass":"word","httpMethod":"GET"}]},{"path":"/system.{format}/graph","description":"","operations":[{"parameters":[{"name":"term","description":"Term to query","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"objectType","description":"Object type","required":false,"dataType":"string","allowableValues":{"values":["word"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludeEdgeTypes","description":"Relationships to exclude","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includeEdgeTypes","description":"Specifies the only relationship to include (note, this overrides the exclusions)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"startConstraints","description":"Edge start constraints to enforce","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"endConstraints","description":"Edge end constraints to enforce","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxHops","defaultValue":"2","description":"Maximum number of to route","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxResults","defaultValue":"2","description":"Maximum number of routes to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"destination","description":"Destination to route to (VERY inefficient)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"useGraphML","description":"Return is GraphML format","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"goal","description":"Selection goal","required":false,"dataType":"string","allowableValues":{"values":["content","similar","basic-form"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Returns a graph response for the supplied terms","responseTypeInternal":"com.wordnik.graph.RouteResponse","errorResponses":[{"reason":"Invalid query.","code":400},{"reason":"No data found.","code":404}],"nickname":"getWordById","responseClass":"com.wordnik.graph.RouteResponse","httpMethod":"GET"}]},{"path":"/system.{format}/audioRecordId","description":"","operations":[{"summary":"Gets an Audio File ID for recording.","responseTypeInternal":"com.wordnik.system.model.LongResult","nickname":"getAudioRecordId","responseClass":"long","httpMethod":"GET"}]},{"path":"/system.{format}/audioDuration","description":"","operations":[{"parameters":[{"name":"audioFileId","description":"Audio file id","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"duration","description":"Audio duration","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Sets duration of an Audio File","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid audio file id supplied.","code":400}],"nickname":"setAudioDuration","responseClass":"ok","httpMethod":"POST"}]},{"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.","responseTypeInternal":"com.wordnik.system.model.SystemStats","nickname":"getStats","responseClass":"List[wordStats]","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1","apiVersion":"4.0"}
+{"resourcePath":"/system","models":{"Long":{"properties":{"value":{"type":"long"}},"id":"long"},"Word":{"properties":{"numericProperties":{"type":"Map[string,double]"},"word":{"type":"string"},"stringProperties":{"type":"Map[string,string]"}},"id":"word"},"WordStats":{"properties":{"wordsListedCount":{"type":"long"},"externalApiCallsCount":{"type":"long"},"favoritesCount":{"type":"long"},"wordViewCount":{"type":"long"},"tokensCount":{"type":"long"},"sentencesCount":{"type":"long"},"apiUsersCount":{"type":"long"},"commentsCount":{"type":"long"},"audioPronsCount":{"type":"long"},"listsCount":{"type":"long"},"documentsCount":{"type":"long"},"createdAt":{"type":"Date"},"elapsedMillis":{"type":"long"},"userLoginCount":{"type":"long"},"prettyWordsCount":{"type":"long"},"usersCount":{"type":"long"},"taggedObjectsCount":{"type":"long"},"uniqueWordsCount":{"type":"long"},"tagsCount":{"type":"long"}},"id":"wordStats"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"},"Graph":{"properties":{"elements":{"type":"array","items":{"$ref":"element"}}},"id":"graph"},"RelatedWord":{"properties":{"relationship":{"type":"string"},"weight":{"type":"double"},"word":{"type":"string"}},"id":"relatedWord"},"Element":{"properties":{"id":{"type":"string"},"weight":{"type":"float"},"type":{"type":"string"}},"id":"element"}},"apis":[{"path":"/system.{format}/providers","description":"","operations":[{"summary":"Returns all defined ContentProviders.","responseTypeInternal":"com.wordnik.corpus.document.model.ContentProvider","nickname":"getProviders","responseClass":"List[contentProvider]","httpMethod":"GET"}]},{"path":"/system.{format}/{word}/related","description":"","operations":[{"parameters":[{"name":"word","description":"Word to find related items for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"type","description":"Relationship type","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Returns weighted terms related to the input word","responseTypeInternal":"com.wordnik.graph.WeightedRelatedWord","errorResponses":[{"reason":"No data found.","code":404}],"nickname":"getRelatedWords","responseClass":"relatedWord","httpMethod":"GET"}]},{"path":"/system.{format}/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to find attributes for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useLiteral","description":"Use exact word","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns a word with attributes","responseTypeInternal":"com.wordnik.graph.DetailedNode","errorResponses":[{"reason":"No data found.","code":404}],"nickname":"getRelatedWords","responseClass":"word","httpMethod":"GET"}]},{"path":"/system.{format}/graph","description":"","operations":[{"parameters":[{"name":"term","description":"Term to query","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"objectType","description":"Object type","required":false,"dataType":"string","allowableValues":{"values":["word"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludeEdgeTypes","description":"Relationships to exclude","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includeEdgeTypes","description":"Specifies the only relationship to include (note, this overrides the exclusions)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"startConstraints","description":"Edge start constraints to enforce","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"endConstraints","description":"Edge end constraints to enforce","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxHops","defaultValue":"2","description":"Maximum number of to route","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxResults","defaultValue":"2","description":"Maximum number of routes to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"destination","description":"Destination to route to (VERY inefficient)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"useGraphML","description":"Return is GraphML format","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"goal","description":"Selection goal","required":false,"dataType":"string","allowableValues":{"values":["content","similar","basic-form"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Returns a graph response for the supplied terms","responseTypeInternal":"com.wordnik.graph.route.RouteResponse","errorResponses":[{"reason":"Invalid query.","code":400},{"reason":"No data found.","code":404}],"nickname":"getWordById","responseClass":"graph","httpMethod":"GET"}]},{"path":"/system.{format}/audioRecordId","description":"","operations":[{"summary":"Gets an Audio File ID for recording.","responseTypeInternal":"com.wordnik.system.model.LongResult","nickname":"getAudioRecordId","responseClass":"long","httpMethod":"GET"}]},{"path":"/system.{format}/audioDuration","description":"","operations":[{"parameters":[{"name":"audioFileId","description":"Audio file id","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"duration","description":"Audio duration","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Sets duration of an Audio File","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid audio file id supplied.","code":400}],"nickname":"setAudioDuration","responseClass":"ok","httpMethod":"POST"}]},{"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.","responseTypeInternal":"com.wordnik.system.model.SystemStats","nickname":"getStats","responseClass":"List[wordStats]","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/api_docs/tag.json

@@ -1 +1 @@
-{"resourcePath":"/tag","models":{"WordObject":{"properties":{"word":{"type":"string"},"vulgar":{"type":"string"}},"id":"wordObject"}},"apis":[{"path":"/tag.{format}/{tag}/word","description":"","operations":[{"parameters":[{"name":"tag","description":"Tag to fetch words for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"userName","description":"Username to restrict results to","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches Words with a specific Tag.","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"Invalid Tag supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getWordsTagged","responseClass":"List[wordObject]","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1","apiVersion":"4.0"}
+{"resourcePath":"/tag","models":{"WordObject":{"properties":{"word":{"type":"string"},"vulgar":{"type":"string"}},"id":"wordObject"}},"apis":[{"path":"/tag.{format}/{tag}/word","description":"","operations":[{"parameters":[{"name":"tag","description":"Tag to fetch words for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"userName","description":"Username to restrict results to","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches Words with a specific Tag.","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"Invalid Tag supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getWordsTagged","responseClass":"List[wordObject]","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/api_docs/user.json

@@ -1 +1 @@
-{"resourcePath":"/user","models":{"SubscriptionStatus":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"SubscriptionStatus"},"AudioObject":{"properties":{"recordId":{"type":"string"},"wordId":{"type":"long"},"audioFileType":{"type":"audioType"},"filePath":{"type":"string"},"type":{"type":"audioType"},"id":{"type":"long"},"duration":{"type":"double"},"createdBy":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"Date"},"userId":{"type":"long"},"streamPath":{"type":"string"},"audioFileId":{"type":"long"},"wordstring":{"type":"string"}},"id":"audioObject"},"User":{"properties":{"id":{"type":"long"},"username":{"type":"string"},"email":{"type":"string"},"status":{"type":"int"},"faceBookId":{"type":"string"},"userName":{"type":"string"},"displayName":{"type":"string"},"password":{"type":"string"}},"id":"user"},"AudioType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"audioType"},"Principal":{"properties":{"id":{"type":"long"},"token":{"type":"string"},"wordnikUserId":{"type":"long"},"type":{"type":"int"}},"id":"Principal"},"UserHandle":{"properties":{"webService":{"type":"int"},"handle":{"type":"string"}},"id":"UserHandle"},"WordOfTheDayList":{"properties":{"subscriptionNamespace":{"type":"string"},"subscriberCount":{"type":"int"},"commentCount":{"type":"int"},"subscriptionIdentifier":{"type":"string"},"firstItemDate":{"type":"Date"},"voteCount":{"type":"integer"},"id":{"type":"string","required":true},"category":{"type":"string"},"createdBy":{"type":"string"},"items":{"type":"array","items":{"$ref":"WordOfTheDay"}},"description":{"type":"string"},"createdAt":{"type":"Date"},"name":{"type":"string"},"voteWeightedAverage":{"type":"float"},"subscriptionSchedule":{"type":"string"},"lastItemDate":{"type":"Date"},"voteAverage":{"type":"float"},"itemCount":{"type":"int"},"subscriptionStatus":{"type":"string"}},"id":"wordOfTheDayList"},"WordOfTheDay":{"properties":{"id":{"type":"long","required":true},"parentId":{"type":"string"},"category":{"type":"string"},"definition":{"type":"array","items":{"$ref":"SimpleDefinition"}},"createdBy":{"type":"string"},"createdAt":{"type":"Date"},"contentProvider":{"type":"contentProvider"},"htmlExtra":{"type":"string"},"word":{"type":"string"},"example":{"type":"array","items":{"$ref":"SimpleExample"}},"note":{"type":"string"},"publishDate":{"type":"Date"}},"id":"WordOfTheDay"},"UserTagHistory":{"properties":{"id":{"type":"long"},"wordId":{"type":"long"},"tagDate":{"type":"Date"},"tag":{"type":"string"},"userId":{"type":"long"},"tagId":{"type":"long"},"wordstring":{"type":"string"}},"id":"userTagHistory"},"WordObject":{"properties":{"word":{"type":"string"},"vulgar":{"type":"string"}},"id":"wordObject"},"RecentLookup":{"properties":{"createdAt":{"type":"Date"},"wordstring":{"type":"string"}},"id":"recentLookup"},"UgcSummary":{"properties":{"ugcEvents":{"type":"Map[string,Date]"},"ugcLabels":{"type":"Map[string,string]"},"userId":{"type":"long"},"ugcCounters":{"type":"Map[string,long]"}},"id":"UgcSummary"},"SimpleDefinition":{"properties":{"text":{"type":"string"},"source":{"type":"string"},"note":{"type":"string"},"partOfSpeech":{"type":"string"}},"id":"SimpleDefinition"},"Tag":{"properties":{"id":{"type":"long"},"count":{"type":"long"},"name":{"type":"string"}},"id":"tag"},"UserTrackingInfo":{"properties":{"signupDate":{"type":"Date"},"lastLoginDate":{"type":"Date"},"noOfLogins":{"type":"int"},"userId":{"type":"long"},"lastUpdatedDate":{"type":"Date"},"signupIPAddress":{"type":"string"}},"id":"UserTrackingInfo"},"Long":{"properties":{"value":{"type":"long"}},"id":"long"},"SubscriptionType":{"properties":{"items":{"type":"array","items":{"$ref":"SubscriptionItem"}},"name":{"type":"string"}},"id":"SubscriptionType"},"WordList":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"username":{"type":"string"},"permalink":{"type":"string"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"numberWordsInList":{"type":"long"},"type":{"type":"string"}},"id":"wordList"},"UserSettings":{"properties":{"notifyComments":{"type":"boolean"},"bossURL":{"type":"string"},"enableActivityFeed":{"type":"boolean"},"userId":{"type":"long"},"publicLookupHistory":{"type":"boolean"},"showImages":{"type":"boolean"},"notifyGeneralNews":{"type":"boolean"},"notifyWordOfTheDay":{"type":"boolean"},"showLookupHistory":{"type":"boolean"}},"id":"UserSettings"},"Comment":{"properties":{"id":{"type":"string"},"updatedAt":{"type":"Date"},"body":{"type":"string"},"approved":{"type":"boolean"},"disemvoweled":{"type":"boolean"},"commentedOn":{"type":"string"},"createdAt":{"type":"Date"},"objectId":{"type":"long"},"commentedBy":{"type":"string"},"objectType":{"type":"string"}},"id":"comment"},"SubscriptionItem":{"properties":{"createdAt":{"type":"Date"},"name":{"type":"string"},"medium":{"type":"string"}},"id":"SubscriptionItem"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"},"UserProfile":{"properties":{"publicProfile":{"type":"boolean"},"lastName":{"type":"string"},"mostFavoriteWord":{"type":"string"},"location":{"type":"string"},"seekingWord":{"type":"string"},"leastFavoriteWord":{"type":"string"},"onomaTopoeiaWord":{"type":"string"},"siteUrl":{"type":"string"},"bio":{"type":"string"},"userHandles":{"type":"array","items":{"$ref":"UserHandle"}},"userId":{"type":"long"},"youWord":{"type":"string"},"firstName":{"type":"string"},"siteName":{"type":"string"}},"id":"UserProfile"},"SimpleExample":{"properties":{"id":{"type":"long"},"title":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"}},"id":"SimpleExample"},"PartOfSpeech":{"properties":{"roots":{"type":"array","items":{"$ref":"root"}}},"id":"partOfSpeech"}},"apis":[{"path":"/user.{format}/{username}/wordOfTheDayList","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeAll","description":"Include future words (owner-only)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns a user's WordOfTheDayList","responseTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"No WordOfTheDayList available","code":404}],"nickname":"getWordOfTheDayList","responseClass":"wordOfTheDayList","httpMethod":"GET"},{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"WordOfTheDayList to create, provided in the format specified by the URL","required":true,"dataType":"wordOfTheDayList","valueTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","allowMultiple":false,"paramType":"body"}],"summary":"Creates a WordOfTheDayList","responseTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","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.","httpMethod":"POST"},{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated WordOfTheDayList data in the format specified by the URL","required":true,"dataType":"wordOfTheDayList","valueTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","allowMultiple":false,"paramType":"body"}],"summary":"Updates a user's WordOfTheDayList","responseTypeInternal":"ok","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","httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/wordOfTheDayList/{permalink}","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"permalink","description":"Permalink of WordOfTheDayList to delete","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Deletes a user's WordOfTheDayList","responseTypeInternal":"ok","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","httpMethod":"DELETE"},{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"permalink","description":"Permalink of the WordOfTheDayList to add the WordOfTheDay to","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"WordOfTheDay to add, in the format specified by the URL","required":true,"dataType":"WordOfTheDay","valueTypeInternal":"com.wordnik.community.entity.WordOfTheDay","allowMultiple":false,"paramType":"body"}],"summary":"Adds a WordOfTheDay to a user's WordOfTheDayList","responseTypeInternal":"ok","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","httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/profile","description":"","operations":[{"parameters":[{"name":"username","description":"Username or email to fetch UserProfile object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns a UserProfile","responseTypeInternal":"com.wordnik.system.user.entity.UserProfile","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getUserProfile","responseClass":"UserProfile","httpMethod":"GET"},{"parameters":[{"name":"username","description":"Username or email to update UserProfile object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated UserProfile.","required":false,"dataType":"UserProfile","valueTypeInternal":"com.wordnik.system.user.entity.UserProfile","allowMultiple":false,"paramType":"body"}],"summary":"Updates a UserProfile","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"updateUserProfile","responseClass":"ok","httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/trackingInfo","description":"","operations":[{"parameters":[{"name":"username","description":"Username or email to get UserTrackingInfo","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns a user's tracking info","responseTypeInternal":"com.wordnik.system.user.entity.UserTrackingInfo","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getUserTrackingInfo","responseClass":"UserTrackingInfo","httpMethod":"GET"}]},{"path":"/user.{format}/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"Username or email to update User object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated User object.","required":false,"dataType":"user","valueTypeInternal":"com.wordnik.system.user.entity.User","allowMultiple":false,"paramType":"body"}],"summary":"Updates a User","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid username supplied or username/email already in use.","code":400},{"reason":"User not found","code":404}],"nickname":"updateUser","responseClass":"ok","httpMethod":"PUT"},{"parameters":[{"name":"username","description":"Username or email to fetch User object for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches a User by username or email address","responseTypeInternal":"com.wordnik.system.user.entity.User","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found","code":404}],"nickname":"getUser","responseClass":"user","httpMethod":"GET"},{"parameters":[{"name":"username","description":"Username or email to delete User object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Deletes a User","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid username supplied or username/email already in use.","code":400},{"reason":"User not found","code":404}],"nickname":"deleteUser","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/user.{format}/{username}/wordOfTheDayList/{permalink}/add","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"permalink","description":"WordOfTheDayList to modify","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"WordOfTheDay to add","required":true,"dataType":"WordOfTheDay","valueTypeInternal":"com.wordnik.community.entity.WordOfTheDay","allowMultiple":false,"paramType":"body"}],"summary":"Adds an item to a user's WordOfTheDayList","responseTypeInternal":"ok","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","httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/wordOfTheDayList/{permalink}/{wordToDelete}","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"permalink","description":"Permalink of WordOfTheDayList to delete a word from","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"wordToDelete","description":"Word to delete","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Deletes a specific word from a user's WordOfTheDayList","responseTypeInternal":"ok","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","httpMethod":"DELETE"}]},{"path":"/user.{format}/{username}/wordOfTheDay/{date}","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDay owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"date","description":"Date of the WordOfTheDay to retrieve (yyyy-MM-dd) format","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeAll","description":"Include WordOfTheDay items for future dates (owner-only)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns the WordOfTheDay for a given user on a given date","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","errorResponses":[{"reason":"Invalid username or dateString supplied","code":400},{"reason":"User not found or no list available","code":404}],"nickname":"getWordOfTheDayByDate","responseClass":"WordOfTheDay","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/wordLists","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch WordLists for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sortBy","defaultValue":"createDate","description":"Field to sort by","required":false,"dataType":"string","allowableValues":{"values":["alpha","createDate","editDate"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","defaultValue":"desc","description":"Direction to sort","required":false,"dataType":"string","allowableValues":{"values":["asc","desc"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Gets WordLists for a User.","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found","code":404}],"nickname":"getUserWordLists","responseClass":"List[wordList]","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/wordListsCount","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch WordLists for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Gets the count of WordLists for a User.","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found","code":404}],"nickname":"getUserWordListCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/settings","description":"","operations":[{"parameters":[{"name":"username","description":"Username or email to fetch UserSettings object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns a user's settings","responseTypeInternal":"com.wordnik.system.user.entity.UserSettings","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getUserSettings","responseClass":"UserSettings","httpMethod":"GET"},{"parameters":[{"name":"username","description":"Username or email to update UserSettings object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated UserSettings.","required":false,"dataType":"UserSettings","valueTypeInternal":"com.wordnik.system.user.entity.UserSettings","allowMultiple":false,"paramType":"body"}],"summary":"Updates a user's settings","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"updateUserSettings","responseClass":"ok","httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/apiKey","description":"","operations":[{"parameters":[{"name":"username","description":"Username or email to fetch API Key for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns the API key for the specified user","responseTypeInternal":"com.wordnik.security.entity.Principal","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","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/comment","description":"","operations":[{"parameters":[{"name":"username","description":"Username to comment on.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Comment to save.","required":false,"dataType":"comment","valueTypeInternal":"com.wordnik.community.entity.Comment","allowMultiple":false,"paramType":"body"}],"summary":"Adds a Comment on a User","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"commentOnUser","responseClass":"comment","httpMethod":"POST"},{"parameters":[{"name":"username","description":"Username with Comment.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated Comment.","required":false,"dataType":"comment","valueTypeInternal":"com.wordnik.community.entity.Comment","allowMultiple":false,"paramType":"body"}],"summary":"Updates a Comment on a User","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"updateCommentOnUser","responseClass":"comment","httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/comment/{commentId}","description":"","operations":[{"parameters":[{"name":"username","description":"Username with Comment.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Updated Comment.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Deletes a Comment on a User","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"deleteCommentOnUser","responseClass":"ok","httpMethod":"DELETE"},{"parameters":[{"name":"username","description":"Username with Comment.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Comment ID.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches a comment by ID","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentOnUserById","responseClass":"comment","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/commentsOnCount","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns a count of Comments on a user","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentsOnUserCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/commentsByCount","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count by.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns a count of Comments by a user","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentsByUserCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/commentsBy","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count by.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort order","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns Comments by a user","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentsByUser","responseClass":"List[comment]","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/commentsOnUser","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count by.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort order","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns Comments on a user","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentsOnUser","responseClass":"List[comment]","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/ugcSummary","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get statistics for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort order","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns UgcSummary info a user","responseTypeInternal":"com.wordnik.community.entity.UgcSummaryStats","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getUgcSummaryForUser","responseClass":"UgcSummary","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/tagHistory","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch History for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches TagHistory for a User.","responseTypeInternal":"com.wordnik.community.entity.UserTagHistory","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserTagHistory","responseClass":"List[userTagHistory]","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/tags","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Tags for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches Tags by a User.","responseTypeInternal":"com.wordnik.community.entity.Tag","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserTags","responseClass":"List[tag]","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/tagCount","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Tag count for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches the count of Tags created by a User.","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"getUserTagCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/subscriptions","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch subscriptions for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches all subscriptions for a User.","responseTypeInternal":"com.wordnik.corpus.updated.model.SubscriptionType","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]","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/subscriptions/{objectType}/{objectIdentifier}","description":"","operations":[{"parameters":[{"name":"user","description":"User to add subscriptions to","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"objectType","description":"Object Type","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"objectIdentifier","description":"Object Identifier","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"medium","description":"Subscription medium","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Subscribes to an object.","responseTypeInternal":"ok","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","httpMethod":"POST"},{"parameters":[{"name":"user","description":"User to add subscriptions to","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"objectType","description":"Object Type","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"objectIdentifier","description":"Object Identifier","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"medium","description":"Subscription medium","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Deletes a subscription to an object.","responseTypeInternal":"ok","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","httpMethod":"DELETE"}]},{"path":"/user.{format}/{user}/favorites/words","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite Words for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches Favorite Words for a user.","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserFavoriteWords","responseClass":"List[wordObject]","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/favorites/wordCount","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite Words for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches favorite word count for a user.","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserFavoriteCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/favorites/wordLists","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite WordLists for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"access","description":"Filters results by access","required":false,"dataType":"string","allowableValues":{"values":["public","private"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Fetches Favorite WordLists for a user.","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserFavoriteWordLists","responseClass":"List[wordList]","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/favorites/wordListCount","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite WordList count for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches Favorite WordList count for a user.","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserFavoriteWordListsCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/searches","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch History for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches SearchHistory for a User.","responseTypeInternal":"com.wordnik.community.entity.UserWordLookupHistoryItem","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserSearchHistory","responseClass":"List[recentLookup]","httpMethod":"GET"},{"parameters":[{"name":"user","description":"User to remove search history for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"word","description":"Word to delete","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches SearchHistory for a User.","responseTypeInternal":"com.wordnik.community.entity.UserWordLookupHistoryItem","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"removeUserSearchHistoryItem","responseClass":"List[recentLookup]","httpMethod":"DELETE"}]},{"path":"/user.{format}/{user}/totalSearches","description":"","operations":[{"parameters":[{"name":"user","description":"User to retrieve search count for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches the total search count for a User.","responseTypeInternal":"Long","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"getUserSearchHistoryCount","responseClass":"Long","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/pronunciations","description":"","operations":[{"parameters":[{"name":"user","description":"User to retrieve search count for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches the total search count for a User.","responseTypeInternal":"com.wordnik.community.entity.AudioPron","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"getUserPronunciations","responseClass":"List[audioObject]","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/activitystream","description":"","operations":[{"parameters":[{"name":"user","description":"User to retrieve search count for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches the total search count for a User.","responseTypeInternal":"Long","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"getUserActivityStream","responseClass":"Long","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1","apiVersion":"4.0"}
+{"resourcePath":"/user","models":{"User":{"properties":{"id":{"type":"long"},"username":{"type":"string"},"email":{"type":"string"},"status":{"type":"int"},"faceBookId":{"type":"string"},"userName":{"type":"string"},"displayName":{"type":"string"},"password":{"type":"string"}},"id":"user"},"SubscriptionStatus":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"SubscriptionStatus"},"AudioObject":{"properties":{"recordId":{"type":"string"},"wordId":{"type":"long"},"audioFileType":{"type":"audioType"},"filePath":{"type":"string"},"type":{"type":"audioType"},"id":{"type":"long"},"duration":{"type":"double"},"createdBy":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"Date"},"userId":{"type":"long"},"streamPath":{"type":"string"},"audioFileId":{"type":"long"},"wordstring":{"type":"string"}},"id":"audioObject"},"AudioType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"audioType"},"Principal":{"properties":{"id":{"type":"long"},"token":{"type":"string"},"wordnikUserId":{"type":"long"},"type":{"type":"int"}},"id":"Principal"},"UserHandle":{"properties":{"webService":{"type":"int"},"handle":{"type":"string"}},"id":"UserHandle"},"WordOfTheDayList":{"properties":{"subscriptionNamespace":{"type":"string"},"subscriberCount":{"type":"int"},"creatorId":{"type":"long"},"commentCount":{"type":"int"},"subscriptionIdentifier":{"type":"string"},"firstItemDate":{"type":"Date"},"voteCount":{"type":"integer"},"id":{"type":"string"},"category":{"type":"string"},"createdBy":{"type":"string"},"items":{"type":"array","items":{"$ref":"WordOfTheDay"}},"description":{"type":"string"},"createdAt":{"type":"Date"},"voteWeightedAverage":{"type":"float"},"name":{"type":"string"},"subscriptionSchedule":{"type":"string"},"lastItemDate":{"type":"Date"},"voteAverage":{"type":"float"},"itemCount":{"type":"int"},"subscriptionStatus":{"type":"string"}},"id":"wordOfTheDayList"},"WordOfTheDay":{"properties":{"creatorId":{"type":"long"},"htmlExtra":{"type":"string"},"definitions":{"type":"array","items":{"$ref":"definition"}},"id":{"type":"long"},"parentId":{"type":"string"},"category":{"type":"string"},"createdBy":{"type":"string"},"createdAt":{"type":"Date"},"contentProvider":{"type":"contentProvider"},"word":{"type":"string"},"examples":{"type":"array","items":{"$ref":"example"}},"publishDate":{"type":"Date"},"note":{"type":"string"}},"id":"WordOfTheDay"},"UserTagHistory":{"properties":{"id":{"type":"long"},"wordId":{"type":"long"},"tagDate":{"type":"Date"},"tag":{"type":"string"},"userId":{"type":"long"},"tagId":{"type":"long"},"wordstring":{"type":"string"}},"id":"userTagHistory"},"WordObject":{"properties":{"word":{"type":"string"},"vulgar":{"type":"string"}},"id":"wordObject"},"RecentLookup":{"properties":{"createdAt":{"type":"Date"},"wordstring":{"type":"string"}},"id":"recentLookup"},"Example":{"properties":{"id":{"type":"long"},"title":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"}},"id":"example"},"UgcSummary":{"properties":{"ugcEvents":{"type":"Map[string,Date]"},"ugcLabels":{"type":"Map[string,string]"},"userId":{"type":"long"},"ugcCounters":{"type":"Map[string,long]"}},"id":"UgcSummary"},"Tag":{"properties":{"id":{"type":"long"},"count":{"type":"long"},"name":{"type":"string"}},"id":"tag"},"UserTrackingInfo":{"properties":{"signupDate":{"type":"Date"},"lastLoginDate":{"type":"Date"},"noOfLogins":{"type":"int"},"userId":{"type":"long"},"lastUpdatedDate":{"type":"Date"},"signupIPAddress":{"type":"string"}},"id":"UserTrackingInfo"},"Long":{"properties":{"value":{"type":"long"}},"id":"long"},"SubscriptionType":{"properties":{"items":{"type":"array","items":{"$ref":"SubscriptionItem"}},"name":{"type":"string"}},"id":"SubscriptionType"},"WordList":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"username":{"type":"string"},"permalink":{"type":"string"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"numberWordsInList":{"type":"long"},"type":{"type":"string"}},"id":"wordList"},"UserSettings":{"properties":{"notifyComments":{"type":"boolean"},"bossURL":{"type":"string"},"enableActivityFeed":{"type":"boolean"},"userId":{"type":"long"},"publicLookupHistory":{"type":"boolean"},"showImages":{"type":"boolean"},"notifyGeneralNews":{"type":"boolean"},"notifyWordOfTheDay":{"type":"boolean"},"showLookupHistory":{"type":"boolean"}},"id":"UserSettings"},"Comment":{"properties":{"id":{"type":"string"},"updatedAt":{"type":"Date"},"body":{"type":"string"},"approved":{"type":"boolean"},"disemvoweled":{"type":"boolean"},"commentedOn":{"type":"string"},"createdAt":{"type":"Date"},"objectId":{"type":"long"},"commentedBy":{"type":"string"},"objectType":{"type":"string"}},"id":"comment"},"Category":{"properties":{"name":{"type":"string"}},"id":"category"},"SubscriptionItem":{"properties":{"createdAt":{"type":"Date"},"name":{"type":"string"},"medium":{"type":"string"}},"id":"SubscriptionItem"},"Root":{"properties":{"name":{"type":"string"},"categories":{"type":"array","items":{"$ref":"category"}}},"id":"root"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"},"UserProfile":{"properties":{"publicProfile":{"type":"boolean"},"lastName":{"type":"string"},"mostFavoriteWord":{"type":"string"},"location":{"type":"string"},"seekingWord":{"type":"string"},"leastFavoriteWord":{"type":"string"},"onomaTopoeiaWord":{"type":"string"},"siteUrl":{"type":"string"},"bio":{"type":"string"},"userHandles":{"type":"array","items":{"$ref":"UserHandle"}},"userId":{"type":"long"},"youWord":{"type":"string"},"firstName":{"type":"string"},"siteName":{"type":"string"}},"id":"UserProfile"},"Definition":{"properties":{"text":{"type":"string"},"source":{"type":"string"},"note":{"type":"string"},"partOfSpeech":{"type":"string"}},"id":"definition"},"PartOfSpeech":{"properties":{"roots":{"type":"array","items":{"$ref":"root"}}},"id":"partOfSpeech"}},"apis":[{"path":"/user.{format}/{username}/wordOfTheDayList","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeAll","description":"Include future words (owner-only)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns a user's WordOfTheDayList","responseTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"No WordOfTheDayList available","code":404}],"nickname":"getWordOfTheDayList","responseClass":"wordOfTheDayList","httpMethod":"GET"},{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"WordOfTheDayList to create, provided in the format specified by the URL","required":true,"dataType":"wordOfTheDayList","valueTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","allowMultiple":false,"paramType":"body"}],"summary":"Creates a WordOfTheDayList","responseTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","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.","httpMethod":"POST"},{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated WordOfTheDayList data in the format specified by the URL","required":true,"dataType":"wordOfTheDayList","valueTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","allowMultiple":false,"paramType":"body"}],"summary":"Updates a user's WordOfTheDayList","responseTypeInternal":"ok","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","httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/wordOfTheDayList/{permalink}","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"permalink","description":"Permalink of WordOfTheDayList to delete","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Deletes a user's WordOfTheDayList","responseTypeInternal":"ok","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","httpMethod":"DELETE"},{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"permalink","description":"Permalink of the WordOfTheDayList to add the WordOfTheDay to","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"WordOfTheDay to add, in the format specified by the URL","required":true,"dataType":"WordOfTheDay","valueTypeInternal":"com.wordnik.community.entity.WordOfTheDay","allowMultiple":false,"paramType":"body"}],"summary":"Adds a WordOfTheDay to a user's WordOfTheDayList","responseTypeInternal":"ok","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","httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/profile","description":"","operations":[{"parameters":[{"name":"username","description":"Username or email to fetch UserProfile object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns a UserProfile","responseTypeInternal":"com.wordnik.system.user.entity.UserProfile","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getUserProfile","responseClass":"UserProfile","httpMethod":"GET"},{"parameters":[{"name":"username","description":"Username or email to update UserProfile object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated UserProfile.","required":false,"dataType":"UserProfile","valueTypeInternal":"com.wordnik.system.user.entity.UserProfile","allowMultiple":false,"paramType":"body"}],"summary":"Updates a UserProfile","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"updateUserProfile","responseClass":"ok","httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/trackingInfo","description":"","operations":[{"parameters":[{"name":"username","description":"Username or email to get UserTrackingInfo","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns a user's tracking info","responseTypeInternal":"com.wordnik.system.user.entity.UserTrackingInfo","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getUserTrackingInfo","responseClass":"UserTrackingInfo","httpMethod":"GET"}]},{"path":"/user.{format}/{username}","description":"","operations":[{"parameters":[{"name":"username","description":"Username or email to update User object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated User object.","required":false,"dataType":"user","valueTypeInternal":"com.wordnik.system.user.entity.User","allowMultiple":false,"paramType":"body"}],"summary":"Updates a User","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid username supplied or username/email already in use.","code":400},{"reason":"User not found","code":404}],"nickname":"updateUser","responseClass":"ok","httpMethod":"PUT"},{"parameters":[{"name":"username","description":"Username or email to fetch User object for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches a User by username or email address","responseTypeInternal":"com.wordnik.system.user.entity.User","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found","code":404}],"nickname":"getUser","responseClass":"user","httpMethod":"GET"},{"parameters":[{"name":"username","description":"Username or email to delete User object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Deletes a User","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid username supplied or username/email already in use.","code":400},{"reason":"User not found","code":404}],"nickname":"deleteUser","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/user.{format}/{username}/wordOfTheDayList/{permalink}/add","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"permalink","description":"WordOfTheDayList to modify","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"WordOfTheDay to add","required":true,"dataType":"WordOfTheDay","valueTypeInternal":"com.wordnik.community.entity.WordOfTheDay","allowMultiple":false,"paramType":"body"}],"summary":"Adds an item to a user's WordOfTheDayList","responseTypeInternal":"ok","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","httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/wordOfTheDayList/{permalink}/{wordToDelete}","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDayList owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"permalink","description":"Permalink of WordOfTheDayList to delete a word from","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"wordToDelete","description":"Word to delete","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Deletes a specific word from a user's WordOfTheDayList","responseTypeInternal":"ok","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","httpMethod":"DELETE"}]},{"path":"/user.{format}/{username}/wordOfTheDay/{date}","description":"","operations":[{"parameters":[{"name":"username","description":"Username of the WordOfTheDay owner","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"date","description":"Date of the WordOfTheDay to retrieve (yyyy-MM-dd) format","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeAll","description":"Include WordOfTheDay items for future dates (owner-only)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns the WordOfTheDay for a given user on a given date","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","errorResponses":[{"reason":"Invalid username or dateString supplied","code":400},{"reason":"User not found or no list available","code":404}],"nickname":"getWordOfTheDayByDate","responseClass":"WordOfTheDay","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/wordLists","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch WordLists for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sortBy","defaultValue":"createDate","description":"Field to sort by","required":false,"dataType":"string","allowableValues":{"values":["alpha","createDate","editDate"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","defaultValue":"desc","description":"Direction to sort","required":false,"dataType":"string","allowableValues":{"values":["asc","desc"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Gets WordLists for a User.","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found","code":404}],"nickname":"getUserWordLists","responseClass":"List[wordList]","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/wordListsCount","description":"","operations":[{"parameters":[{"name":"username","description":"Username to fetch WordLists for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Gets the count of WordLists for a User.","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found","code":404}],"nickname":"getUserWordListCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/settings","description":"","operations":[{"parameters":[{"name":"username","description":"Username or email to fetch UserSettings object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns a user's settings","responseTypeInternal":"com.wordnik.system.user.entity.UserSettings","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getUserSettings","responseClass":"UserSettings","httpMethod":"GET"},{"parameters":[{"name":"username","description":"Username or email to update UserSettings object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated UserSettings.","required":false,"dataType":"UserSettings","valueTypeInternal":"com.wordnik.system.user.entity.UserSettings","allowMultiple":false,"paramType":"body"}],"summary":"Updates a user's settings","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"updateUserSettings","responseClass":"ok","httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/apiKey","description":"","operations":[{"parameters":[{"name":"username","description":"Username or email to fetch API Key for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns the API key for the specified user","responseTypeInternal":"com.wordnik.security.entity.Principal","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","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/comment","description":"","operations":[{"parameters":[{"name":"username","description":"Username to comment on.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Comment to save.","required":false,"dataType":"comment","valueTypeInternal":"com.wordnik.community.entity.Comment","allowMultiple":false,"paramType":"body"}],"summary":"Adds a Comment on a User","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"commentOnUser","responseClass":"comment","httpMethod":"POST"},{"parameters":[{"name":"username","description":"Username with Comment.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated Comment.","required":false,"dataType":"comment","valueTypeInternal":"com.wordnik.community.entity.Comment","allowMultiple":false,"paramType":"body"}],"summary":"Updates a Comment on a User","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"updateCommentOnUser","responseClass":"comment","httpMethod":"PUT"}]},{"path":"/user.{format}/{username}/comment/{commentId}","description":"","operations":[{"parameters":[{"name":"username","description":"Username with Comment.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Updated Comment.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Deletes a Comment on a User","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"deleteCommentOnUser","responseClass":"ok","httpMethod":"DELETE"},{"parameters":[{"name":"username","description":"Username with Comment.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Comment ID.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches a comment by ID","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentOnUserById","responseClass":"comment","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/commentsOnCount","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns a count of Comments on a user","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentsOnUserCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/commentsByCount","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count by.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns a count of Comments by a user","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentsByUserCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/commentsBy","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count by.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sortOrder","defaultValue":"created_at","description":"Sort order","required":false,"dataType":"string","allowableValues":{"values":["created_at"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Returns Comments by a user","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentsByUser","responseClass":"List[comment]","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/commentsOnUser","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get count by.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort order","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns Comments on a user","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getCommentsOnUser","responseClass":"List[comment]","httpMethod":"GET"}]},{"path":"/user.{format}/{username}/ugcSummary","description":"","operations":[{"parameters":[{"name":"username","description":"Username to get statistics for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort order","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns UgcSummary info a user","responseTypeInternal":"com.wordnik.community.entity.UgcSummaryStats","errorResponses":[{"reason":"Invalid username supplied","code":400},{"reason":"User not found","code":404}],"nickname":"getUgcSummaryForUser","responseClass":"UgcSummary","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/tagHistory","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch History for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches TagHistory for a User.","responseTypeInternal":"com.wordnik.community.entity.UserTagHistory","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserTagHistory","responseClass":"List[userTagHistory]","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/tags","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Tags for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches Tags by a User.","responseTypeInternal":"com.wordnik.community.entity.Tag","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserTags","responseClass":"List[tag]","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/tagCount","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Tag count for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches the count of Tags created by a User.","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"getUserTagCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/subscriptions","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch subscriptions for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches all subscriptions for a User.","responseTypeInternal":"com.wordnik.corpus.updated.model.SubscriptionType","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]","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/subscriptions/{objectType}/{objectIdentifier}","description":"","operations":[{"parameters":[{"name":"user","description":"User to add subscriptions to","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"objectType","description":"Object Type","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"objectIdentifier","description":"Object Identifier","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"medium","description":"Subscription medium","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Subscribes to an object.","responseTypeInternal":"ok","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","httpMethod":"POST"},{"parameters":[{"name":"user","description":"User to add subscriptions to","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"objectType","description":"Object Type","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"objectIdentifier","description":"Object Identifier","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"medium","description":"Subscription medium","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Deletes a subscription to an object.","responseTypeInternal":"ok","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","httpMethod":"DELETE"}]},{"path":"/user.{format}/{user}/favorites/words","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite Words for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches Favorite Words for a user.","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserFavoriteWords","responseClass":"List[wordObject]","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/favorites/wordCount","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite Words for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches favorite word count for a user.","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserFavoriteCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/favorites/wordLists","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite WordLists for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"access","description":"Filters results by access","required":false,"dataType":"string","allowableValues":{"values":["public","private"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Fetches Favorite WordLists for a user.","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserFavoriteWordLists","responseClass":"List[wordList]","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/favorites/wordListCount","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch Favorite WordList count for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches Favorite WordList count for a user.","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserFavoriteWordListsCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/searches","description":"","operations":[{"parameters":[{"name":"user","description":"User to fetch History for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches SearchHistory for a User.","responseTypeInternal":"com.wordnik.community.entity.UserWordLookupHistoryItem","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found to filter by.","code":404}],"nickname":"getUserSearchHistory","responseClass":"List[recentLookup]","httpMethod":"GET"},{"parameters":[{"name":"user","description":"User to remove search history for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"word","description":"Word to delete","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches SearchHistory for a User.","responseTypeInternal":"com.wordnik.community.entity.UserWordLookupHistoryItem","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"removeUserSearchHistoryItem","responseClass":"List[recentLookup]","httpMethod":"DELETE"}]},{"path":"/user.{format}/{user}/totalSearches","description":"","operations":[{"parameters":[{"name":"user","description":"User to retrieve search count for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches the total search count for a User.","responseTypeInternal":"Long","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"getUserSearchHistoryCount","responseClass":"Long","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/pronunciations","description":"","operations":[{"parameters":[{"name":"user","description":"User to retrieve search count for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches the total search count for a User.","responseTypeInternal":"com.wordnik.community.entity.AudioPron","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"getUserPronunciations","responseClass":"List[audioObject]","httpMethod":"GET"}]},{"path":"/user.{format}/{user}/activitystream","description":"","operations":[{"parameters":[{"name":"user","description":"User to retrieve search count for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches the total search count for a User.","responseTypeInternal":"Long","errorResponses":[{"reason":"Invalid username supplied.","code":400},{"reason":"User not found.","code":404}],"nickname":"getUserActivityStream","responseClass":"Long","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/api_docs/users.json

@@ -1 +1 @@
-{"resourcePath":"/users","models":{"User":{"properties":{"id":{"type":"long"},"username":{"type":"string"},"email":{"type":"string"},"status":{"type":"int"},"faceBookId":{"type":"string"},"userName":{"type":"string"},"displayName":{"type":"string"},"password":{"type":"string"}},"id":"user"},"AudioObject":{"properties":{"recordId":{"type":"string"},"wordId":{"type":"long"},"audioFileType":{"type":"audioType"},"filePath":{"type":"string"},"type":{"type":"audioType"},"id":{"type":"long"},"duration":{"type":"double"},"createdBy":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"Date"},"userId":{"type":"long"},"streamPath":{"type":"string"},"audioFileId":{"type":"long"},"wordstring":{"type":"string"}},"id":"audioObject"},"AudioType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"audioType"},"UserSummary":{"properties":{"totalListedWordsCount":{"type":"long"},"userId":{"type":"long"},"userName":{"type":"string"}},"id":"UserSummary"},"Comment":{"properties":{"id":{"type":"string"},"updatedAt":{"type":"Date"},"body":{"type":"string"},"approved":{"type":"boolean"},"disemvoweled":{"type":"boolean"},"commentedOn":{"type":"string"},"createdAt":{"type":"Date"},"objectId":{"type":"long"},"commentedBy":{"type":"string"},"objectType":{"type":"string"}},"id":"comment"},"WordObject":{"properties":{"word":{"type":"string"},"vulgar":{"type":"string"}},"id":"wordObject"}},"apis":[{"path":"/users.{format}/pronunciations","description":"","operations":[{"parameters":[{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches recent AudioPron objects","responseTypeInternal":"com.wordnik.community.entity.AudioPron","nickname":"getRecentPronunciations","responseClass":"List[audioObject]","httpMethod":"GET"}]},{"path":"/users.{format}/id/{id}","description":"","operations":[{"parameters":[{"name":"id","description":"User ID to filter by","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches a User by ID","responseTypeInternal":"com.wordnik.system.user.entity.User","errorResponses":[{"reason":"User not found.","code":404}],"nickname":"getUserById","responseClass":"user","httpMethod":"GET"}]},{"path":"/users.{format}/facebook/{facebookId}","description":"","operations":[{"parameters":[{"name":"facebookId","description":"Facebook ID to filter by","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches a User by Facebook ID","responseTypeInternal":"com.wordnik.system.user.entity.User","errorResponses":[{"reason":"User not found.","code":404}],"nickname":"getByFacebookId","responseClass":"user","httpMethod":"GET"}]},{"path":"/users.{format}","description":"","operations":[{"parameters":[{"name":"signupIP","description":"Client IP address","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"password","description":"Password","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"description":"User to create","required":false,"dataType":"user","valueTypeInternal":"com.wordnik.system.user.entity.User","allowMultiple":false,"paramType":"body"}],"summary":"Creates a User","responseTypeInternal":"com.wordnik.system.user.entity.User","errorResponses":[{"reason":"Invalid User or User parameters supplied.","code":400}],"nickname":"createUser","responseClass":"user","httpMethod":"POST"}]},{"path":"/users.{format}/favorites","description":"","operations":[{"parameters":[{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches recent Favorite Word objects.","responseTypeInternal":"com.wordnik.corpus.entity.Word","nickname":"getRecentFavorites","responseClass":"List[wordObject]","httpMethod":"GET"}]},{"path":"/users.{format}/comments","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches recent Comment objects","responseTypeInternal":"com.wordnik.community.entity.Comment","nickname":"getRecentComments","responseClass":"List[comment]","httpMethod":"GET"}]},{"path":"/users.{format}/listedMostWords","description":"","operations":[{"parameters":[{"name":"dayInterval","description":"Interval in days to compute from","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches info on Users who listed most words","responseTypeInternal":"com.wordnik.system.user.entity.UserSummary","nickname":"getUsersWhoListedMostWords","responseClass":"List[UserSummary]","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1","apiVersion":"4.0"}
+{"resourcePath":"/users","models":{"User":{"properties":{"id":{"type":"long"},"username":{"type":"string"},"email":{"type":"string"},"status":{"type":"int"},"faceBookId":{"type":"string"},"userName":{"type":"string"},"displayName":{"type":"string"},"password":{"type":"string"}},"id":"user"},"AudioObject":{"properties":{"recordId":{"type":"string"},"wordId":{"type":"long"},"audioFileType":{"type":"audioType"},"filePath":{"type":"string"},"type":{"type":"audioType"},"id":{"type":"long"},"duration":{"type":"double"},"createdBy":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"Date"},"userId":{"type":"long"},"streamPath":{"type":"string"},"audioFileId":{"type":"long"},"wordstring":{"type":"string"}},"id":"audioObject"},"AudioType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"audioType"},"UserSummary":{"properties":{"totalListedWordsCount":{"type":"long"},"userId":{"type":"long"},"userName":{"type":"string"}},"id":"UserSummary"},"Comment":{"properties":{"id":{"type":"string"},"updatedAt":{"type":"Date"},"body":{"type":"string"},"approved":{"type":"boolean"},"disemvoweled":{"type":"boolean"},"commentedOn":{"type":"string"},"createdAt":{"type":"Date"},"objectId":{"type":"long"},"commentedBy":{"type":"string"},"objectType":{"type":"string"}},"id":"comment"},"WordObject":{"properties":{"word":{"type":"string"},"vulgar":{"type":"string"}},"id":"wordObject"}},"apis":[{"path":"/users.{format}/pronunciations","description":"","operations":[{"parameters":[{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches recent AudioPron objects","responseTypeInternal":"com.wordnik.community.entity.AudioPron","nickname":"getRecentPronunciations","responseClass":"List[audioObject]","httpMethod":"GET"}]},{"path":"/users.{format}/id/{id}","description":"","operations":[{"parameters":[{"name":"id","description":"User ID to filter by","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches a User by ID","responseTypeInternal":"com.wordnik.system.user.entity.User","errorResponses":[{"reason":"User not found.","code":404}],"nickname":"getUserById","responseClass":"user","httpMethod":"GET"}]},{"path":"/users.{format}/facebook/{facebookId}","description":"","operations":[{"parameters":[{"name":"facebookId","description":"Facebook ID to filter by","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches a User by Facebook ID","responseTypeInternal":"com.wordnik.system.user.entity.User","errorResponses":[{"reason":"User not found.","code":404}],"nickname":"getByFacebookId","responseClass":"user","httpMethod":"GET"}]},{"path":"/users.{format}","description":"","operations":[{"parameters":[{"name":"signupIP","description":"Client IP address","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"password","description":"Password","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"description":"User to create","required":false,"dataType":"user","valueTypeInternal":"com.wordnik.system.user.entity.User","allowMultiple":false,"paramType":"body"}],"summary":"Creates a User","responseTypeInternal":"com.wordnik.system.user.entity.User","errorResponses":[{"reason":"Invalid User or User parameters supplied.","code":400}],"nickname":"createUser","responseClass":"user","httpMethod":"POST"}]},{"path":"/users.{format}/favorites","description":"","operations":[{"parameters":[{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":500.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Fetches recent Favorite Word objects.","responseTypeInternal":"com.wordnik.corpus.entity.Word","nickname":"getRecentFavorites","responseClass":"List[wordObject]","httpMethod":"GET"}]},{"path":"/users.{format}/comments","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches recent Comment objects","responseTypeInternal":"com.wordnik.community.entity.Comment","nickname":"getRecentComments","responseClass":"List[comment]","httpMethod":"GET"}]},{"path":"/users.{format}/listedMostWords","description":"","operations":[{"parameters":[{"name":"dayInterval","description":"Interval in days to compute from","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches info on Users who listed most words","responseTypeInternal":"com.wordnik.system.user.entity.UserSummary","nickname":"getUsersWhoListedMostWords","responseClass":"List[UserSummary]","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/api_docs/word.json

@@ -1 +1 @@
-{"resourcePath":"/word","models":{"User":{"properties":{"id":{"type":"long"},"username":{"type":"string"},"email":{"type":"string"},"status":{"type":"int"},"faceBookId":{"type":"string"},"userName":{"type":"string"},"displayName":{"type":"string"},"password":{"type":"string"}},"id":"user"},"DocumentMetadata":{"properties":{"yearType":{"type":"yearType"},"expirationDate":{"type":"Date"},"extendedMetadata":{"type":"extendedMetadata"},"tag":{"type":"array","items":{"type":"string"}},"stats":{"type":"basicDocumentStats"},"provider":{"type":"contentProvider"},"contentType":{"type":"contentType"},"sourceUrl":{"type":"string"},"date":{"type":"Date"},"medium":{"type":"documentMedium"},"guid":{"type":"string"},"id":{"type":"long"},"author":{"type":"array","items":{"$ref":"author"}},"title":{"type":"string"},"primaryAuthorType":{"type":"authorType"},"createdAt":{"type":"Date"},"classification":{"type":"subjectClassificationType"},"year":{"type":"integer"},"primaryAuthor":{"type":"string"},"rating":{"type":"double"},"primaryAuthorId":{"type":"long"}},"id":"documentMetadata"},"Facet":{"properties":{"facetValue":{"type":"array","items":{"$ref":"facetValue"}},"name":{"type":"string"}},"id":"facet"},"WordObject":{"properties":{"word":{"type":"string"},"vulgar":{"type":"string"}},"id":"wordObject"},"WordUGCStats":{"properties":{"listedInCount":{"type":"long"},"favoriteCount":{"type":"long"},"lookupCount":{"type":"long"},"commentCount":{"type":"long"},"tagCount":{"type":"long"}},"id":"wordUGCStats"},"ExampleSearchResults":{"properties":{"facet":{"type":"array","items":{"$ref":"facet"}},"example":{"type":"array","items":{"$ref":"example"}}},"id":"exampleSearchResults"},"BooleanValue":{"properties":{"value":{"type":"boolean"}},"id":"BooleanValue"},"Tag":{"properties":{"id":{"type":"long"},"count":{"type":"long"},"name":{"type":"string"}},"id":"tag"},"AudioFile":{"properties":{"attributedWordLink":{"type":"string"},"commentCount":{"type":"int"},"voteCount":{"type":"integer"},"fileUrl":{"type":"string"},"audioType":{"type":"string"},"id":{"type":"long","required":true},"duration":{"type":"double"},"createdBy":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"Date"},"dictionaryAttribution":{"type":"string"},"voteWeightedAverage":{"type":"float"},"voteAverage":{"type":"float"},"word":{"type":"string"}},"id":"audioFile"},"Bigram":{"properties":{"count":{"type":"long"},"gram2":{"type":"string"},"gram1":{"type":"string"},"wlmi":{"type":"double"},"mi":{"type":"double"}},"id":"bigram"},"Frequency":{"properties":{"count":{"type":"long"},"year":{"type":"int"}},"id":"frequency"},"RelatedDataSource":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"RelatedDataSource"},"TextPron":{"properties":{"raw":{"type":"string"},"id":{"type":"long"},"seq":{"type":"int"},"rawType":{"type":"string"}},"id":"textPron"},"Long":{"properties":{"value":{"type":"long"}},"id":"long"},"Entry":{"properties":{"id":{"type":"long"},"sourceDictionary":{"type":"string"},"relWord":{"type":"array","items":{"$ref":"related"}},"definition":{"type":"array","items":{"$ref":"definition"}},"syll":{"type":"array","items":{"$ref":"syllable"}},"dictionaryAttribution":{"type":"string"},"word":{"type":"string"},"note":{"type":"array","items":{"$ref":"note"}},"header":{"type":"header"}},"id":"entry"},"WordList":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"username":{"type":"string"},"permalink":{"type":"string"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"numberWordsInList":{"type":"long"},"type":{"type":"string"}},"id":"wordList"},"Comment":{"properties":{"id":{"type":"string"},"updatedAt":{"type":"Date"},"body":{"type":"string"},"approved":{"type":"boolean"},"disemvoweled":{"type":"boolean"},"commentedOn":{"type":"string"},"createdAt":{"type":"Date"},"objectId":{"type":"long"},"commentedBy":{"type":"string"},"objectType":{"type":"string"}},"id":"comment"},"DetailedWordUsage":{"properties":{"sentence":{"type":"sentence"},"wordstring":{"type":"string"},"metadata":{"type":"documentMetadata"}},"id":"detailedWordUsage"},"PunctuationFactor":{"properties":{"periodCount":{"type":"long"},"exclamationPointCount":{"type":"long"},"wordId":{"type":"long"},"questionMarkCount":{"type":"long"},"totalCount":{"type":"long"}},"id":"punctuationFactor"},"FacetValue":{"properties":{"count":{"type":"long"},"value":{"type":"string"}},"id":"facetValue"},"Photo":{"properties":{"isfamily":{"type":"int"},"ispublic":{"type":"int"},"linkUri":{"type":"string"},"isfriend":{"type":"int"},"size":{"type":"size"},"id":{"type":"long"},"farm":{"type":"int"},"title":{"type":"string"},"ownerLink":{"type":"string"},"ownername":{"type":"string"},"owner":{"type":"string"},"secret":{"type":"string"},"server":{"type":"int"}},"id":"photo"},"ScoredWord":{"properties":{"position":{"type":"int"},"id":{"type":"long"},"wordType":{"type":"string"},"score":{"type":"float"},"sentenceId":{"type":"long"},"word":{"type":"string"},"partOfSpeech":{"type":"string"}},"id":"scoredWord"},"Sizes":{"properties":{"size":{"type":"array","items":{"$ref":"size"}}},"id":"sizes"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"},"RelationshipType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"RelationshipType"},"RelatedData":{"properties":{"direction":{"type":"string"},"targetWordstring":{"type":"string"},"frequency":{"type":"long"},"sense":{"type":"integer"},"id":{"type":"long"},"sourceWordstring":{"type":"string"},"sourceWordId":{"type":"long"},"relationshipType":{"type":"RelationshipType"},"source":{"type":"RelatedDataSource"},"createdAt":{"type":"Date"},"userId":{"type":"long"},"partOfSpeech":{"type":"string"},"targetWordId":{"type":"long"}},"id":"relatedData"},"PartOfSpeech":{"properties":{"roots":{"type":"array","items":{"$ref":"root"}}},"id":"partOfSpeech"},"FrequencySummary":{"properties":{"unknownYearCount":{"type":"int"},"totalCount":{"type":"long"},"word":{"type":"string"},"frequency":{"type":"array","items":{"$ref":"frequency"}}},"id":"frequencySummary"},"AudioObject":{"properties":{"recordId":{"type":"string"},"wordId":{"type":"long"},"audioFileType":{"type":"audioType"},"filePath":{"type":"string"},"type":{"type":"audioType"},"id":{"type":"long"},"duration":{"type":"double"},"createdBy":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"Date"},"userId":{"type":"long"},"streamPath":{"type":"string"},"audioFileId":{"type":"long"},"wordstring":{"type":"string"}},"id":"audioObject"},"Syllable":{"properties":{"text":{"type":"string"},"seq":{"type":"int"},"type":{"type":"string"}},"id":"syllable"},"AudioType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"audioType"},"Type":{"properties":{"enteredAt":{"type":"string"},"text":{"type":"string"},"mapping":{"type":"long"},"typeId":{"type":"int"}},"id":"type"},"OtherForms":{"properties":{"id":{"type":"long"},"wordId":{"type":"long"},"totalCount":{"type":"long"},"plain":{"type":"string"},"wordString":{"type":"string"}},"id":"otherForms"},"RelationshipMap":{"properties":{"sourceWordstring":{"type":"string"},"suggestion":{"type":"array","items":{"$ref":"suggestion"}}},"id":"relationshipMap"},"Example":{"properties":{"exampleId":{"type":"long"},"title":{"type":"string"},"text":{"type":"string"},"word":{"type":"string"},"provider":{"type":"contentProvider"},"year":{"type":"integer"},"rating":{"type":"float"},"documentId":{"type":"long"},"url":{"type":"string"}},"id":"example"},"Header":{"properties":{"position":{"type":"integer"},"sourceDictionary":{"type":"string"},"homograph":{"type":"string"},"derivedFrom":{"type":"string"},"type":{"type":"type"},"syllable":{"type":"array","items":{"$ref":"syllable"}},"dictionaryAttribution":{"type":"string"},"word":{"type":"string"},"etymologyXml":{"type":"string"},"derivativeSense":{"type":"string"},"note":{"type":"array","items":{"$ref":"note"}},"textPron":{"type":"array","items":{"$ref":"textPron"}},"partOfSpeech":{"type":"string"}},"id":"header"},"ExampleUsage":{"properties":{"text":{"type":"string"}},"id":"ExampleUsage"},"ExampleSearchQuery":{"properties":{"limit":{"type":"int"},"returnFacets":{"type":"boolean"},"dateRange":{"type":"string"},"endDateInclusive":{"type":"boolean"},"subject":{"type":"string"},"endDate":{"type":"Date"},"contentType":{"type":"string"},"beginDate":{"type":"Date"},"skip":{"type":"int"},"medium":{"type":"string"},"beginDateInclusive":{"type":"boolean"},"wordType":{"type":"string"},"contentProvider":{"type":"string"},"year":{"type":"int"},"wordString":{"type":"string"},"filter":{"type":"string"},"partOfSpeech":{"type":"string"}},"id":"ExampleSearchQuery"},"Suggestion":{"properties":{"type":{"type":"int"},"wordstring":{"type":"string"}},"id":"suggestion"},"DefinitionSearchResults":{"properties":{"result":{"type":"array","items":{"$ref":"definition"}},"totalResults":{"type":"int"}},"id":"DefinitionSearchResults"},"Note":{"properties":{"noteType":{"type":"string"},"appliesTo":{"type":"array","items":{"type":"string"}},"value":{"type":"string"},"pos":{"type":"int"}},"id":"note"},"Related":{"properties":{"label1":{"type":"string"},"label2":{"type":"string"},"relationshipType":{"type":"string"},"label3":{"type":"string"},"word":{"type":"array","items":{"type":"string"}},"gram":{"type":"string"},"label4":{"type":"string"}},"id":"related"},"Citation":{"properties":{"cite":{"type":"string"},"source":{"type":"string"}},"id":"citation"},"FrequencyStats":{"properties":{"author":{"type":"Map[long,long]"},"subject":{"type":"Map[integer,long]"},"contentProvider":{"type":"Map[integer,long]"},"contentType":{"type":"Map[integer,long]"},"yearWise":{"type":"Map[integer,long]"},"corpusCount":{"type":"long"},"medium":{"type":"Map[integer,long]"}},"id":"frequencyStats"},"Category":{"properties":{"name":{"type":"string"}},"id":"category"},"WordStats":{"properties":{"dictionaryStats":{"type":"Map[string,dictionaryWordStats]"},"documentsCount":{"type":"long"},"ugcStats":{"type":"wordUGCStats"},"sentencesCount":{"type":"long"},"frequencyStats":{"type":"frequencyStats"},"partOfSpeechStats":{"type":"Map[string,integer]"},"wordstring":{"type":"string"}},"id":"wordStats"},"Root":{"properties":{"name":{"type":"string"},"categories":{"type":"array","items":{"$ref":"category"}}},"id":"root"},"Sentence":{"properties":{"id":{"type":"long"},"display":{"type":"string"},"rating":{"type":"int"},"documentMetadataId":{"type":"long"},"scoredWord":{"type":"array","items":{"$ref":"scoredWord"}}},"id":"sentence"},"Label":{"properties":{"text":{"type":"string"},"type":{"type":"string"}},"id":"Label"},"ExampleDataStore":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"ExampleDataStore"},"Definition":{"properties":{"extendedText":{"type":"string"},"citation":{"type":"array","items":{"$ref":"citation"}},"text":{"type":"string"},"sourceDictionary":{"type":"string"},"exampleUsage":{"type":"array","items":{"$ref":"ExampleUsage"}},"relWord":{"type":"array","items":{"$ref":"related"}},"score":{"type":"float"},"label":{"type":"array","items":{"$ref":"Label"}},"seqString":{"type":"string"},"dictionaryAttribution":{"type":"string"},"sequence":{"type":"string"},"word":{"type":"string"},"note":{"type":"array","items":{"$ref":"note"}},"textPron":{"type":"array","items":{"$ref":"textPron"}},"partOfSpeech":{"type":"string"}},"id":"definition"}},"apis":[{"path":"/word.{format}/{word}/entries","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"tags","description":"Return XML tags in response","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary. Valid options: ahd, century, wiktionary, webster, and wordnet.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"etymologies","description":"Return etymologies","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Return entries for a word","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.Entry","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getEntries","responseClass":"List[entry]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/examples","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return examples for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeDuplicates","description":"Show duplicate examples from different sources","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"contentProvider","description":"Return results from a specific ContentProvider","required":false,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"internalDataStore","description":"Specify the internal storage engine.","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns examples for a word","responseTypeInternal":"com.wordnik.corpus.model.ExampleSearchResults","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getExamples","responseClass":"exampleSearchResults","httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to fetch examples for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Search definition object","required":false,"dataType":"ExampleSearchQuery","valueTypeInternal":"com.wordnik.index.example.ExampleSearchQuery","allowMultiple":false,"paramType":"body"},{"name":"internalDataStore","description":"Specify the internal storage engine.","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Fetches examples for a word","responseTypeInternal":"com.wordnik.corpus.model.ExampleSearchResults","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getExamplesPost","responseClass":"exampleSearchResults","httpMethod":"POST"}]},{"path":"/word.{format}/{word}/wordForms","description":"","operations":[{"parameters":[{"name":"word","description":"Word to add forms for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"RelationshipMapWord to add","required":false,"dataType":"suggestion","valueTypeInternal":"com.wordnik.corpus.entity.RelationshipMapWord","allowMultiple":false,"paramType":"body"},{"name":"canonical","description":"Make this the Canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Adds a Relationship Map to a word","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"addWordForm","responseClass":"ok","httpMethod":"POST"},{"parameters":[{"name":"word","description":"Word to fetch forms for","required":true,"dataType":"string","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","allowMultiple":false,"paramType":"query"}],"summary":"Returns other forms of a word","responseTypeInternal":"com.wordnik.corpus.entity.RelationshipMap","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getWordForms","responseClass":"relationshipMap","httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to delete forms from","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"type","description":"Relationship type to delete","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"word","description":"Target word to remove relationship from.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Deletes a relationship from a word","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"deleteWordForm","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/word.{format}/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"String value of WordObject to return","required":true,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includeSuggestions","description":"Return suggestions (for correct spelling, case variants, etc.)","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"shouldCreate","description":"Create word if not existing","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Given a word as a string, returns the WordObject that represents it","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getWord","responseClass":"wordObject","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/definitions","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return definitions for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"partOfSpeech","description":"CSV list of part-of-speech types","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includeRelated","description":"Return related words with definitions","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sourceDictionaries","description":"If 'all' is received, results are returned from all sources. If multiple values are received (e.g. 'century,wiktionary'), results are returned from the first specified dictionary that has definitions. If left blank, results are returned from the first dictionary that has definitions. By default, dictionaries are searched in this order: ahd, wiktionary, webster, century, wordnet","required":false,"dataType":"string","allowableValues":{"values":["all","ahd","century","wiktionary","webster","wordnet"],"valueType":"LIST"},"allowMultiple":true,"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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includeTags","description":"Return a closed set of XML tags in response","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Return definitions for a word","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.Definition","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No definitions found.","code":404}],"nickname":"getDefinitions","responseClass":"List[definition]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/stats","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return stats for","required":true,"dataType":"string","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","allowMultiple":false,"paramType":"query"},{"name":"detailed","description":"Return detailed usage info","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"statsToInclude","description":"stats to include in the results","required":false,"dataType":"string","allowableValues":{"values":["ugc","frequency","dictionary","part_of_speech"],"valueType":"LIST"},"allowMultiple":true,"paramType":"query"}],"summary":"Returns word statistics","responseTypeInternal":"com.wordnik.corpus.stats.entity.WordStats","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No stats available.","code":404}],"nickname":"getWordStats","responseClass":"wordStats","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/topExample","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch examples for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"contentProvider","description":"Return results from a specific ContentProvider","required":false,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"internalDataStore","description":"Specify the internal storage engine.","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns a top example for a word","responseTypeInternal":"com.wordnik.corpus.model.Example","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getTopExample","responseClass":"example","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/punctuationFactor","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"caseSensitive","description":"Input is case sensitive","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches other forms of a word","responseTypeInternal":"com.wordnik.corpus.entity.BangFactor","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getPunctuationFactor","responseClass":"punctuationFactor","deprecated":true,"notes":"Deprecated","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/contextualLookup","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return definitions for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"sentence","description":"The sentence in which the word occurs","required":true,"dataType":"string","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":{"max":4096.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"expandTerms","description":"Expand context terms using related words","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includeSourceDictionaries","description":"Only include these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludeSourceDictionaries","description":"Exclude these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Returns definitions for a word based on the sentence in which it is found","responseTypeInternal":"com.wordnik.index.definition.DefinitionSearchResults","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","httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to return definitions for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"The sentence in which the word occurs","required":true,"dataType":"string","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":{"max":4096.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"expandTerms","description":"Expand context terms using related words","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includeSourceDictionaries","description":"Only include these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludeSourceDictionaries","description":"Exclude these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Returns definitions for a word based on the sentence in which it is found","responseTypeInternal":"com.wordnik.index.definition.DefinitionSearchResults","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","httpMethod":"POST"}]},{"path":"/word.{format}/{word}/commentCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get comment count for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns the number of comments on a word","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getCommentCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/relatedWords","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch relationships for","required":true,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"relationshipTypes","description":"Limits the total results per type of relationship type","required":false,"dataType":"string","allowableValues":{"values":["synonym","antonym","variant","equivalent","cross-reference","related-word","rhyme","form","etymologically-related-term","hypernym","hyponym","inflected-form","primary","same-context","verb-form","verb-stem"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"limitPerRelationshipType","description":"Restrict to the supplied relatinship types","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Given a word as a string, returns relationships from the Word Graph","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getRelatedWords","responseClass":"wordObject","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/related","description":"","operations":[{"parameters":[{"name":"word","description":"Word for which to return related words","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"partOfSpeech","description":"CSV list of part-of-speech types","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get data from a single dictionary","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"type","description":"Relationship type","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Return related words (thesaurus data) for a word","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.Related","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No definitions found.","code":404}],"nickname":"getRelatedWords","responseClass":"List[related]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/listedIn","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch WordLists for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"sortBy","description":"Specifies a sort parameter","required":false,"dataType":"string","allowableValues":{"values":["rating"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"username","description":"User to scope the request to","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns WordLists containing a word","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Invalid word supplied","code":400},{"reason":"Supplied user does not exist","code":404}],"nickname":"getListedIn","responseClass":"List[wordList]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/listedInCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch count for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns a count of lists a word appears in","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getListedInCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/firstListedIn","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch a WordList for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns the first WordList a word appeared in","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getFirstListedIn","responseClass":"wordList","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/firstListedBy","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch a User for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns the first User to list a particular word","responseTypeInternal":"com.wordnik.system.user.entity.User","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getFirstListedBy","responseClass":"user","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/pronunciations","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get pronunciations for","required":true,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary.","required":false,"dataType":"string","allowableValues":{"values":["ahd","century","cmu","macmillan","wiktionary","webster","wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"typeFormat","description":"Text pronunciation type","required":false,"dataType":"string","allowableValues":{"values":["ahd","arpabet","gcide-diacritical","IPA"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns text pronunciations for a given word","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.TextPron","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getTextPronunciations","responseClass":"List[textPron]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/images/flickr","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get flickr images for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"size","description":"Image size","required":false,"dataType":"string","allowableValues":{"values":["thumb","small","med","lg","orig"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns Flickr images for a word","responseTypeInternal":"com.wordnik.corpus.model.FlickrImage","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getFlickrImages","responseClass":"List[photo]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/scrabbleScore","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get scrabble score for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns the Scrabble score for a word","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No scrabble score found.","code":404}],"nickname":"getScrabbleScore","responseClass":"long","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/citations","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get citations for.","required":true,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary. Valid options: ahd, century, wiktionary, webster, and wordnet.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns citations for a word","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.Citation","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getCitations","responseClass":"List[citation]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/hyphenation","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get syllables for","required":true,"dataType":"string","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","allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary. Valid options: ahd, century, wiktionary, webster, and wordnet.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns syllable information for a word","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.Syllable","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getHyphenation","responseClass":"List[syllable]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/unigramCountInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get unigram count for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns syllable information for a word","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getUnigramCountInternal","responseClass":"long","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/phrasesInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get bigrams for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"gamma","description":"Gamma filter","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minWlmi","description":"WLMI Limit","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns Bigrams for the given word","responseTypeInternal":"com.wordnik.corpus.ngram.entity.Bigram","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getBigramsInternal","responseClass":"List[bigram]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/lookupCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get Bigrams for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns the number of times a word has been viewed","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getLookupCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/tags","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch Tags on","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"username","description":"Restrict to a particular user","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches tags for a word","responseTypeInternal":"com.wordnik.community.entity.Tag","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getTagsOnWord","responseClass":"List[tag]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/tagCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch Tag count on","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"username","description":"Restrict to a particular user","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches tag count for a word","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getTagCountOnWord","responseClass":"long","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/tag","description":"","operations":[{"parameters":[{"name":"word","description":"Word to add a Tag to","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"tags","description":"CSV list of tags to add.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"username","description":"Add tag on behalf of a particular user","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Adds a tag to a word","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"addTagToWord","responseClass":"ok","httpMethod":"POST"},{"parameters":[{"name":"word","description":"Word to add a Tag to","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"tags","description":"CSV list of tags to remove.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"username","description":"Remove tag on behalf of a particular user","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Removes a tag from a word","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"deleteTagFromWord","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/word.{format}/{word}/frequency","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"caseSensitive","description":"Input is case sensitive","required":false,"dataType":"string","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","allowMultiple":false,"paramType":"query"},{"name":"startYear","description":"Starting Year","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"endYear","description":"Ending Year","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includeErrorBars","description":"Get error bar data","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns word usage over time","responseTypeInternal":"com.wordnik.corpus.entity.FrequencySummary","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getWordFrequency","responseClass":"frequencySummary","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/firstUsed","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return first usage for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"detailed","description":"Return detailed usage info","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns first usage of a word","responseTypeInternal":"com.wordnik.corpus.stats.entity.DetailedWordUsage","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getFirstUsageOfWord","responseClass":"detailedWordUsage","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/wordView","description":"","operations":[{"parameters":[{"name":"word","description":"Word to record a word view for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"userId","description":"ID of the user viewing the word","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userGuid","description":"Tracking ID for the user","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userSessionId","description":"Session ID for the user","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"serverIp","description":"Internal IP address of the web server","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"pageName","description":"Page being viewed","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"method","description":"Method of the word view","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userAgent","description":"Browser user agent","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Records a word view from the website","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"addWordView","responseClass":"ok","httpMethod":"POST"}]},{"path":"/word.{format}/{word}/isFavorite","description":"","operations":[{"parameters":[{"name":"word","description":"Word to check","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userName","description":"Check for a particular user","required":true,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Checks to see if a word is a user's favorite","responseTypeInternal":"com.wordnik.system.model.BooleanValue","errorResponses":[{"reason":"Invalid word supplied","code":400},{"reason":"No user found","code":404}],"nickname":"isFavorite","responseClass":"BooleanValue","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/favoriteCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to check","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userName","description":"Check for a particular user","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns the number of times a word has been Favorited","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid word supplied","code":400},{"reason":"No user found","code":404}],"nickname":"getFavoriteCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/favorite","description":"","operations":[{"parameters":[{"name":"word","description":"Word to favorite","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"userName","description":"Add as favorite on behalf of a particular user","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Favorites a Word for a user","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No user found","code":404}],"nickname":"addWordToFavorites","responseClass":"ok","httpMethod":"POST"},{"parameters":[{"name":"word","description":"Word to remove","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"userName","description":"Remove on behalf of a particular user","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Removes a Word from a user's Favorites","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied or no user found.","code":400}],"nickname":"deleteFromFavorites","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/word.{format}/{word}/phrases","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch phrases for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"wlmi","description":"Minimum WLMI for the phrase","required":false,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Fetches bi-gram phrases for a word","responseTypeInternal":"com.wordnik.corpus.ngram.entity.Bigram","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getPhrases","responseClass":"List[bigram]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/etymologies","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"sourceDictionary","description":"Get etymologies from a single dictionary. Options are ahd or century.","required":false,"dataType":"string","allowableValues":{"values":["ahd","webster","wiktionary"],"valueType":"LIST"},"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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"type","description":"Etymology type","required":false,"dataType":"string","allowableValues":{"values":["ahd","webster","wiktionary"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Fetches etymology data","responseTypeInternal":"String","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No definitions found.","code":404}],"nickname":"getEtymologies","responseClass":"String","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/otherFormsInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minFrequency","description":"Minimum corpus frequency","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches other forms of a word","responseTypeInternal":"com.wordnik.corpus.site.entity.OtherFormsData","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getOtherFormsInternal","responseClass":"List[otherForms]","deprecated":true,"notes":"Deprecated","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/wordRelationshipInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Relationship to add","required":false,"dataType":"relatedData","valueTypeInternal":"com.wordnik.corpus.site.entity.SiteRelatedData","allowMultiple":false,"paramType":"body"}],"summary":"Adds a word relationship","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"addWordRelationshipInternal","responseClass":"ok","deprecated":true,"notes":"Deprecated","httpMethod":"POST"}]},{"path":"/word.{format}/{word}/comments","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return Comments for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"sortOrder","defaultValue":"descending","description":"Direction to sort by","required":false,"dataType":"string","allowableValues":{"values":["ascending","descending"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches comments on a Word","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getCommentsOnWord","responseClass":"List[comment]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/comment/{commentId}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch Comment for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"ID of Comment to fetch.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches a Comment by ID","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"nickname":"getCommentOnWord","responseClass":"comment","httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to update Comment on.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Updated Comment.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Deletes an existing word comment","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"nickname":"deleteCommentByIdOnWord","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/word.{format}/{word}/comment","description":"","operations":[{"parameters":[{"name":"word","description":"Word to add Comment to.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Comment to add.","required":false,"dataType":"comment","valueTypeInternal":"com.wordnik.community.entity.Comment","allowMultiple":false,"paramType":"body"}],"summary":"Adds a comment to a word","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"nickname":"commentOnWord","responseClass":"comment","httpMethod":"POST"},{"parameters":[{"name":"word","description":"Word to update Comment on.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated Comment.","required":false,"dataType":"comment","valueTypeInternal":"com.wordnik.community.entity.Comment","allowMultiple":false,"paramType":"body"}],"summary":"Updates an existing word comment","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"nickname":"updateCommentOnWord","responseClass":"comment","httpMethod":"PUT"}]},{"path":"/word.{format}/{word}/audio","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get audio for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"v3Format","description":"Use the V3 api.","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches audio metadata for a word.","responseTypeInternal":"com.wordnik.community.entity.AudioFileMetadata","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.","httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to add audio to.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"AudioPon metadata to add.","required":false,"dataType":"audioObject","valueTypeInternal":"com.wordnik.community.entity.AudioPron","allowMultiple":false,"paramType":"body"}],"summary":"Creates AudioPron metadata","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"addAudio","responseClass":"ok","httpMethod":"POST"}]},{"path":"/word.{format}/{word}/pronunciation/{pronId}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get audio for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"pronId","description":"Id to get audio for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches single audio pronunciation.","responseTypeInternal":"com.wordnik.community.entity.AudioFileMetadata","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.","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/audioInternal","description":"","operations":[{"parameters":[{"name":"word","description":"audio object to update","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated metadata.","required":false,"dataType":"audioObject","valueTypeInternal":"com.wordnik.community.entity.AudioPron","allowMultiple":false,"paramType":"body"}],"summary":"Internal method to update an audio object","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"updateAudioInternal","responseClass":"ok","httpMethod":"PUT"}]},{"path":"/word.{format}/{word}/audio/{audio_id}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to delete audio from.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"audio_id","description":"AudioPon metadata to add.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Deletes an AudioPron","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Unauthorized.","code":401}],"nickname":"deleteAudio","responseClass":"ok","httpMethod":"DELETE"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1","apiVersion":"4.0"}
+{"resourcePath":"/word","models":{"User":{"properties":{"id":{"type":"long"},"username":{"type":"string"},"email":{"type":"string"},"status":{"type":"int"},"faceBookId":{"type":"string"},"userName":{"type":"string"},"displayName":{"type":"string"},"password":{"type":"string"}},"id":"user"},"DocumentMetadata":{"properties":{"tags":{"type":"array","items":{"type":"string"}},"yearType":{"type":"yearType"},"expirationDate":{"type":"Date"},"extendedMetadata":{"type":"extendedMetadata"},"stats":{"type":"basicDocumentStats"},"provider":{"type":"contentProvider"},"contentType":{"type":"contentType"},"sourceUrl":{"type":"string"},"date":{"type":"Date"},"medium":{"type":"documentMedium"},"guid":{"type":"string"},"id":{"type":"long"},"authors":{"type":"array","items":{"$ref":"author"}},"title":{"type":"string"},"primaryAuthorType":{"type":"authorType"},"createdAt":{"type":"Date"},"classification":{"type":"subjectClassificationType"},"year":{"type":"integer"},"primaryAuthor":{"type":"string"},"rating":{"type":"double"},"primaryAuthorId":{"type":"long"}},"id":"documentMetadata"},"Facet":{"properties":{"facetValues":{"type":"array","items":{"$ref":"facetValue"}},"name":{"type":"string"}},"id":"facet"},"WordObject":{"properties":{"word":{"type":"string"},"vulgar":{"type":"string"}},"id":"wordObject"},"WordUGCStats":{"properties":{"listedInCount":{"type":"long"},"favoriteCount":{"type":"long"},"lookupCount":{"type":"long"},"commentCount":{"type":"long"},"tagCount":{"type":"long"}},"id":"wordUGCStats"},"ExampleSearchResults":{"properties":{"facets":{"type":"array","items":{"$ref":"facet"}},"examples":{"type":"array","items":{"$ref":"example"}}},"id":"exampleSearchResults"},"BooleanValue":{"properties":{"value":{"type":"boolean"}},"id":"BooleanValue"},"Tag":{"properties":{"id":{"type":"long"},"count":{"type":"long"},"name":{"type":"string"}},"id":"tag"},"AudioFile":{"properties":{"creatorId":{"type":"long"},"attributionUrl":{"type":"string"},"commentCount":{"type":"int"},"voteCount":{"type":"integer"},"fileUrl":{"type":"string"},"audioType":{"type":"string"},"id":{"type":"long"},"duration":{"type":"double"},"attributionText":{"type":"string"},"createdBy":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"Date"},"voteWeightedAverage":{"type":"float"},"voteAverage":{"type":"float"},"word":{"type":"string"}},"id":"audioFile"},"Bigram":{"properties":{"count":{"type":"long"},"gram2":{"type":"string"},"gram1":{"type":"string"},"wlmi":{"type":"double"},"mi":{"type":"double"}},"id":"bigram"},"Frequency":{"properties":{"count":{"type":"long"},"year":{"type":"int"}},"id":"frequency"},"RelatedDataSource":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"RelatedDataSource"},"Size":{"properties":{"height":{"type":"int"},"source":{"type":"string"},"width":{"type":"int"},"label":{"type":"string"},"url":{"type":"string"}},"id":"size"},"TextPron":{"properties":{"raw":{"type":"string"},"id":{"type":"long"},"seq":{"type":"int"},"rawType":{"type":"string"}},"id":"textPron"},"Long":{"properties":{"value":{"type":"long"}},"id":"long"},"Entry":{"properties":{"id":{"type":"long"},"sourceDictionary":{"type":"string"},"attributionText":{"type":"string"},"relatedWords":{"type":"array","items":{"$ref":"related"}},"word":{"type":"string"},"definitions":{"type":"array","items":{"$ref":"definition"}},"attributionUrl":{"type":"string"},"notes":{"type":"array","items":{"$ref":"note"}},"syllabified":{"type":"array","items":{"$ref":"syllable"}},"header":{"type":"header"}},"id":"entry"},"WordList":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"username":{"type":"string"},"permalink":{"type":"string"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"numberWordsInList":{"type":"long"},"type":{"type":"string"}},"id":"wordList"},"Comment":{"properties":{"id":{"type":"string"},"updatedAt":{"type":"Date"},"body":{"type":"string"},"approved":{"type":"boolean"},"disemvoweled":{"type":"boolean"},"commentedOn":{"type":"string"},"createdAt":{"type":"Date"},"objectId":{"type":"long"},"commentedBy":{"type":"string"},"objectType":{"type":"string"}},"id":"comment"},"DetailedWordUsage":{"properties":{"sentence":{"type":"sentence"},"wordstring":{"type":"string"},"metadata":{"type":"documentMetadata"}},"id":"detailedWordUsage"},"PunctuationFactor":{"properties":{"periodCount":{"type":"long"},"exclamationPointCount":{"type":"long"},"wordId":{"type":"long"},"questionMarkCount":{"type":"long"},"totalCount":{"type":"long"}},"id":"punctuationFactor"},"FacetValue":{"properties":{"count":{"type":"long"},"value":{"type":"string"}},"id":"facetValue"},"Photo":{"properties":{"isfamily":{"type":"int"},"ispublic":{"type":"int"},"linkUri":{"type":"string"},"isfriend":{"type":"int"},"size":{"type":"size"},"id":{"type":"long"},"farm":{"type":"int"},"title":{"type":"string"},"ownerLink":{"type":"string"},"ownername":{"type":"string"},"owner":{"type":"string"},"secret":{"type":"string"},"server":{"type":"int"}},"id":"photo"},"ScoredWord":{"properties":{"position":{"type":"int"},"id":{"type":"long"},"docTermCount":{"type":"int"},"lemma":{"type":"string"},"wordType":{"type":"string"},"score":{"type":"float"},"sentenceId":{"type":"long"},"word":{"type":"string"},"stopword":{"type":"boolean"},"baseWordScore":{"type":"double"},"partOfSpeech":{"type":"string"}},"id":"scoredWord"},"Sizes":{"properties":{"sizes":{"type":"array","items":{"$ref":"size"}}},"id":"sizes"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"},"RelationshipType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"RelationshipType"},"RelatedData":{"properties":{"direction":{"type":"string"},"targetWordstring":{"type":"string"},"frequency":{"type":"long"},"sense":{"type":"integer"},"id":{"type":"long"},"sourceWordstring":{"type":"string"},"sourceWordId":{"type":"long"},"relationshipType":{"type":"RelationshipType"},"source":{"type":"RelatedDataSource"},"createdAt":{"type":"Date"},"userId":{"type":"long"},"partOfSpeech":{"type":"string"},"targetWordId":{"type":"long"}},"id":"relatedData"},"PartOfSpeech":{"properties":{"roots":{"type":"array","items":{"$ref":"root"}}},"id":"partOfSpeech"},"FrequencySummary":{"properties":{"unknownYearCount":{"type":"int"},"totalCount":{"type":"long"},"word":{"type":"string"},"frequency":{"type":"array","items":{"$ref":"frequency"}}},"id":"frequencySummary"},"AudioObject":{"properties":{"recordId":{"type":"string"},"wordId":{"type":"long"},"audioFileType":{"type":"audioType"},"filePath":{"type":"string"},"type":{"type":"audioType"},"id":{"type":"long"},"duration":{"type":"double"},"createdBy":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"Date"},"userId":{"type":"long"},"streamPath":{"type":"string"},"audioFileId":{"type":"long"},"wordstring":{"type":"string"}},"id":"audioObject"},"Syllable":{"properties":{"text":{"type":"string"},"seq":{"type":"int"},"type":{"type":"string"}},"id":"syllable"},"AudioType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"audioType"},"Type":{"properties":{"enteredAt":{"type":"string"},"text":{"type":"string"},"mapping":{"type":"long"},"typeId":{"type":"int"}},"id":"type"},"OtherForms":{"properties":{"id":{"type":"long"},"wordId":{"type":"long"},"totalCount":{"type":"long"},"plain":{"type":"string"},"wordString":{"type":"string"}},"id":"otherForms"},"RelationshipMap":{"properties":{"sourceWordstring":{"type":"string"},"suggestions":{"type":"array","items":{"$ref":"suggestion"}}},"id":"relationshipMap"},"Example":{"properties":{"exampleId":{"type":"long"},"title":{"type":"string"},"text":{"type":"string"},"word":{"type":"string"},"provider":{"type":"contentProvider"},"year":{"type":"integer"},"rating":{"type":"float"},"documentId":{"type":"long"},"url":{"type":"string"}},"id":"example"},"Header":{"properties":{"position":{"type":"integer"},"sourceDictionary":{"type":"string"},"homograph":{"type":"string"},"derivedFrom":{"type":"string"},"type":{"type":"type"},"attributionUrl":{"type":"string"},"attributionText":{"type":"string"},"syllables":{"type":"array","items":{"$ref":"syllable"}},"word":{"type":"string"},"etymologyXml":{"type":"string"},"textProns":{"type":"array","items":{"$ref":"textPron"}},"notes":{"type":"array","items":{"$ref":"note"}},"derivativeSense":{"type":"string"},"partOfSpeech":{"type":"string"}},"id":"header"},"ExampleUsage":{"properties":{"text":{"type":"string"}},"id":"ExampleUsage"},"ExampleSearchQuery":{"properties":{"limit":{"type":"int"},"returnFacets":{"type":"boolean"},"dateRange":{"type":"string"},"endDateInclusive":{"type":"boolean"},"subject":{"type":"string"},"endDate":{"type":"Date"},"contentType":{"type":"string"},"beginDate":{"type":"Date"},"skip":{"type":"int"},"medium":{"type":"string"},"beginDateInclusive":{"type":"boolean"},"wordType":{"type":"string"},"contentProvider":{"type":"string"},"year":{"type":"int"},"wordString":{"type":"string"},"filter":{"type":"string"},"partOfSpeech":{"type":"string"}},"id":"ExampleSearchQuery"},"Suggestion":{"properties":{"type":{"type":"int"},"wordstring":{"type":"string"}},"id":"suggestion"},"DefinitionSearchResults":{"properties":{"results":{"type":"array","items":{"$ref":"definition"}},"totalResults":{"type":"int"}},"id":"DefinitionSearchResults"},"Note":{"properties":{"noteType":{"type":"string"},"appliesTo":{"type":"array","items":{"type":"string"}},"value":{"type":"string"},"pos":{"type":"int"}},"id":"note"},"Related":{"properties":{"label1":{"type":"string"},"label2":{"type":"string"},"relationshipType":{"type":"string"},"label3":{"type":"string"},"words":{"type":"array","items":{"type":"string"}},"gram":{"type":"string"},"label4":{"type":"string"}},"id":"related"},"Citation":{"properties":{"cite":{"type":"string"},"source":{"type":"string"}},"id":"citation"},"FrequencyStats":{"properties":{"author":{"type":"Map[long,long]"},"subject":{"type":"Map[integer,long]"},"contentProvider":{"type":"Map[integer,long]"},"contentType":{"type":"Map[integer,long]"},"corpusCount":{"type":"long"},"yearWise":{"type":"Map[integer,long]"},"medium":{"type":"Map[integer,long]"}},"id":"frequencyStats"},"WordStats":{"properties":{"dictionaryStats":{"type":"Map[string,dictionaryWordStats]"},"documentsCount":{"type":"long"},"ugcStats":{"type":"wordUGCStats"},"sentencesCount":{"type":"long"},"frequencyStats":{"type":"frequencyStats"},"partOfSpeechStats":{"type":"Map[string,integer]"},"wordstring":{"type":"string"}},"id":"wordStats"},"Sentence":{"properties":{"id":{"type":"long"},"scoredWords":{"type":"array","items":{"$ref":"scoredWord"}},"display":{"type":"string"},"rating":{"type":"int"},"documentMetadataId":{"type":"long"}},"id":"sentence"},"Label":{"properties":{"text":{"type":"string"},"type":{"type":"string"}},"id":"Label"},"ExampleDataStore":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"ExampleDataStore"},"Definition":{"properties":{"extendedText":{"type":"string"},"text":{"type":"string"},"sourceDictionary":{"type":"string"},"citations":{"type":"array","items":{"$ref":"citation"}},"labels":{"type":"array","items":{"$ref":"Label"}},"score":{"type":"float"},"exampleUses":{"type":"array","items":{"$ref":"ExampleUsage"}},"attributionUrl":{"type":"string"},"seqString":{"type":"string"},"attributionText":{"type":"string"},"relatedWords":{"type":"array","items":{"$ref":"related"}},"sequence":{"type":"string"},"word":{"type":"string"},"textProns":{"type":"array","items":{"$ref":"textPron"}},"notes":{"type":"array","items":{"$ref":"note"}},"partOfSpeech":{"type":"string"}},"id":"definition"}},"apis":[{"path":"/word.{format}/{word}/entries","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"tags","description":"Return XML tags in response","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary. Valid options: ahd, century, wiktionary, webster, and wordnet.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"etymologies","description":"Return etymologies","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Return entries for a word","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.Entry","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getEntries","responseClass":"List[entry]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/examples","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return examples for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeDuplicates","description":"Show duplicate examples from different sources","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"contentProvider","description":"Return results from a specific ContentProvider","required":false,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"internalDataStore","description":"Specify the internal storage engine.","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns examples for a word","responseTypeInternal":"com.wordnik.corpus.model.ExampleSearchResults","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getExamples","responseClass":"exampleSearchResults","httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to fetch examples for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Search definition object","required":false,"dataType":"ExampleSearchQuery","valueTypeInternal":"com.wordnik.index.example.ExampleSearchQuery","allowMultiple":false,"paramType":"body"},{"name":"internalDataStore","description":"Specify the internal storage engine.","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Fetches examples for a word","responseTypeInternal":"com.wordnik.corpus.model.ExampleSearchResults","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getExamplesPost","responseClass":"exampleSearchResults","httpMethod":"POST"}]},{"path":"/word.{format}/{word}/wordForms","description":"","operations":[{"parameters":[{"name":"word","description":"Word to add forms for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"RelationshipMapWord to add","required":false,"dataType":"suggestion","valueTypeInternal":"com.wordnik.corpus.entity.RelationshipMapWord","allowMultiple":false,"paramType":"body"},{"name":"canonical","description":"Make this the Canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Adds a Relationship Map to a word","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"addWordForm","responseClass":"ok","httpMethod":"POST"},{"parameters":[{"name":"word","description":"Word to fetch forms for","required":true,"dataType":"string","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","allowMultiple":false,"paramType":"query"}],"summary":"Returns other forms of a word","responseTypeInternal":"com.wordnik.corpus.entity.RelationshipMap","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getWordForms","responseClass":"relationshipMap","httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to delete forms from","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"type","description":"Relationship type to delete","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"word","description":"Target word to remove relationship from.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Deletes a relationship from a word","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"deleteWordForm","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/word.{format}/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"String value of WordObject to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","defaultValue":"false","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includeSuggestions","description":"Return suggestions (for correct spelling, case variants, etc.)","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"shouldCreate","description":"Create word if not existing","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Given a word as a string, returns the WordObject that represents it","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getWord","responseClass":"wordObject","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/definitions","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return definitions for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"partOfSpeech","description":"CSV list of part-of-speech types","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includeRelated","defaultValue":"false","description":"Return related words with definitions","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sourceDictionaries","description":"If 'all' is received, results are returned from all sources. If multiple values are received (e.g. 'century,wiktionary'), results are returned from the first specified dictionary that has definitions. If left blank, results are returned from the first dictionary that has definitions. By default, dictionaries are searched in this order: ahd, wiktionary, webster, century, wordnet","required":false,"dataType":"string","allowableValues":{"values":["all","ahd","century","wiktionary","webster","wordnet"],"valueType":"LIST"},"allowMultiple":true,"paramType":"query"},{"name":"useCanonical","defaultValue":"false","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includeTags","defaultValue":"false","description":"Return a closed set of XML tags in response","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Return definitions for a word","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.Definition","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No definitions found.","code":404}],"nickname":"getDefinitions","responseClass":"List[definition]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/stats","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return stats for","required":true,"dataType":"string","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","allowMultiple":false,"paramType":"query"},{"name":"detailed","description":"Return detailed usage info","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"statsToInclude","description":"stats to include in the results","required":false,"dataType":"string","allowableValues":{"values":["ugc","frequency","dictionary","part_of_speech"],"valueType":"LIST"},"allowMultiple":true,"paramType":"query"}],"summary":"Returns word statistics","responseTypeInternal":"com.wordnik.corpus.stats.entity.WordStats","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No stats available.","code":404}],"nickname":"getWordStats","responseClass":"wordStats","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/topExample","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch examples for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"contentProvider","description":"Return results from a specific ContentProvider","required":false,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"internalDataStore","description":"Specify the internal storage engine.","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns a top example for a word","responseTypeInternal":"com.wordnik.corpus.model.Example","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getTopExample","responseClass":"example","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/punctuationFactor","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"caseSensitive","description":"Input is case sensitive","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches other forms of a word","responseTypeInternal":"com.wordnik.corpus.entity.BangFactor","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getPunctuationFactor","responseClass":"punctuationFactor","deprecated":true,"notes":"Deprecated","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/contextualLookup","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return definitions for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"sentence","description":"The sentence in which the word occurs","required":true,"dataType":"string","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":{"max":4096.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"expandTerms","description":"Expand context terms using related words","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includeSourceDictionaries","description":"Only include these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludeSourceDictionaries","description":"Exclude these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Returns definitions for a word based on the sentence in which it is found","responseTypeInternal":"com.wordnik.index.definition.DefinitionSearchResults","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","httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to return definitions for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"The sentence in which the word occurs","required":true,"dataType":"string","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":{"max":4096.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"expandTerms","description":"Expand context terms using related words","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includeSourceDictionaries","description":"Only include these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludeSourceDictionaries","description":"Exclude these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Returns definitions for a word based on the sentence in which it is found","responseTypeInternal":"com.wordnik.index.definition.DefinitionSearchResults","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","httpMethod":"POST"}]},{"path":"/word.{format}/{word}/commentCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get comment count for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns the number of comments on a word","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getCommentCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/relatedWords","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch relationships for","required":true,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"relationshipTypes","description":"Limits the total results per type of relationship type","required":false,"dataType":"string","allowableValues":{"values":["synonym","antonym","variant","equivalent","cross-reference","related-word","rhyme","form","etymologically-related-term","hypernym","hyponym","inflected-form","primary","same-context","verb-form","verb-stem"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"limitPerRelationshipType","description":"Restrict to the supplied relatinship types","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Given a word as a string, returns relationships from the Word Graph","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.Related","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getRelatedWords","responseClass":"List[related]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/listedIn","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch WordLists for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"sortBy","description":"Specifies a sort parameter","required":false,"dataType":"string","allowableValues":{"values":["rating"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"username","description":"User to scope the request to","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns WordLists containing a word","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Invalid word supplied","code":400},{"reason":"Supplied user does not exist","code":404}],"nickname":"getListedIn","responseClass":"List[wordList]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/listedInCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch count for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns a count of lists a word appears in","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getListedInCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/firstListedIn","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch a WordList for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns the first WordList a word appeared in","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getFirstListedIn","responseClass":"wordList","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/firstListedBy","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch a User for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns the first User to list a particular word","responseTypeInternal":"com.wordnik.system.user.entity.User","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getFirstListedBy","responseClass":"user","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/pronunciations","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get pronunciations for","required":true,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary.","required":false,"dataType":"string","allowableValues":{"values":["ahd","century","cmu","macmillan","wiktionary","webster","wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"typeFormat","description":"Text pronunciation type","required":false,"dataType":"string","allowableValues":{"values":["ahd","arpabet","gcide-diacritical","IPA"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns text pronunciations for a given word","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.TextPron","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getTextPronunciations","responseClass":"List[textPron]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/images/flickr","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get flickr images for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"size","description":"Image size","required":false,"dataType":"string","allowableValues":{"values":["thumb","small","med","lg","orig"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns Flickr images for a word","responseTypeInternal":"com.wordnik.corpus.model.FlickrImage","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getFlickrImages","responseClass":"List[photo]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/scrabbleScore","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get scrabble score for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns the Scrabble score for a word","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No scrabble score found.","code":404}],"nickname":"getScrabbleScore","responseClass":"long","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/citations","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get citations for.","required":true,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary. Valid options: ahd, century, wiktionary, webster, and wordnet.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns citations for a word","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.Citation","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getCitations","responseClass":"List[citation]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/hyphenation","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get syllables for","required":true,"dataType":"string","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","allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary. Valid options: ahd, century, wiktionary, webster, and wordnet.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns syllable information for a word","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.Syllable","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getHyphenation","responseClass":"List[syllable]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/unigramCountInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get unigram count for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns syllable information for a word","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getUnigramCountInternal","responseClass":"long","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/phrasesInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get bigrams for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"gamma","description":"Gamma filter","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minWlmi","description":"WLMI Limit","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns Bigrams for the given word","responseTypeInternal":"com.wordnik.corpus.ngram.entity.Bigram","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getBigramsInternal","responseClass":"List[bigram]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/lookupCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get Bigrams for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Returns the number of times a word has been viewed","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Word not found.","code":404}],"nickname":"getLookupCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/tags","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch Tags on","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"username","description":"Restrict to a particular user","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches tags for a word","responseTypeInternal":"com.wordnik.community.entity.Tag","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getTagsOnWord","responseClass":"List[tag]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/tagCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch Tag count on","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"username","description":"Restrict to a particular user","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches tag count for a word","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getTagCountOnWord","responseClass":"long","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/tag","description":"","operations":[{"parameters":[{"name":"word","description":"Word to add a Tag to","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"tags","description":"CSV list of tags to add.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"username","description":"Add tag on behalf of a particular user","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Adds a tag to a word","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"addTagToWord","responseClass":"ok","httpMethod":"POST"},{"parameters":[{"name":"word","description":"Word to add a Tag to","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"tags","description":"CSV list of tags to remove.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"username","description":"Remove tag on behalf of a particular user","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Removes a tag from a word","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"deleteTagFromWord","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/word.{format}/{word}/frequency","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"caseSensitive","description":"Input is case sensitive","required":false,"dataType":"string","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","allowMultiple":false,"paramType":"query"},{"name":"startYear","description":"Starting Year","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"endYear","description":"Ending Year","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includeErrorBars","description":"Get error bar data","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns word usage over time","responseTypeInternal":"com.wordnik.corpus.entity.FrequencySummary","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getWordFrequency","responseClass":"frequencySummary","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/firstUsed","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return first usage for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"detailed","description":"Return detailed usage info","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns first usage of a word","responseTypeInternal":"com.wordnik.corpus.stats.entity.DetailedWordUsage","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getFirstUsageOfWord","responseClass":"detailedWordUsage","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/wordView","description":"","operations":[{"parameters":[{"name":"word","description":"Word to record a word view for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"userId","description":"ID of the user viewing the word","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userGuid","description":"Tracking ID for the user","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userSessionId","description":"Session ID for the user","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"serverIp","description":"Internal IP address of the web server","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"pageName","description":"Page being viewed","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"method","description":"Method of the word view","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userAgent","description":"Browser user agent","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Records a word view from the website","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"addWordView","responseClass":"ok","httpMethod":"POST"}]},{"path":"/word.{format}/{word}/isFavorite","description":"","operations":[{"parameters":[{"name":"word","description":"Word to check","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userName","description":"Check for a particular user","required":true,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Checks to see if a word is a user's favorite","responseTypeInternal":"com.wordnik.system.model.BooleanValue","errorResponses":[{"reason":"Invalid word supplied","code":400},{"reason":"No user found","code":404}],"nickname":"isFavorite","responseClass":"BooleanValue","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/favoriteCount","description":"","operations":[{"parameters":[{"name":"word","description":"Word to check","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"userName","description":"Check for a particular user","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns the number of times a word has been Favorited","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid word supplied","code":400},{"reason":"No user found","code":404}],"nickname":"getFavoriteCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/favorite","description":"","operations":[{"parameters":[{"name":"word","description":"Word to favorite","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"userName","description":"Add as favorite on behalf of a particular user","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Favorites a Word for a user","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No user found","code":404}],"nickname":"addWordToFavorites","responseClass":"ok","httpMethod":"POST"},{"parameters":[{"name":"word","description":"Word to remove","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"userName","description":"Remove on behalf of a particular user","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Removes a Word from a user's Favorites","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied or no user found.","code":400}],"nickname":"deleteFromFavorites","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/word.{format}/{word}/phrases","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch phrases for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"wlmi","description":"Minimum WLMI for the phrase","required":false,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Fetches bi-gram phrases for a word","responseTypeInternal":"com.wordnik.corpus.ngram.entity.Bigram","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getPhrases","responseClass":"List[bigram]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/related","description":"","operations":[{"parameters":[{"name":"word","description":"Word for which to return related words","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"partOfSpeech","description":"CSV list of part-of-speech types","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get data from a single dictionary","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"type","description":"Relationship type","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Return related words (thesaurus data) for a word","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.Related","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No definitions found.","code":404}],"nickname":"getRelated","responseClass":"List[related]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/etymologies","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"sourceDictionary","description":"Get etymologies from a single dictionary. Options are ahd or century.","required":false,"dataType":"string","allowableValues":{"values":["ahd","webster","wiktionary"],"valueType":"LIST"},"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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"type","description":"Etymology type","required":false,"dataType":"string","allowableValues":{"values":["ahd","webster","wiktionary"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"}],"summary":"Fetches etymology data","responseTypeInternal":"String","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No definitions found.","code":404}],"nickname":"getEtymologies","responseClass":"String","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/otherFormsInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minFrequency","description":"Minimum corpus frequency","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches other forms of a word","responseTypeInternal":"com.wordnik.corpus.site.entity.OtherFormsData","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getOtherFormsInternal","responseClass":"List[otherForms]","deprecated":true,"notes":"Deprecated","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/wordRelationshipInternal","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Relationship to add","required":false,"dataType":"relatedData","valueTypeInternal":"com.wordnik.corpus.site.entity.SiteRelatedData","allowMultiple":false,"paramType":"body"}],"summary":"Adds a word relationship","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"addWordRelationshipInternal","responseClass":"ok","deprecated":true,"notes":"Deprecated","httpMethod":"POST"}]},{"path":"/word.{format}/{word}/comments","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return Comments for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"sortOrder","defaultValue":"descending","description":"Direction to sort by","required":false,"dataType":"string","allowableValues":{"values":["ascending","descending"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches comments on a Word","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getCommentsOnWord","responseClass":"List[comment]","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/comment/{commentId}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch Comment for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"ID of Comment to fetch.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches a Comment by ID","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"nickname":"getCommentOnWord","responseClass":"comment","httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to update Comment on.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Updated Comment.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Deletes an existing word comment","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"nickname":"deleteCommentByIdOnWord","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/word.{format}/{word}/comment","description":"","operations":[{"parameters":[{"name":"word","description":"Word to add Comment to.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Comment to add.","required":false,"dataType":"comment","valueTypeInternal":"com.wordnik.community.entity.Comment","allowMultiple":false,"paramType":"body"}],"summary":"Adds a comment to a word","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"nickname":"commentOnWord","responseClass":"comment","httpMethod":"POST"},{"parameters":[{"name":"word","description":"Word to update Comment on.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated Comment.","required":false,"dataType":"comment","valueTypeInternal":"com.wordnik.community.entity.Comment","allowMultiple":false,"paramType":"body"}],"summary":"Updates an existing word comment","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid word or Comment supplied.","code":400},{"reason":"Word or commentor not found.","code":404}],"nickname":"updateCommentOnWord","responseClass":"comment","httpMethod":"PUT"}]},{"path":"/word.{format}/{word}/audio","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get audio for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"v3Format","description":"Use the V3 api.","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches audio metadata for a word.","responseTypeInternal":"com.wordnik.community.entity.AudioFileMetadata","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.","httpMethod":"GET"},{"parameters":[{"name":"word","description":"Word to add audio to.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"AudioPon metadata to add.","required":false,"dataType":"audioObject","valueTypeInternal":"com.wordnik.community.entity.AudioPron","allowMultiple":false,"paramType":"body"}],"summary":"Creates AudioPron metadata","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"addAudio","responseClass":"ok","httpMethod":"POST"}]},{"path":"/word.{format}/{word}/pronunciation/{pronId}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get audio for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"pronId","description":"Id to get audio for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches single audio pronunciation.","responseTypeInternal":"com.wordnik.community.entity.AudioFileMetadata","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.","httpMethod":"GET"}]},{"path":"/word.{format}/{word}/audioInternal","description":"","operations":[{"parameters":[{"name":"word","description":"audio object to update","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated metadata.","required":false,"dataType":"audioObject","valueTypeInternal":"com.wordnik.community.entity.AudioPron","allowMultiple":false,"paramType":"body"}],"summary":"Internal method to update an audio object","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"updateAudioInternal","responseClass":"ok","httpMethod":"PUT"}]},{"path":"/word.{format}/{word}/audio/{audio_id}","description":"","operations":[{"parameters":[{"name":"word","description":"Word to delete audio from.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"audio_id","description":"AudioPon metadata to add.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Deletes an AudioPron","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"Unauthorized.","code":401}],"nickname":"deleteAudio","responseClass":"ok","httpMethod":"DELETE"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/api_docs/wordList.json

@@ -1 +1 @@
-{"resourcePath":"/wordList","models":{"Long":{"properties":{"value":{"type":"long"}},"id":"long"},"WordList":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"username":{"type":"string"},"permalink":{"type":"string"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"numberWordsInList":{"type":"long"},"type":{"type":"string"}},"id":"wordList"},"BooleanValue":{"properties":{"value":{"type":"boolean"}},"id":"BooleanValue"},"Tag":{"properties":{"id":{"type":"long"},"count":{"type":"long"},"name":{"type":"string"}},"id":"tag"},"Comment":{"properties":{"id":{"type":"string"},"updatedAt":{"type":"Date"},"body":{"type":"string"},"approved":{"type":"boolean"},"disemvoweled":{"type":"boolean"},"commentedOn":{"type":"string"},"createdAt":{"type":"Date"},"objectId":{"type":"long"},"commentedBy":{"type":"string"},"objectType":{"type":"string"}},"id":"comment"},"WordListWord":{"properties":{"username":{"type":"string"},"createdAt":{"type":"Date"},"numberCommentsOnWord":{"type":"long"},"userId":{"type":"long"},"word":{"type":"string"},"numberLists":{"type":"long"}},"id":"wordListWord"}},"apis":[{"path":"/wordList.{format}/{wordListId}","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to update","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated WordList","required":false,"dataType":"wordList","valueTypeInternal":"com.wordnik.community.entity.WordList","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","allowMultiple":false,"paramType":"header"}],"summary":"Updates an existing WordList","responseTypeInternal":"ok","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","httpMethod":"PUT"},{"parameters":[{"name":"wordListId","description":"ID of WordList to delete","required":true,"dataType":"string","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","allowMultiple":false,"paramType":"header"}],"summary":"Deletes an existing WordList","responseTypeInternal":"ok","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","httpMethod":"DELETE"},{"parameters":[{"name":"wordListId","description":"ID of WordList to fetch","required":true,"dataType":"string","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","allowMultiple":false,"paramType":"header"}],"summary":"Fetches a WordList by ID","responseTypeInternal":"com.wordnik.community.entity.WordList","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","httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/words","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to user","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to add words on behalf of","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"description":"Array of words to add to WordList","required":false,"dataType":"StringValue[]","valueTypeInternal":"[Lcom.wordnik.resource.StringValue;","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","allowMultiple":false,"paramType":"header"}],"summary":"Adds words to a WordList","responseTypeInternal":"ok","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","httpMethod":"POST"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"sortBy","defaultValue":"createDate","description":"Field to sort by","required":false,"dataType":"string","allowableValues":{"values":["createDate","alpha"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","defaultValue":"desc","description":"Direction to sort","required":false,"dataType":"string","allowableValues":{"values":["asc","desc"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","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","allowMultiple":false,"paramType":"header"}],"summary":"Fetches words in a WordList","responseTypeInternal":"com.wordnik.community.entity.WordListWord","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]","httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/isFavorite","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to check","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to check for Favorite status","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Checks to see if a WordList has been favorited for a user","responseTypeInternal":"com.wordnik.system.model.BooleanValue","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","httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/favorite","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to fetch","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to favorite on behalf of","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Favorites a WordList for a User","responseTypeInternal":"ok","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","httpMethod":"POST"},{"parameters":[{"name":"wordListId","description":"ID of WordList to fetch","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to unfavorite on behalf of","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Unfavorites a WordList for a User","responseTypeInternal":"ok","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","httpMethod":"DELETE"}]},{"path":"/wordList.{format}/{wordListId}/tags","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to get Tags for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches Tags on a WordList","responseTypeInternal":"com.wordnik.community.entity.Tag","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"getWordListTags","responseClass":"List[tag]","httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/tagCount","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to get Tags for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches Tag count on a WordList","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"getWordListTagCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/tag","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to add Tags for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"tags","description":"Tags to add","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Adds a Tag on a WordList","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"addWordListTag","responseClass":"ok","httpMethod":"POST"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to delete Tags for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"tags","description":"Tags to delete","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Deletes a tag on a WordList","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"deleteWordListTag","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/wordList.{format}/{wordListId}/comments","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Direction to sort","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches comments on a WordList","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"getWordListComments","responseClass":"List[comment]","httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/comment","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Comment to add","required":false,"dataType":"comment","valueTypeInternal":"com.wordnik.community.entity.Comment","allowMultiple":false,"paramType":"body"}],"summary":"Adds a Comment on a WordList","responseTypeInternal":"com.wordnik.community.entity.Comment","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","httpMethod":"POST"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated Comment","required":false,"dataType":"comment","valueTypeInternal":"com.wordnik.community.entity.Comment","allowMultiple":false,"paramType":"body"}],"summary":"Updates a Comment on a WordList","responseTypeInternal":"com.wordnik.community.entity.Comment","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","httpMethod":"PUT"}]},{"path":"/wordList.{format}/{wordListId}/comment/{commentId}","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Comment ID to fetch","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches a WordList comment by ID","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList or Comment not found.","code":404}],"nickname":"getWordListCommentById","responseClass":"comment","httpMethod":"GET"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Comment ID to delete","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Deletes a WordList comment by ID","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList or Comment not found.","code":404}],"nickname":"deleteWordListCommentById","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/wordList.{format}/{wordListId}/commentCount","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches WordList Comment count","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"getWordListCommentCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/deleteWords","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to remove words on behalf of","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"description":"Words to remove from WordList","required":false,"dataType":"StringValue[]","valueTypeInternal":"[Lcom.wordnik.resource.StringValue;","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","allowMultiple":false,"paramType":"header"}],"summary":"Removes words from a WordList","responseTypeInternal":"ok","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","httpMethod":"POST"}]},{"path":"/wordList.{format}/{wordListId}/wordsCount","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","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","allowMultiple":false,"paramType":"header"}],"summary":"Gets a count of Words in a WordList","responseTypeInternal":"com.wordnik.system.model.LongResult","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","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1","apiVersion":"4.0"}
+{"resourcePath":"/wordList","models":{"Long":{"properties":{"value":{"type":"long"}},"id":"long"},"WordList":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"username":{"type":"string"},"permalink":{"type":"string"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"numberWordsInList":{"type":"long"},"type":{"type":"string"}},"id":"wordList"},"BooleanValue":{"properties":{"value":{"type":"boolean"}},"id":"BooleanValue"},"Tag":{"properties":{"id":{"type":"long"},"count":{"type":"long"},"name":{"type":"string"}},"id":"tag"},"Comment":{"properties":{"id":{"type":"string"},"updatedAt":{"type":"Date"},"body":{"type":"string"},"approved":{"type":"boolean"},"disemvoweled":{"type":"boolean"},"commentedOn":{"type":"string"},"createdAt":{"type":"Date"},"objectId":{"type":"long"},"commentedBy":{"type":"string"},"objectType":{"type":"string"}},"id":"comment"},"WordListWord":{"properties":{"username":{"type":"string"},"createdAt":{"type":"Date"},"numberCommentsOnWord":{"type":"long"},"userId":{"type":"long"},"word":{"type":"string"},"numberLists":{"type":"long"}},"id":"wordListWord"}},"apis":[{"path":"/wordList.{format}/{wordListId}","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to update","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated WordList","required":false,"dataType":"wordList","valueTypeInternal":"com.wordnik.community.entity.WordList","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","allowMultiple":false,"paramType":"header"}],"summary":"Updates an existing WordList","responseTypeInternal":"ok","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","httpMethod":"PUT"},{"parameters":[{"name":"wordListId","description":"ID of WordList to delete","required":true,"dataType":"string","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","allowMultiple":false,"paramType":"header"}],"summary":"Deletes an existing WordList","responseTypeInternal":"ok","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","httpMethod":"DELETE"},{"parameters":[{"name":"wordListId","description":"ID of WordList to fetch","required":true,"dataType":"string","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","allowMultiple":false,"paramType":"header"}],"summary":"Fetches a WordList by ID","responseTypeInternal":"com.wordnik.community.entity.WordList","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","httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/words","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to user","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to add words on behalf of","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"description":"Array of words to add to WordList","required":false,"dataType":"StringValue[]","valueTypeInternal":"[Lcom.wordnik.resource.StringValue;","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","allowMultiple":false,"paramType":"header"}],"summary":"Adds words to a WordList","responseTypeInternal":"ok","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","httpMethod":"POST"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"sortBy","defaultValue":"createDate","description":"Field to sort by","required":false,"dataType":"string","allowableValues":{"values":["createDate","alpha"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","defaultValue":"desc","description":"Direction to sort","required":false,"dataType":"string","allowableValues":{"values":["asc","desc"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","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","allowMultiple":false,"paramType":"header"}],"summary":"Fetches words in a WordList","responseTypeInternal":"com.wordnik.community.entity.WordListWord","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]","httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/isFavorite","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to check","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to check for Favorite status","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Checks to see if a WordList has been favorited for a user","responseTypeInternal":"com.wordnik.system.model.BooleanValue","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","httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/favorite","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to fetch","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to favorite on behalf of","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Favorites a WordList for a User","responseTypeInternal":"ok","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","httpMethod":"POST"},{"parameters":[{"name":"wordListId","description":"ID of WordList to fetch","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to unfavorite on behalf of","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Unfavorites a WordList for a User","responseTypeInternal":"ok","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","httpMethod":"DELETE"}]},{"path":"/wordList.{format}/{wordListId}/tags","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to get Tags for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches Tags on a WordList","responseTypeInternal":"com.wordnik.community.entity.Tag","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"getWordListTags","responseClass":"List[tag]","httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/tagCount","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to get Tags for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches Tag count on a WordList","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"getWordListTagCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/tag","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to add Tags for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"tags","description":"Tags to add","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Adds a Tag on a WordList","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"addWordListTag","responseClass":"ok","httpMethod":"POST"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to delete Tags for","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"tags","description":"Tags to delete","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Deletes a tag on a WordList","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"deleteWordListTag","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/wordList.{format}/{wordListId}/comments","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Direction to sort","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches comments on a WordList","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"getWordListComments","responseClass":"List[comment]","httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/comment","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Comment to add","required":false,"dataType":"comment","valueTypeInternal":"com.wordnik.community.entity.Comment","allowMultiple":false,"paramType":"body"}],"summary":"Adds a Comment on a WordList","responseTypeInternal":"com.wordnik.community.entity.Comment","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","httpMethod":"POST"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Updated Comment","required":false,"dataType":"comment","valueTypeInternal":"com.wordnik.community.entity.Comment","allowMultiple":false,"paramType":"body"}],"summary":"Updates a Comment on a WordList","responseTypeInternal":"com.wordnik.community.entity.Comment","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","httpMethod":"PUT"}]},{"path":"/wordList.{format}/{wordListId}/comment/{commentId}","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Comment ID to fetch","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches a WordList comment by ID","responseTypeInternal":"com.wordnik.community.entity.Comment","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList or Comment not found.","code":404}],"nickname":"getWordListCommentById","responseClass":"comment","httpMethod":"GET"},{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"commentId","description":"Comment ID to delete","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Deletes a WordList comment by ID","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList or Comment not found.","code":404}],"nickname":"deleteWordListCommentById","responseClass":"ok","httpMethod":"DELETE"}]},{"path":"/wordList.{format}/{wordListId}/commentCount","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"}],"summary":"Fetches WordList Comment count","responseTypeInternal":"com.wordnik.system.model.LongResult","errorResponses":[{"reason":"Invalid WordList ID supplied.","code":400},{"reason":"WordList not found.","code":404}],"nickname":"getWordListCommentCount","responseClass":"long","httpMethod":"GET"}]},{"path":"/wordList.{format}/{wordListId}/deleteWords","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to remove words on behalf of","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"description":"Words to remove from WordList","required":false,"dataType":"StringValue[]","valueTypeInternal":"[Lcom.wordnik.resource.StringValue;","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","allowMultiple":false,"paramType":"header"}],"summary":"Removes words from a WordList","responseTypeInternal":"ok","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","httpMethod":"POST"}]},{"path":"/wordList.{format}/{wordListId}/wordsCount","description":"","operations":[{"parameters":[{"name":"wordListId","description":"ID of WordList to use","required":true,"dataType":"string","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","allowMultiple":false,"paramType":"header"}],"summary":"Gets a count of Words in a WordList","responseTypeInternal":"com.wordnik.system.model.LongResult","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","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/api_docs/wordLists.json

@@ -1 +1 @@
-{"resourcePath":"/wordLists","models":{"WordList":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"username":{"type":"string"},"permalink":{"type":"string"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"numberWordsInList":{"type":"long"},"type":{"type":"string"}},"id":"wordList"},"CommentSummary":{"properties":{"objectDisplayName":{"type":"string"},"objectName":{"type":"string"},"totalCount":{"type":"long"},"countInInterval":{"type":"long"},"intervalInMilliseconds":{"type":"long"},"objectType":{"type":"string"}},"id":"commentSummary"}},"apis":[{"path":"/wordLists.{format}/find/{searchString}","description":"","operations":[{"parameters":[{"name":"searchString","description":"String to search for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordList objects by name.","responseTypeInternal":"com.wordnik.community.entity.WordList","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%'","httpMethod":"GET"}]},{"path":"/wordLists.{format}","description":"","operations":[{"parameters":[{"description":"WordList to create","required":false,"dataType":"wordList","valueTypeInternal":"com.wordnik.community.entity.WordList","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","allowMultiple":false,"paramType":"header"}],"summary":"Creates a WordList.","responseTypeInternal":"com.wordnik.community.entity.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}],"nickname":"createWordList","responseClass":"wordList","httpMethod":"POST"}]},{"path":"/wordLists.{format}/mostCommentedOn","description":"","operations":[{"parameters":[{"name":"dayInterval","description":"Interval in days","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches a CommentSummary for WordList objects.","responseTypeInternal":"com.wordnik.community.model.CommentSummary","errorResponses":[{"reason":"Not authenticated.","code":403}],"nickname":"findMostCommentedOn","responseClass":"List[commentSummary]","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":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to add words on behalf of","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordList objects containing a word.","responseTypeInternal":"com.wordnik.community.entity.WordList","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.","httpMethod":"GET"}]},{"path":"/wordLists.{format}/recentLists","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"type","description":"WordListType to filter by","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches recently created WordList objects.","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Not authenticated.","code":403}],"nickname":"findRecentLists","responseClass":"List[wordList]","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1","apiVersion":"4.0"}
+{"resourcePath":"/wordLists","models":{"WordList":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"username":{"type":"string"},"permalink":{"type":"string"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"numberWordsInList":{"type":"long"},"type":{"type":"string"}},"id":"wordList"},"CommentSummary":{"properties":{"objectDisplayName":{"type":"string"},"objectName":{"type":"string"},"totalCount":{"type":"long"},"countInInterval":{"type":"long"},"intervalInMilliseconds":{"type":"long"},"objectType":{"type":"string"}},"id":"commentSummary"}},"apis":[{"path":"/wordLists.{format}/find/{searchString}","description":"","operations":[{"parameters":[{"name":"searchString","description":"String to search for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordList objects by name.","responseTypeInternal":"com.wordnik.community.entity.WordList","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%'","httpMethod":"GET"}]},{"path":"/wordLists.{format}","description":"","operations":[{"parameters":[{"description":"WordList to create","required":false,"dataType":"wordList","valueTypeInternal":"com.wordnik.community.entity.WordList","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","allowMultiple":false,"paramType":"header"}],"summary":"Creates a WordList.","responseTypeInternal":"com.wordnik.community.entity.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}],"nickname":"createWordList","responseClass":"wordList","httpMethod":"POST"}]},{"path":"/wordLists.{format}/mostCommentedOn","description":"","operations":[{"parameters":[{"name":"dayInterval","description":"Interval in days","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches a CommentSummary for WordList objects.","responseTypeInternal":"com.wordnik.community.model.CommentSummary","errorResponses":[{"reason":"Not authenticated.","code":403}],"nickname":"findMostCommentedOn","responseClass":"List[commentSummary]","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":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"username","description":"Username to add words on behalf of","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordList objects containing a word.","responseTypeInternal":"com.wordnik.community.entity.WordList","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.","httpMethod":"GET"}]},{"path":"/wordLists.{format}/recentLists","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"type","description":"WordListType to filter by","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches recently created WordList objects.","responseTypeInternal":"com.wordnik.community.entity.WordList","errorResponses":[{"reason":"Not authenticated.","code":403}],"nickname":"findRecentLists","responseClass":"List[wordList]","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/api_docs/words.json

@@ -1 +1 @@
-{"resourcePath":"/words","models":{"SubscriptionStatus":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"SubscriptionStatus"},"DocumentMetadata":{"properties":{"yearType":{"type":"yearType"},"expirationDate":{"type":"Date"},"extendedMetadata":{"type":"extendedMetadata"},"tag":{"type":"array","items":{"type":"string"}},"stats":{"type":"basicDocumentStats"},"provider":{"type":"contentProvider"},"contentType":{"type":"contentType"},"sourceUrl":{"type":"string"},"date":{"type":"Date"},"medium":{"type":"documentMedium"},"guid":{"type":"string"},"id":{"type":"long"},"author":{"type":"array","items":{"$ref":"author"}},"title":{"type":"string"},"primaryAuthorType":{"type":"authorType"},"createdAt":{"type":"Date"},"classification":{"type":"subjectClassificationType"},"year":{"type":"integer"},"primaryAuthor":{"type":"string"},"rating":{"type":"double"},"primaryAuthorId":{"type":"long"}},"id":"documentMetadata"},"WordSearchResult":{"properties":{"count":{"type":"long"},"lexicality":{"type":"double"},"word":{"type":"string"}},"id":"WordSearchResult"},"WordOfTheDayList":{"properties":{"subscriptionNamespace":{"type":"string"},"subscriberCount":{"type":"int"},"commentCount":{"type":"int"},"subscriptionIdentifier":{"type":"string"},"firstItemDate":{"type":"Date"},"voteCount":{"type":"integer"},"id":{"type":"string","required":true},"category":{"type":"string"},"createdBy":{"type":"string"},"items":{"type":"array","items":{"$ref":"WordOfTheDay"}},"description":{"type":"string"},"createdAt":{"type":"Date"},"name":{"type":"string"},"voteWeightedAverage":{"type":"float"},"subscriptionSchedule":{"type":"string"},"lastItemDate":{"type":"Date"},"voteAverage":{"type":"float"},"itemCount":{"type":"int"},"subscriptionStatus":{"type":"string"}},"id":"wordOfTheDayList"},"WordOfTheDay":{"properties":{"id":{"type":"long","required":true},"parentId":{"type":"string"},"category":{"type":"string"},"definition":{"type":"array","items":{"$ref":"SimpleDefinition"}},"createdBy":{"type":"string"},"createdAt":{"type":"Date"},"contentProvider":{"type":"contentProvider"},"htmlExtra":{"type":"string"},"word":{"type":"string"},"example":{"type":"array","items":{"$ref":"SimpleExample"}},"note":{"type":"string"},"publishDate":{"type":"Date"}},"id":"WordOfTheDay"},"DetailedWordUsage":{"properties":{"sentence":{"type":"sentence"},"wordstring":{"type":"string"},"metadata":{"type":"documentMetadata"}},"id":"detailedWordUsage"},"EntrySearchResult":{"properties":{"sourceDictionary":{"type":"string"},"definition":{"type":"array","items":{"$ref":"definition"}},"headWord":{"type":"string"},"entryId":{"type":"long"}},"id":"EntrySearchResult"},"DefinitionSearchResults":{"properties":{"result":{"type":"array","items":{"$ref":"definition"}},"totalResults":{"type":"int"}},"id":"DefinitionSearchResults"},"WordObject":{"properties":{"word":{"type":"string"},"vulgar":{"type":"string"}},"id":"wordObject"},"ScoredWord":{"properties":{"position":{"type":"int"},"id":{"type":"long"},"wordType":{"type":"string"},"score":{"type":"float"},"sentenceId":{"type":"long"},"word":{"type":"string"},"partOfSpeech":{"type":"string"}},"id":"scoredWord"},"CommentSummary":{"properties":{"objectDisplayName":{"type":"string"},"objectName":{"type":"string"},"totalCount":{"type":"long"},"countInInterval":{"type":"long"},"intervalInMilliseconds":{"type":"long"},"objectType":{"type":"string"}},"id":"commentSummary"},"WordSearchResults":{"properties":{"searchResult":{"type":"array","items":{"$ref":"WordSearchResult"}},"totalResults":{"type":"int"}},"id":"wordSearchResults"},"Example":{"properties":{"exampleId":{"type":"long"},"title":{"type":"string"},"text":{"type":"string"},"word":{"type":"string"},"provider":{"type":"contentProvider"},"year":{"type":"integer"},"rating":{"type":"float"},"documentId":{"type":"long"},"url":{"type":"string"}},"id":"example"},"WordFrequency":{"properties":{"count":{"type":"long"},"wordstring":{"type":"string"}},"id":"wordFrequency"},"WotdListInvitation":{"properties":{"failure":{"type":"array","items":{"type":"string"}},"permalink":{"type":"string"},"createdBy":{"type":"string"},"createdAt":{"type":"Date"},"recipient":{"type":"array","items":{"type":"string"}},"note":{"type":"string"}},"id":"wotdListInvitation"},"SimpleDefinition":{"properties":{"text":{"type":"string"},"source":{"type":"string"},"note":{"type":"string"},"partOfSpeech":{"type":"string"}},"id":"SimpleDefinition"},"Sentence":{"properties":{"id":{"type":"long"},"display":{"type":"string"},"rating":{"type":"int"},"documentMetadataId":{"type":"long"},"scoredWord":{"type":"array","items":{"$ref":"scoredWord"}}},"id":"sentence"},"EntrySearchResults":{"properties":{"searchResult":{"type":"array","items":{"$ref":"EntrySearchResult"}},"totalResults":{"type":"int"}},"id":"EntrySearchResults"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"},"SimpleExample":{"properties":{"id":{"type":"long"},"title":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"}},"id":"SimpleExample"},"Definition":{"properties":{"extendedText":{"type":"string"},"citation":{"type":"array","items":{"$ref":"citation"}},"text":{"type":"string"},"sourceDictionary":{"type":"string"},"exampleUsage":{"type":"array","items":{"$ref":"ExampleUsage"}},"relWord":{"type":"array","items":{"$ref":"related"}},"score":{"type":"float"},"label":{"type":"array","items":{"$ref":"Label"}},"seqString":{"type":"string"},"dictionaryAttribution":{"type":"string"},"sequence":{"type":"string"},"word":{"type":"string"},"note":{"type":"array","items":{"$ref":"note"}},"textPron":{"type":"array","items":{"$ref":"textPron"}},"partOfSpeech":{"type":"string"}},"id":"definition"},"PartOfSpeech":{"properties":{"roots":{"type":"array","items":{"$ref":"root"}}},"id":"partOfSpeech"}},"apis":[{"path":"/words.{format}/search","description":"","operations":[{"parameters":[{"name":"allowRegex","defaultValue":"false","description":"Search term is a Regular Expression","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"query","description":"Search term","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"caseSensitive","defaultValue":"true","description":"Search case sensitive","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"Exclude these comma-delimited parts of speech","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","defaultValue":"5","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","defaultValue":"1","description":"Minimum number of dictionary entries","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLexicalityRating","defaultValue":"0","description":"Minimum lexicality","required":false,"dataType":"string","allowableValues":{"max":100.0,"min":0.0,"valueType":"RANGE"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","defaultValue":"0","description":"Maximum lexicality","required":false,"dataType":"string","allowableValues":{"max":100.0,"min":0.0,"valueType":"RANGE"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Searches words.","responseTypeInternal":"com.wordnik.corpus.stats.entity.WordFrequency","errorResponses":[{"reason":"Invalid term supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"searchWords","responseClass":"List[wordFrequency]","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}","description":"","operations":[{"parameters":[{"name":"permalink","description":"ID of WordOfTheDayList","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches a WordOfTheDayList by ID","responseTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","errorResponses":[{"reason":"Invalid id supplied","code":400},{"reason":"WordOfTheDayList not found","code":404}],"nickname":"getWordOfTheDayList","responseClass":"wordOfTheDayList","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDay","description":"","operations":[{"parameters":[{"name":"date","description":"Fetches by date in yyyy-MM-dd","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"category","description":"Filters response by category","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"creator","description":"Filters response by username","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns a specific WordOfTheDay","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","nickname":"getWordOfTheDay","responseClass":"WordOfTheDay","httpMethod":"GET"}]},{"path":"/words.{format}/searchEntries","description":"","operations":[{"parameters":[{"name":"query","description":"Search term","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Searches dictionary entries.","responseTypeInternal":"com.wordnik.index.entry.EntrySearchResults","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"searchEntries","responseClass":"EntrySearchResults","httpMethod":"GET"}]},{"path":"/words.{format}/searchDefinitions","description":"","operations":[{"parameters":[{"name":"query","description":"Search term","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"definedWordSearchTerm","description":"Defined word search term","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includeSourceDictionaries","description":"Only include these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludeSourceDictionaries","description":"Exclude these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"Exclude these comma-delimited parts of speech","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","defaultValue":"5","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"expandTerms","description":"Expand terms","required":false,"dataType":"string","allowableValues":{"values":["synonym","hypernym"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"wordTypes","description":"Word types","required":false,"dataType":"string","allowableValues":{"values":["word","multi-word-unit"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"returnWordsOnly","defaultValue":"false","description":"Return words only","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"useTagsForRanking","defaultValue":"true","description":"Use user tags, dictionary labels and hypernyms for ranking","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"sortBy","description":"Attribute to sort by","required":false,"dataType":"string","allowableValues":{"values":["alpha","count","length"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort direction","required":false,"dataType":"string","allowableValues":{"values":["asc","desc"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Searches definitions.","responseTypeInternal":"com.wordnik.index.definition.DefinitionSearchResults","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"searchDefinitions","responseClass":"DefinitionSearchResults","httpMethod":"GET"}]},{"path":"/words.{format}/surfaceForms","description":"","operations":[{"parameters":[{"name":"term","description":"Word to get surface forms for.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches surface forms of a word","responseTypeInternal":"String","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"getSurfaceForms","responseClass":"String","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDay/range","description":"","operations":[{"parameters":[{"name":"category","description":"Filters response by category","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"creator","description":"Filters response by username","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"provider","description":"Filters response by ContentProvider","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns a WordOfTheDay range","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","nickname":"getWordOfTheDayRange","responseClass":"List[WordOfTheDay]","httpMethod":"GET"}]},{"path":"/words.{format}/canonicalForms","description":"","operations":[{"parameters":[{"name":"term","description":"Word to get canonical forms for.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches canonical forms of a word","responseTypeInternal":"String","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"getCanonicalForms","responseClass":"String","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":{"values":["true","false"],"valueType":"LIST"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"query","description":"Search query","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"caseSensitive","defaultValue":"true","description":"Search case sensitive","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"Exclude these comma-delimited parts of speech","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","defaultValue":"5","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","defaultValue":"1","description":"Minimum number of dictionary entries","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLexicalityRating","defaultValue":"0","description":"Minimum lexicality","required":false,"dataType":"string","allowableValues":{"max":100.0,"min":0.0,"valueType":"RANGE"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","defaultValue":"0","description":"Maximum lexicality","required":false,"dataType":"string","allowableValues":{"max":100.0,"min":0.0,"valueType":"RANGE"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Searches words.","responseTypeInternal":"com.wordnik.index.word.WordSearchResults","errorResponses":[{"reason":"Invalid query supplied.","code":400}],"nickname":"searchWordsNew","responseClass":"wordSearchResults","httpMethod":"GET"}]},{"path":"/words.{format}/randomWords","description":"","operations":[{"parameters":[{"name":"hasDictionaryDef","description":"Only return words with dictionary definitions","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"CSV part-of-speech values to include","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"CSV part-of-speech values to exclude","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","description":"Minimum corpus frequency for terms (integer)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms (integer)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","description":"Minimum dictionary count (integer)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count (integer)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minLength","description":"Minimum word length (characters)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length (characters)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minLexicalityRating","description":"Minimum lexicality","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","description":"Maximum lexicality","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"sortBy","description":"Attribute to sort by","required":false,"dataType":"string","allowableValues":{"values":["alpha","count"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort direction","required":false,"dataType":"string","allowableValues":{"values":["asc","desc"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns an array of random WordObjects, in the format specified by the URL","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"Invalid term supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getRandomWords","responseClass":"List[wordObject]","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"CSV part-of-speech values to include","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"CSV part-of-speech values to exclude","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","description":"Minimum dictionary count","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minLength","description":"Minimum word length","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minLexicalityRating","description":"Minimum lexicality","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","description":"Maximum lexicality","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns a single random WordObject, in the format specified by the URL","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"No word found.","code":404}],"nickname":"getRandomWord","responseClass":"wordObject","httpMethod":"GET"}]},{"path":"/words.{format}/examples","description":"","operations":[{"parameters":[{"description":"Words to fetch examples for","required":false,"dataType":"String[]","allowMultiple":false,"paramType":"body"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches examples for multiple words.","responseTypeInternal":"com.wordnik.corpus.model.Example","errorResponses":[{"reason":"Invalid words to search with.","code":400}],"nickname":"getExamplesForWords","responseClass":"List[example]","httpMethod":"POST"}]},{"path":"/words.{format}/mostCommentedOn","description":"","operations":[{"parameters":[{"name":"dayInterval","description":"Number of days to consider","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches words most commented on.","responseTypeInternal":"com.wordnik.community.model.CommentSummary","errorResponses":[{"reason":"Invalid time interval.","code":400}],"nickname":"getWordsMostCommentedOn","responseClass":"List[commentSummary]","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":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"object","description":"Identifier of DocumentStatsType object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"detailed","description":"Return detailed data","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches words most commented on.","responseTypeInternal":"com.wordnik.corpus.stats.entity.DetailedWordUsage","errorResponses":[{"reason":"Invalid time interval.","code":400}],"nickname":"getWordsMostCommentedOn","responseClass":"List[detailedWordUsage]","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":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Invitation to send","required":false,"dataType":"wotdListInvitation","valueTypeInternal":"com.wordnik.community.entity.WordOfTheDayListInvitation","allowMultiple":false,"paramType":"body"}],"summary":"Invites users to a WordOfTheDayList","responseTypeInternal":"ok","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","httpMethod":"POST"}]},{"path":"/words.{format}/wordOfTheDayLists/recent","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches recently created WordOfTheDayLists","responseTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","errorResponses":[{"reason":"No WordOfTheDayLists found.","code":404}],"nickname":"getRecentWordOfTheDayLists","responseClass":"List[wordOfTheDayList]","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}/{specifier}","description":"","operations":[{"parameters":[{"name":"permalink","description":"ID of WordOfTheDayList","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"specifier","description":"Specifier for the item to fetch.  Either 'current' or a date.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeExtraHtml","description":"Include extra HTML if available","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Fetches a WordOfTheDayList by ID","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","errorResponses":[{"reason":"Invalid id supplied","code":400},{"reason":"WordOfTheDayList not found","code":404}],"nickname":"getWordOfTheDayListItem","responseClass":"WordOfTheDay","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayLists","description":"","operations":[{"parameters":[{"name":"containsWord","description":"Lists must contain a specific word","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"subscriberCount","description":"Lists must have the specified number of subscribers","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"itemCount","description":"Lists must have the specified number of items","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches an array of WordOfTheDayList basd on a criteria","responseTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getWordOfTheDayListsContainingWord","responseClass":"List[wordOfTheDayList]","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayLists/subscriptionProcess","description":"","operations":[{"parameters":[{"name":"date","description":"Date string to fetch for.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns whether or not a subscription process has been run.","responseTypeInternal":"String","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.","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","allowMultiple":false,"paramType":"header"},{"name":"permalink","description":"ID of WordOfTheDayList","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"medium","description":"Medium to subscribe with","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"description":"Username to subscribe","required":false,"dataType":"string","allowMultiple":false,"paramType":"body"}],"summary":"Subscribes a user to a WordOfTheDayList","responseTypeInternal":"ok","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","httpMethod":"POST"}]},{"path":"/words.{format}/wordOfTheDayLists/{date}","description":"","operations":[{"parameters":[{"name":"date","description":"ID of WordOfTheDayList","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordOfTheDay objects for a specific date","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"WordOfTheDayList or User not found","code":404}],"nickname":"getWordOfTheDayListsForDate","responseClass":"List[WordOfTheDay]","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1","apiVersion":"4.0"}
+{"resourcePath":"/words","models":{"SubscriptionStatus":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"SubscriptionStatus"},"DocumentMetadata":{"properties":{"tags":{"type":"array","items":{"type":"string"}},"yearType":{"type":"yearType"},"expirationDate":{"type":"Date"},"extendedMetadata":{"type":"extendedMetadata"},"stats":{"type":"basicDocumentStats"},"provider":{"type":"contentProvider"},"contentType":{"type":"contentType"},"sourceUrl":{"type":"string"},"date":{"type":"Date"},"medium":{"type":"documentMedium"},"guid":{"type":"string"},"id":{"type":"long"},"authors":{"type":"array","items":{"$ref":"author"}},"title":{"type":"string"},"primaryAuthorType":{"type":"authorType"},"createdAt":{"type":"Date"},"classification":{"type":"subjectClassificationType"},"year":{"type":"integer"},"primaryAuthor":{"type":"string"},"rating":{"type":"double"},"primaryAuthorId":{"type":"long"}},"id":"documentMetadata"},"WordSearchResult":{"properties":{"count":{"type":"long"},"lexicality":{"type":"double"},"word":{"type":"string"}},"id":"WordSearchResult"},"WordOfTheDayList":{"properties":{"subscriptionNamespace":{"type":"string"},"subscriberCount":{"type":"int"},"creatorId":{"type":"long"},"commentCount":{"type":"int"},"subscriptionIdentifier":{"type":"string"},"firstItemDate":{"type":"Date"},"voteCount":{"type":"integer"},"id":{"type":"string"},"category":{"type":"string"},"createdBy":{"type":"string"},"items":{"type":"array","items":{"$ref":"WordOfTheDay"}},"description":{"type":"string"},"createdAt":{"type":"Date"},"voteWeightedAverage":{"type":"float"},"name":{"type":"string"},"subscriptionSchedule":{"type":"string"},"lastItemDate":{"type":"Date"},"voteAverage":{"type":"float"},"itemCount":{"type":"int"},"subscriptionStatus":{"type":"string"}},"id":"wordOfTheDayList"},"WordOfTheDay":{"properties":{"creatorId":{"type":"long"},"htmlExtra":{"type":"string"},"definitions":{"type":"array","items":{"$ref":"definition"}},"id":{"type":"long"},"parentId":{"type":"string"},"category":{"type":"string"},"createdBy":{"type":"string"},"createdAt":{"type":"Date"},"contentProvider":{"type":"contentProvider"},"word":{"type":"string"},"examples":{"type":"array","items":{"$ref":"example"}},"publishDate":{"type":"Date"},"note":{"type":"string"}},"id":"WordOfTheDay"},"DetailedWordUsage":{"properties":{"sentence":{"type":"sentence"},"wordstring":{"type":"string"},"metadata":{"type":"documentMetadata"}},"id":"detailedWordUsage"},"EntrySearchResult":{"properties":{"sourceDictionary":{"type":"string"},"headWord":{"type":"string"},"definitions":{"type":"array","items":{"$ref":"definition"}},"entryId":{"type":"long"}},"id":"EntrySearchResult"},"DefinitionSearchResults":{"properties":{"results":{"type":"array","items":{"$ref":"definition"}},"totalResults":{"type":"int"}},"id":"DefinitionSearchResults"},"WordObject":{"properties":{"word":{"type":"string"},"vulgar":{"type":"string"}},"id":"wordObject"},"ScoredWord":{"properties":{"position":{"type":"int"},"id":{"type":"long"},"docTermCount":{"type":"int"},"lemma":{"type":"string"},"wordType":{"type":"string"},"score":{"type":"float"},"sentenceId":{"type":"long"},"word":{"type":"string"},"stopword":{"type":"boolean"},"baseWordScore":{"type":"double"},"partOfSpeech":{"type":"string"}},"id":"scoredWord"},"CommentSummary":{"properties":{"objectDisplayName":{"type":"string"},"objectName":{"type":"string"},"totalCount":{"type":"long"},"countInInterval":{"type":"long"},"intervalInMilliseconds":{"type":"long"},"objectType":{"type":"string"}},"id":"commentSummary"},"WordSearchResults":{"properties":{"searchResults":{"type":"array","items":{"$ref":"WordSearchResult"}},"totalResults":{"type":"int"}},"id":"wordSearchResults"},"Category":{"properties":{"name":{"type":"string"}},"id":"category"},"Example":{"properties":{"id":{"type":"long"},"title":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"}},"id":"example"},"WordFrequency":{"properties":{"count":{"type":"long"},"wordstring":{"type":"string"}},"id":"wordFrequency"},"WotdListInvitation":{"properties":{"failures":{"type":"array","items":{"type":"string"}},"permalink":{"type":"string"},"createdBy":{"type":"string"},"recipients":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"Date"},"creatorId":{"type":"long"},"note":{"type":"string"}},"id":"wotdListInvitation"},"Root":{"properties":{"name":{"type":"string"},"categories":{"type":"array","items":{"$ref":"category"}}},"id":"root"},"Sentence":{"properties":{"id":{"type":"long"},"scoredWords":{"type":"array","items":{"$ref":"scoredWord"}},"display":{"type":"string"},"rating":{"type":"int"},"documentMetadataId":{"type":"long"}},"id":"sentence"},"EntrySearchResults":{"properties":{"searchResults":{"type":"array","items":{"$ref":"EntrySearchResult"}},"totalResults":{"type":"int"}},"id":"EntrySearchResults"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"},"Definition":{"properties":{"text":{"type":"string"},"source":{"type":"string"},"note":{"type":"string"},"partOfSpeech":{"type":"string"}},"id":"definition"},"PartOfSpeech":{"properties":{"roots":{"type":"array","items":{"$ref":"root"}}},"id":"partOfSpeech"}},"apis":[{"path":"/words.{format}/search","description":"","operations":[{"parameters":[{"name":"allowRegex","defaultValue":"false","description":"Search term is a Regular Expression","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"query","description":"Search term","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"caseSensitive","defaultValue":"true","description":"Search case sensitive","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"Exclude these comma-delimited parts of speech","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","defaultValue":"5","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","defaultValue":"1","description":"Minimum number of dictionary entries for words returned","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary definition count","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLexicalityRating","defaultValue":"0","description":"Minimum lexicality","required":false,"dataType":"string","allowableValues":{"max":100.0,"min":0.0,"valueType":"RANGE"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","defaultValue":"0","description":"Maximum lexicality","required":false,"dataType":"string","allowableValues":{"max":100.0,"min":0.0,"valueType":"RANGE"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Searches words.","responseTypeInternal":"com.wordnik.corpus.stats.entity.WordFrequency","errorResponses":[{"reason":"Invalid term supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"searchWords","responseClass":"List[wordFrequency]","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}","description":"","operations":[{"parameters":[{"name":"permalink","description":"ID of WordOfTheDayList","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches a WordOfTheDayList by ID","responseTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","errorResponses":[{"reason":"Invalid id supplied","code":400},{"reason":"WordOfTheDayList not found","code":404}],"nickname":"getWordOfTheDayList","responseClass":"wordOfTheDayList","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDay","description":"","operations":[{"parameters":[{"name":"date","description":"Fetches by date in yyyy-MM-dd","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"category","description":"Filters response by category","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"creator","description":"Filters response by username","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns a specific WordOfTheDay","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","nickname":"getWordOfTheDay","responseClass":"WordOfTheDay","httpMethod":"GET"}]},{"path":"/words.{format}/searchEntries","description":"","operations":[{"parameters":[{"name":"query","description":"Search term","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Searches dictionary entries.","responseTypeInternal":"com.wordnik.index.entry.EntrySearchResults","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"searchEntries","responseClass":"EntrySearchResults","httpMethod":"GET"}]},{"path":"/words.{format}/searchDefinitions","description":"","operations":[{"parameters":[{"name":"query","description":"Search term","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"definedWordSearchTerm","description":"Defined word search term","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includeSourceDictionaries","description":"Only include these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludeSourceDictionaries","description":"Exclude these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"Exclude these comma-delimited parts of speech","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","defaultValue":"5","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"expandTerms","description":"Expand terms","required":false,"dataType":"string","allowableValues":{"values":["synonym","hypernym"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"wordTypes","description":"Word types","required":false,"dataType":"string","allowableValues":{"values":["word","multi-word-unit"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"returnWordsOnly","defaultValue":"false","description":"Return words only","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"useTagsForRanking","defaultValue":"true","description":"Use user tags, dictionary labels and hypernyms for ranking","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"sortBy","description":"Attribute to sort by","required":false,"dataType":"string","allowableValues":{"values":["alpha","count","length"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort direction","required":false,"dataType":"string","allowableValues":{"values":["asc","desc"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Searches definitions.","responseTypeInternal":"com.wordnik.index.definition.DefinitionSearchResults","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"searchDefinitions","responseClass":"DefinitionSearchResults","httpMethod":"GET"}]},{"path":"/words.{format}/surfaceForms","description":"","operations":[{"parameters":[{"name":"term","description":"Word to get surface forms for.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches surface forms of a word","responseTypeInternal":"String","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"getSurfaceForms","responseClass":"String","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDay/range","description":"","operations":[{"parameters":[{"name":"category","description":"Filters response by category","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"creator","description":"Filters response by username","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"provider","description":"Filters response by ContentProvider","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns a WordOfTheDay range","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","nickname":"getWordOfTheDayRange","responseClass":"List[WordOfTheDay]","httpMethod":"GET"}]},{"path":"/words.{format}/canonicalForms","description":"","operations":[{"parameters":[{"name":"term","description":"Word to get canonical forms for.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches canonical forms of a word","responseTypeInternal":"String","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"getCanonicalForms","responseClass":"String","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":{"values":["true","false"],"valueType":"LIST"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"query","description":"Search query","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"caseSensitive","defaultValue":"true","description":"Search case sensitive","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"Exclude these comma-delimited parts of speech","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","defaultValue":"5","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","defaultValue":"1","description":"Minimum number of dictionary entries","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLexicalityRating","defaultValue":"0","description":"Minimum lexicality","required":false,"dataType":"string","allowableValues":{"max":100.0,"min":0.0,"valueType":"RANGE"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","defaultValue":"0","description":"Maximum lexicality","required":false,"dataType":"string","allowableValues":{"max":100.0,"min":0.0,"valueType":"RANGE"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Searches words.","responseTypeInternal":"com.wordnik.index.word.WordSearchResults","errorResponses":[{"reason":"Invalid query supplied.","code":400}],"nickname":"searchWordsNew","responseClass":"wordSearchResults","httpMethod":"GET"}]},{"path":"/words.{format}/randomWords","description":"","operations":[{"parameters":[{"name":"hasDictionaryDef","description":"Only return words with dictionary definitions","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"CSV part-of-speech values to include","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"CSV part-of-speech values to exclude","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","description":"Minimum corpus frequency for terms (integer)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms (integer)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","description":"Minimum dictionary count (integer)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count (integer)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minLength","description":"Minimum word length (characters)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length (characters)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minLexicalityRating","description":"Minimum lexicality","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","description":"Maximum lexicality","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"sortBy","description":"Attribute to sort by","required":false,"dataType":"string","allowableValues":{"values":["alpha","count"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort direction","required":false,"dataType":"string","allowableValues":{"values":["asc","desc"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns an array of random WordObjects","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"Invalid term supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getRandomWords","responseClass":"List[wordObject]","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":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"CSV part-of-speech values to include","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"CSV part-of-speech values to exclude","required":false,"dataType":"string","allowableValues":{"values":["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"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","description":"Minimum dictionary count","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minLength","description":"Minimum word length","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minLexicalityRating","description":"Minimum lexicality","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","description":"Maximum lexicality","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns a single random WordObject","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"No word found.","code":404}],"nickname":"getRandomWord","responseClass":"wordObject","httpMethod":"GET"}]},{"path":"/words.{format}/examples","description":"","operations":[{"parameters":[{"description":"Words to fetch examples for","required":false,"dataType":"String[]","allowMultiple":false,"paramType":"body"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches examples for multiple words.","responseTypeInternal":"com.wordnik.corpus.model.Example","errorResponses":[{"reason":"Invalid words to search with.","code":400}],"nickname":"getExamplesForWords","responseClass":"List[example]","httpMethod":"POST"}]},{"path":"/words.{format}/mostCommentedOn","description":"","operations":[{"parameters":[{"name":"dayInterval","description":"Number of days to consider","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches words most commented on.","responseTypeInternal":"com.wordnik.community.model.CommentSummary","errorResponses":[{"reason":"Invalid time interval.","code":400}],"nickname":"getWordsMostCommentedOn","responseClass":"List[commentSummary]","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":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"object","description":"Identifier of DocumentStatsType object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"detailed","description":"Return detailed data","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches words most commented on.","responseTypeInternal":"com.wordnik.corpus.stats.entity.DetailedWordUsage","errorResponses":[{"reason":"Invalid time interval.","code":400}],"nickname":"getWordsMostCommentedOn","responseClass":"List[detailedWordUsage]","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":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Invitation to send","required":false,"dataType":"wotdListInvitation","valueTypeInternal":"com.wordnik.community.entity.WordOfTheDayListInvitation","allowMultiple":false,"paramType":"body"}],"summary":"Invites users to a WordOfTheDayList","responseTypeInternal":"ok","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","httpMethod":"POST"}]},{"path":"/words.{format}/wordOfTheDayLists/recent","description":"","operations":[{"parameters":[{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches recently created WordOfTheDayLists","responseTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","errorResponses":[{"reason":"No WordOfTheDayLists found.","code":404}],"nickname":"getRecentWordOfTheDayLists","responseClass":"List[wordOfTheDayList]","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}/{specifier}","description":"","operations":[{"parameters":[{"name":"permalink","description":"ID of WordOfTheDayList","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"specifier","description":"Specifier for the item to fetch.  Either 'current' or a date.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeExtraHtml","description":"Include extra HTML if available","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Fetches a WordOfTheDayList by ID","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","errorResponses":[{"reason":"Invalid id supplied","code":400},{"reason":"WordOfTheDayList not found","code":404}],"nickname":"getWordOfTheDayListItem","responseClass":"WordOfTheDay","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayLists","description":"","operations":[{"parameters":[{"name":"containsWord","description":"Lists must contain a specific word","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"subscriberCount","description":"Lists must have the specified number of subscribers","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"itemCount","description":"Lists must have the specified number of items","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches an array of WordOfTheDayList basd on a criteria","responseTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getWordOfTheDayListsContainingWord","responseClass":"List[wordOfTheDayList]","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayLists/subscriptionProcess","description":"","operations":[{"parameters":[{"name":"date","description":"Date string to fetch for.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns whether or not a subscription process has been run.","responseTypeInternal":"String","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.","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","allowMultiple":false,"paramType":"header"},{"name":"permalink","description":"ID of WordOfTheDayList","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"medium","description":"Medium to subscribe with","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"description":"Username to subscribe","required":false,"dataType":"string","allowMultiple":false,"paramType":"body"}],"summary":"Subscribes a user to a WordOfTheDayList","responseTypeInternal":"ok","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","httpMethod":"POST"}]},{"path":"/words.{format}/wordOfTheDayLists/{date}","description":"","operations":[{"parameters":[{"name":"date","description":"ID of WordOfTheDayList","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordOfTheDay objects for a specific date","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"WordOfTheDayList or User not found","code":404}],"nickname":"getWordOfTheDayListsForDate","responseClass":"List[WordOfTheDay]","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SHAPSHOT.121026","apiVersion":"4.0"}

data/lib/wordnik.rb

@@ -6,6 +6,7 @@ require 'wordnik/resource'
 require 'wordnik/response'
 require 'wordnik/configuration'
 require 'wordnik/version'
+require 'logger'
 
 # http://blog.jayfields.com/2007/10/ruby-defining-class-methods.html
 class Object
@@ -24,6 +25,8 @@ module Wordnik
 
     attr_accessor :resources
     
+    attr_accessor :logger
+    
     # Call this method to modify defaults in your initializers.
     #
     # @example
@@ -31,12 +34,15 @@ module Wordnik
     #     config.api_key = '1234567890abcdef'     # required
     #     config.username = 'wordlover'           # optional, but needed for user-related functions
     #     config.password = 'i<3words'            # optional, but needed for user-related functions
-    #     config.response_format = :json          # optional, defaults to json
+    #     config.response_format = 'json'         # optional, defaults to json
     #   end
     #
     def configure(build=true)
       self.configuration ||= Configuration.new
       yield(configuration) if block_given?
+
+      # Configure logger.  Default to use Rails
+      self.logger ||= configuration.logger || (defined?(Rails) ? Rails.logger : Logger.new(STDOUT))
       
       # remove :// from scheme
       configuration.scheme.sub!(/:\/\//, '')
@@ -142,4 +148,4 @@ class ServerError < StandardError
 end
 
 class ClientError < StandardError
-end
+end

data/lib/wordnik/configuration.rb

@@ -12,7 +12,7 @@ module Wordnik
     attr_accessor :auth_token
     attr_accessor :user_id
     
-    # Response format can be :json (default) or :xml
+    # Response format can be 'json' (default) or 'xml'
     attr_accessor :response_format
     
     # A comma-delimited list of the API's resources
@@ -25,9 +25,15 @@ module Wordnik
     
     attr_accessor :user_agent
     
+    attr_accessor :proxy
+    attr_accessor :proxy_username
+    attr_accessor :proxy_password
+
+    attr_accessor :logger
+    
     # Defaults go in here..
     def initialize
-      @response_format = :json
+      @response_format = 'json'
       @scheme = 'http'
       @host = 'api.wordnik.com'
       @base_path = '/v4'
@@ -39,7 +45,7 @@ module Wordnik
         true
       rescue
         raise "Problem loading the resource files in ./api_docs/"
-      end      
+      end
     end
     
     def base_url
@@ -52,4 +58,4 @@ module Wordnik
 
   end
 
-end
+end

data/lib/wordnik/request.rb

@@ -24,7 +24,8 @@ module Wordnik
       # Set default headers
       default_headers = {
         'Content-Type' => "application/#{attributes[:format].downcase}",
-        :api_key => Wordnik.configuration.api_key
+        :api_key => Wordnik.configuration.api_key,
+        :user_agent => Wordnik.configuration.user_agent
       }
 
       # api_key from headers hash trumps the default, even if its value is blank
@@ -138,39 +139,25 @@ module Wordnik
     end
   
     def make
-      response = case self.http_method.to_sym
-      when :get
-        Typhoeus::Request.get(
-          self.url,
-          :headers => self.headers.stringify_keys,
-          :user_agent => Wordnik.configuration.user_agent
-        )
-
-      when :post
-        Typhoeus::Request.post(
-          self.url,
-          :body => self.outgoing_body,
-          :headers => self.headers.stringify_keys,
-          :user_agent => Wordnik.configuration.user_agent
-        )
-
-      when :put
-        Typhoeus::Request.put(
-          self.url,
-          :body => self.outgoing_body,
-          :headers => self.headers.stringify_keys,
-          :user_agent => Wordnik.configuration.user_agent
-        )
+      request = Typhoeus::Request.new(self.url,
+        :headers => self.headers.stringify_keys,
+        :method => self.http_method.to_sym)
       
-      when :delete
-        Typhoeus::Request.delete(
-          self.url,
-          :body => self.outgoing_body,
-          :headers => self.headers.stringify_keys,
-          :user_agent => Wordnik.configuration.user_agent
-        )
+      # Make request proxy-aware 
+      if Wordnik.configuration.proxy.present?
+        request.proxy = Wordnik.configuration.proxy
+        request.proxy_username = Wordnik.configuration.proxy_username if Wordnik.configuration.proxy_username.present?
+        request.proxy_password = Wordnik.configuration.proxy_password if Wordnik.configuration.proxy_password.present?
       end
-      Response.new(response)
+      
+      Wordnik.logger.debug "\n  #{self.http_method.upcase} #{self.url}\n  body: #{self.outgoing_body}\n  headers: #{request.headers}\n\n"
+      
+      request.body = self.outgoing_body unless self.http_method.to_sym == :get
+
+      # Execute the request
+      Typhoeus::Hydra.hydra.queue request
+      Typhoeus::Hydra.hydra.run  
+      Response.new(request.response)
     end
   
     def response
@@ -194,4 +181,4 @@ module Wordnik
     end
 
   end
-end
+end

data/lib/wordnik/resource_modules/corpus.rb

@@ -3,7 +3,7 @@
 
 module CorpusMethods
 
-  # Fetches recent views from the website.
+  # Fetches recent views from the website
   #
   def get_recent_views(*args)
     http_method = :get
@@ -266,7 +266,7 @@ module CorpusMethods
     request_only ? request : request.response.body
   end
 
-  # Fetches views from the website.
+  # Fetches views from the website
   #
   def get_views(*args)
     http_method = :get

data/lib/wordnik/resource_modules/glossary.rb

@@ -3,11 +3,11 @@
 
 module GlossaryMethods
 
-  # Fetches GlossaryEntry objects for the specified Glossary. The definitions will come as per the dictionary source order. The first definition can be used to give quick overview of the word. If exact match is found, first record from the search result will be the exact match. First record will also have all the data needed to display definition, pronunciation and example usages. if it is exact match.
+  # Fetches a glossary.
   #
-  def get_glossary_entries(permalinkId, *args)
+  def get_glossary(permalinkId, *args)
     http_method = :get
-    path = '/glossary/{permalinkId}/search'
+    path = '/glossary/{permalinkId}'
     path.sub!('{permalinkId}', permalinkId.to_s)
 
     # Ruby turns all key-value arguments at the end into a single hash
@@ -30,11 +30,11 @@ module GlossaryMethods
     request_only ? request : request.response.body
   end
 
-  # Publishes a Glossary.
+  # Updates a Glossary.
   #
-  def publish_glossary(permalinkId, *args)
-    http_method = :post
-    path = '/glossary/{permalinkId}/publish'
+  def update_glossary(permalinkId, body, *args)
+    http_method = :put
+    path = '/glossary/{permalinkId}'
     path.sub!('{permalinkId}', permalinkId.to_s)
 
     # Ruby turns all key-value arguments at the end into a single hash
@@ -57,11 +57,11 @@ module GlossaryMethods
     request_only ? request : request.response.body
   end
 
-  # Creates a new version of a Glossary.
+  # Deletes the Glossary.
   #
-  def create_version(permalinkId, *args)
-    http_method = :post
-    path = '/glossary/{permalinkId}/clone'
+  def delete_glossary(permalinkId, *args)
+    http_method = :delete
+    path = '/glossary/{permalinkId}'
     path.sub!('{permalinkId}', permalinkId.to_s)
 
     # Ruby turns all key-value arguments at the end into a single hash
@@ -111,13 +111,12 @@ module GlossaryMethods
     request_only ? request : request.response.body
   end
 
-  # Removes a GlossaryEntry object from the specified Glossary.
+  # Publishes a Glossary.
   #
-  def delete_glossary_entry(permalinkId, word, *args)
-    http_method = :delete
-    path = '/glossary/{permalinkId}/entries/{word}'
+  def publish_glossary(permalinkId, *args)
+    http_method = :post
+    path = '/glossary/{permalinkId}/publish'
     path.sub!('{permalinkId}', permalinkId.to_s)
-    path.sub!('{word}', word.to_s)
 
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
@@ -139,11 +138,11 @@ module GlossaryMethods
     request_only ? request : request.response.body
   end
 
-  # Removes a GlossaryEntry object from the specified Glossary.
+  # Creates a new version of a Glossary.
   #
-  def delete_glossary_entries(permalinkId, body, *args)
+  def create_version(permalinkId, *args)
     http_method = :post
-    path = '/glossary/{permalinkId}/deleteEntries'
+    path = '/glossary/{permalinkId}/clone'
     path.sub!('{permalinkId}', permalinkId.to_s)
 
     # Ruby turns all key-value arguments at the end into a single hash
@@ -166,12 +165,13 @@ module GlossaryMethods
     request_only ? request : request.response.body
   end
 
-  # Fetches a random GlossaryEntry object for the specified Glossary.
+  # Removes a GlossaryEntry object from the specified Glossary.
   #
-  def get_random_glossary_entry(permalinkId, *args)
-    http_method = :get
-    path = '/glossary/{permalinkId}/randomEntry'
+  def delete_glossary_entry(permalinkId, word, *args)
+    http_method = :delete
+    path = '/glossary/{permalinkId}/entries/{word}'
     path.sub!('{permalinkId}', permalinkId.to_s)
+    path.sub!('{word}', word.to_s)
 
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
@@ -193,11 +193,11 @@ module GlossaryMethods
     request_only ? request : request.response.body
   end
 
-  # Fetches the GlossaryEntry object for the specified word in the Glossary.
+  # Removes a GlossaryEntry object from the specified Glossary.
   #
-  def get_glossary_entry(permalinkId, *args)
-    http_method = :get
-    path = '/glossary/{permalinkId}/entry'
+  def delete_glossary_entries(permalinkId, body, *args)
+    http_method = :post
+    path = '/glossary/{permalinkId}/deleteEntries'
     path.sub!('{permalinkId}', permalinkId.to_s)
 
     # Ruby turns all key-value arguments at the end into a single hash
@@ -220,13 +220,12 @@ module GlossaryMethods
     request_only ? request : request.response.body
   end
 
-  # Fetches examples for the Glossary entry
+  # Fetches a random GlossaryEntry object for the specified Glossary.
   #
-  def get_glossary_entry_examples(permalinkId, word, *args)
+  def get_random_glossary_entry(permalinkId, *args)
     http_method = :get
-    path = '/glossary/{permalinkId}/{word}/examples'
+    path = '/glossary/{permalinkId}/randomEntry'
     path.sub!('{permalinkId}', permalinkId.to_s)
-    path.sub!('{word}', word.to_s)
 
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
@@ -248,14 +247,13 @@ module GlossaryMethods
     request_only ? request : request.response.body
   end
 
-  # Fetches audio pronunciation for the given id.
+  # Fetches examples for the Glossary entry
   #
-  def get_audio_file(permalinkId, word, pronId, *args)
+  def get_glossary_entry_examples(permalinkId, word, *args)
     http_method = :get
-    path = '/glossary/{permalinkId}/{word}/pronunciation/{pronId}'
+    path = '/glossary/{permalinkId}/entries/{word}/examples'
     path.sub!('{permalinkId}', permalinkId.to_s)
     path.sub!('{word}', word.to_s)
-    path.sub!('{pronId}', pronId.to_s)
 
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')