From 6662057ad55ef42667ac80372cf0ba7cef2fabf3 Mon Sep 17 00:00:00 2001 From: zeke Date: Mon, 9 Jan 2012 15:46:13 -0800 Subject: [PATCH] re-swaggered to get new feeds resource in the mix, bumped version to 4.06.13. --- api_docs/account.json | 2 +- api_docs/analytics.json | 2 +- api_docs/corpus.json | 2 +- api_docs/document.json | 2 +- api_docs/feeds.json | 2 +- api_docs/glossary.json | 2 +- api_docs/health.json | 1 + api_docs/suggest.json | 2 +- api_docs/system.json | 2 +- api_docs/tag.json | 2 +- api_docs/user.json | 2 +- api_docs/users.json | 2 +- api_docs/word.json | 2 +- api_docs/wordList.json | 2 +- api_docs/wordLists.json | 2 +- api_docs/words.json | 2 +- lib/wordnik/resource_modules/corpus.rb | 30 +-- lib/wordnik/resource_modules/feeds.rb | 298 +++++++++++++++++++++++++ lib/wordnik/resource_modules/system.rb | 44 ++-- lib/wordnik/resource_modules/word.rb | 27 +++ lib/wordnik/version.rb | 2 +- 21 files changed, 379 insertions(+), 53 deletions(-) create mode 100644 api_docs/health.json create mode 100644 lib/wordnik/resource_modules/feeds.rb diff --git a/api_docs/account.json b/api_docs/account.json index 98c8b0e..d53c69a 100644 --- a/api_docs/account.json +++ b/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-SHAPSHOT.121026","apiVersion":"4.0"} \ No newline at end of file +{"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"},"permalinkId":{"type":"string"},"lastActivityAt":{"type":"Date"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"userName":{"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-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/analytics.json b/api_docs/analytics.json index 64df4fb..45abddc 100644 --- a/api_docs/analytics.json +++ b/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-SHAPSHOT.121026","apiVersion":"4.0"} \ No newline at end of file +{"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-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/corpus.json b/api_docs/corpus.json index 661d3e8..9af5510 100644 --- a/api_docs/corpus.json +++ b/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"},"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"} \ No newline at end of file +{"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"},"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}/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}/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}/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}/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}/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-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/document.json b/api_docs/document.json index d95ce9e..2f36301 100644 --- a/api_docs/document.json +++ b/api_docs/document.json @@ -1 +1 @@ -{"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"} \ No newline at end of file +{"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-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/feeds.json b/api_docs/feeds.json index 14e48e4..6245d01 100644 --- a/api_docs/feeds.json +++ b/api_docs/feeds.json @@ -1 +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"} \ No newline at end of file +{"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-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/glossary.json b/api_docs/glossary.json index 4b6bdc0..b7190ef 100644 --- a/api_docs/glossary.json +++ b/api_docs/glossary.json @@ -1 +1 @@ -{"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"} \ No newline at end of file +{"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":{"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-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/health.json b/api_docs/health.json new file mode 100644 index 0000000..e9ae1b1 --- /dev/null +++ b/api_docs/health.json @@ -0,0 +1 @@ +{"resourcePath":"/health","models":{"ProfileItem":{"properties":{"minDuration":{"type":"long"},"totalDuration":{"type":"long"},"count":{"type":"long"},"name":{"type":"string"},"avgDuration":{"type":"double"},"hitRate":{"type":"double"},"maxDuration":{"type":"long"},"lastResetTime":{"type":"long"}},"id":"profileItem"},"ServerVersion":{"properties":{"serviceName":{"type":"string"},"version":{"type":"string"}},"id":"serverVersion"}},"apis":[{"path":"/health.{format}/version","description":"","operations":[{"summary":"Returns version of the server","responseTypeInternal":"com.wordnik.resource.endpoint.health.VersionModel","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getAudio","responseClass":"serverVersion","httpMethod":"GET"}]},{"path":"/health.{format}/profile","description":"","operations":[{"parameters":[{"name":"filter","description":"Filter to sort by","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sortBy","defaultValue":"name","description":"Field to sort by","required":false,"dataType":"string","allowableValues":{"values":["name","count","totalDuration","minDuration","avgDuration","maxDuration"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","defaultValue":"asc","description":"Sort direction","required":false,"dataType":"string","allowableValues":{"values":["asc","desc"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"reset","description":"Resets the profile information","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Gets current profile info","responseTypeInternal":"com.wordnik.util.ProfileCounter","nickname":"getProfile","responseClass":"profileItem","httpMethod":"GET"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/suggest.json b/api_docs/suggest.json index be477ff..7e84138 100644 --- a/api_docs/suggest.json +++ b/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-SHAPSHOT.121026","apiVersion":"4.0"} \ No newline at end of file +{"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-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/system.json b/api_docs/system.json index 2ff105d..042a806 100644 --- a/api_docs/system.json +++ b/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"},"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"} \ No newline at end of file +{"resourcePath":"/system","models":{"Long":{"properties":{"value":{"type":"long"}},"id":"long"},"Word":{"properties":{"word":{"type":"string"}},"id":"word"},"WordStats":{"properties":{"wordsListedCount":{"type":"long"},"externalApiCallsCount":{"type":"long"},"favoritesCount":{"type":"long"},"wordViewCount":{"type":"long"},"sentencesCount":{"type":"long"},"tokensCount":{"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}/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"}]},{"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"}]}],"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/tag.json b/api_docs/tag.json index 472ac88..6020438 100644 --- a/api_docs/tag.json +++ b/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-SHAPSHOT.121026","apiVersion":"4.0"} \ No newline at end of file +{"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-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/user.json b/api_docs/user.json index 8ddafab..1dcbf6b 100644 --- a/api_docs/user.json +++ b/api_docs/user.json @@ -1 +1 @@ -{"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"} \ No newline at end of file +{"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"},"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"},"SubscriptionStatus":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"SubscriptionStatus"},"Long":{"properties":{"value":{"type":"long"}},"id":"long"},"WordList":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"permalinkId":{"type":"string"},"lastActivityAt":{"type":"Date"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"userName":{"type":"string"},"numberWordsInList":{"type":"long"},"type":{"type":"string"}},"id":"wordList"},"SubscriptionType":{"properties":{"items":{"type":"array","items":{"$ref":"SubscriptionItem"}},"name":{"type":"string"}},"id":"SubscriptionType"},"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"},"WordOfTheDayList":{"properties":{"subscriptionNamespace":{"type":"string"},"subscriberCount":{"type":"int"},"commentCount":{"type":"int"},"subscriptionIdentifier":{"type":"string"},"firstItemDate":{"type":"Date"},"voteCount":{"type":"integer"},"id":{"type":"string"},"category":{"type":"string"},"createdBy":{"type":"string"},"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"},"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"},"WordOfTheDay":{"properties":{"id":{"type":"long"},"parentId":{"type":"string"},"category":{"type":"string"},"createdBy":{"type":"string"},"createdAt":{"type":"Date"},"contentProvider":{"type":"contentProvider"},"htmlExtra":{"type":"string"},"word":{"type":"string"},"definitions":{"type":"array","items":{"$ref":"definition"}},"examples":{"type":"array","items":{"$ref":"example"}},"note":{"type":"string"},"publishDate":{"type":"Date"}},"id":"WordOfTheDay"},"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"},"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"},"RecentLookup":{"properties":{"createdAt":{"type":"Date"},"wordstring":{"type":"string"}},"id":"recentLookup"},"WordObject":{"properties":{"word":{"type":"string"},"vulgar":{"type":"string"}},"id":"wordObject"},"Example":{"properties":{"id":{"type":"long"},"title":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"}},"id":"example"},"SubscriptionItem":{"properties":{"createdAt":{"type":"Date"},"name":{"type":"string"},"medium":{"type":"string"}},"id":"SubscriptionItem"},"Tag":{"properties":{"id":{"type":"long"},"count":{"type":"long"},"name":{"type":"string"}},"id":"tag"},"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"},"UserTrackingInfo":{"properties":{"signupDate":{"type":"Date"},"lastLoginDate":{"type":"Date"},"noOfLogins":{"type":"int"},"userId":{"type":"long"},"lastUpdatedDate":{"type":"Date"},"signupIPAddress":{"type":"string"}},"id":"UserTrackingInfo"},"PartOfSpeech":{"properties":{"roots":{"type":"array","items":{"$ref":"root"}}},"id":"partOfSpeech"},"Definition":{"properties":{"text":{"type":"string"},"source":{"type":"string"},"note":{"type":"string"},"partOfSpeech":{"type":"string"}},"id":"definition"}},"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":"com.wordnik.community.entity.UgcSummaryStats","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-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/users.json b/api_docs/users.json index 11440a6..4beaf1e 100644 --- a/api_docs/users.json +++ b/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","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"} \ No newline at end of file +{"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-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/word.json b/api_docs/word.json index af62f74..86a3d12 100644 --- a/api_docs/word.json +++ b/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":{"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"} \ No newline at end of file +{"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":{"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"},"permalinkId":{"type":"string"},"lastActivityAt":{"type":"Date"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"userName":{"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"},"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"},"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"},"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"},{"parameters":[{"name":"username","description":"Username to add words on behalf of","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"word","description":"Word to add 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":"relationshipType","description":"The relationship type to add","required":false,"dataType":"string","allowableValues":{"values":["alternateSpelling","misspelling","slang","abbreviation","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":"bidirectional","description":"Build bi-directional relationship","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"description":"Words to add in CSV string","required":false,"dataType":"Word[]","valueTypeInternal":"[Lcom.wordnik.corpus.entity.Word;","allowMultiple":true,"paramType":"body"}],"summary":"Adds relationships to the Word Graph","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid input word, relationship or target words supplied.","code":400}],"nickname":"addRelatedWords","responseClass":"ok","httpMethod":"POST"}]},{"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-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/wordList.json b/api_docs/wordList.json index 844aaf1..20ffcf7 100644 --- a/api_docs/wordList.json +++ b/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-SHAPSHOT.121026","apiVersion":"4.0"} \ No newline at end of file +{"resourcePath":"/wordList","models":{"Long":{"properties":{"value":{"type":"long"}},"id":"long"},"WordList":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"permalinkId":{"type":"string"},"lastActivityAt":{"type":"Date"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"userName":{"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"}},"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":"com.wordnik.community.entity.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-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/wordLists.json b/api_docs/wordLists.json index 271eb92..9f41935 100644 --- a/api_docs/wordLists.json +++ b/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-SHAPSHOT.121026","apiVersion":"4.0"} \ No newline at end of file +{"resourcePath":"/wordLists","models":{"WordList":{"properties":{"updatedAt":{"type":"Date"},"id":{"type":"long"},"permalinkId":{"type":"string"},"lastActivityAt":{"type":"Date"},"createdAt":{"type":"Date"},"description":{"type":"string"},"userId":{"type":"long"},"name":{"type":"string"},"userName":{"type":"string"},"numberWordsInList":{"type":"long"},"type":{"type":"string"}},"id":"wordList"},"CommentSummary":{"properties":{"objectDisplayName":{"type":"string"},"totalCount":{"type":"long"},"objectName":{"type":"string"},"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-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/api_docs/words.json b/api_docs/words.json index 2219f2d..5f825c5 100644 --- a/api_docs/words.json +++ b/api_docs/words.json @@ -1 +1 @@ -{"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"} \ No newline at end of file +{"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"},"commentCount":{"type":"int"},"subscriptionIdentifier":{"type":"string"},"firstItemDate":{"type":"Date"},"voteCount":{"type":"integer"},"id":{"type":"string"},"category":{"type":"string"},"createdBy":{"type":"string"},"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"},"parentId":{"type":"string"},"category":{"type":"string"},"createdBy":{"type":"string"},"createdAt":{"type":"Date"},"contentProvider":{"type":"contentProvider"},"htmlExtra":{"type":"string"},"word":{"type":"string"},"definitions":{"type":"array","items":{"$ref":"definition"}},"examples":{"type":"array","items":{"$ref":"example"}},"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"},"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"},"totalCount":{"type":"long"},"objectName":{"type":"string"},"countInInterval":{"type":"long"},"intervalInMilliseconds":{"type":"long"},"objectType":{"type":"string"}},"id":"commentSummary"},"WordSearchResults":{"properties":{"searchResults":{"type":"array","items":{"$ref":"WordSearchResult"}},"totalResults":{"type":"int"}},"id":"wordSearchResults"},"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"},"note":{"type":"string"}},"id":"wotdListInvitation"},"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-SNAPSHOT.121130","apiVersion":"4.0"} \ No newline at end of file diff --git a/lib/wordnik/resource_modules/corpus.rb b/lib/wordnik/resource_modules/corpus.rb index 6867550..4fa9900 100644 --- a/lib/wordnik/resource_modules/corpus.rb +++ b/lib/wordnik/resource_modules/corpus.rb @@ -162,11 +162,11 @@ def process_text(body, *args) request_only ? request : request.response.body end - # Returns corpus-wide PunctuationFactor. + # Gets corpus-level WordFrequency # - def get_punctuation_factor(*args) + def get_corpus_word_frequencies(*args) http_method = :get - path = '/corpus/punctuationFactor' + path = '/corpus/words' # 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') @@ -188,11 +188,11 @@ def get_punctuation_factor(*args) request_only ? request : request.response.body end - # Returns document-level stats. + # Fetches views from the website # - def get_document_stats(*args) + def get_views(*args) http_method = :get - path = '/corpus/documentStats' + path = '/corpus/views' # 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') @@ -214,11 +214,11 @@ def get_document_stats(*args) request_only ? request : request.response.body end - # Gets corpus-level WordFrequency + # Returns corpus-wide PunctuationFactor. # - def get_corpus_word_frequencies(*args) + def get_punctuation_factor(*args) http_method = :get - path = '/corpus/words' + path = '/corpus/punctuationFactor' # 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') @@ -240,11 +240,11 @@ def get_corpus_word_frequencies(*args) request_only ? request : request.response.body end - # Returns recently listed words. + # Returns document-level stats. # - def get_recent_listed_words(*args) + def get_document_stats(*args) http_method = :get - path = '/corpus/recentListedWords' + path = '/corpus/documentStats' # 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') @@ -266,11 +266,11 @@ def get_recent_listed_words(*args) request_only ? request : request.response.body end - # Fetches views from the website + # Returns recently listed words. # - def get_views(*args) + def get_recent_listed_words(*args) http_method = :get - path = '/corpus/views' + path = '/corpus/recentListedWords' # 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') diff --git a/lib/wordnik/resource_modules/feeds.rb b/lib/wordnik/resource_modules/feeds.rb new file mode 100644 index 0000000..ff55172 --- /dev/null +++ b/lib/wordnik/resource_modules/feeds.rb @@ -0,0 +1,298 @@ +# HEY HACKER! THIS IS AN AUTO-GENERATED FILE. +# So don't bother editing it. To see how it's built, take a look at the Rakefile + +module FeedsMethods + + # Returns recent pronunciations + # + def get_recent_pronunciations(*args) + http_method = :get + path = '/feeds/pronunciations' + + # 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') + # becomes {:limit => 10, :part_of_speech => 'verb'} + last_arg = args.pop if args.last.is_a?(Hash) + last_arg = args.pop if args.last.is_a?(Array) + last_arg ||= {} + + # Look for a kwarg called :request_only, whose presence indicates + # that we want the request itself back, not the response body + if last_arg.is_a?(Hash) && last_arg[:request_only].present? + request_only = true + last_arg.delete(:request_only) + end + + params = last_arg + body ||= {} + request = Wordnik::Request.new(http_method, path, :params => params, :body => body) + request_only ? request : request.response.body + end + + # Returns the word-of-the-day + # + def get_word_of_the_day(*args) + http_method = :get + path = '/feeds/wordOfTheDay' + + # 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') + # becomes {:limit => 10, :part_of_speech => 'verb'} + last_arg = args.pop if args.last.is_a?(Hash) + last_arg = args.pop if args.last.is_a?(Array) + last_arg ||= {} + + # Look for a kwarg called :request_only, whose presence indicates + # that we want the request itself back, not the response body + if last_arg.is_a?(Hash) && last_arg[:request_only].present? + request_only = true + last_arg.delete(:request_only) + end + + params = last_arg + body ||= {} + request = Wordnik::Request.new(http_method, path, :params => params, :body => body) + request_only ? request : request.response.body + end + + # Returns comments made by the specified user + # + def get_comments_by_user(username, *args) + http_method = :get + path = '/feeds/people/{username}/commentsBy' + path.sub!('{username}', username.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') + # becomes {:limit => 10, :part_of_speech => 'verb'} + last_arg = args.pop if args.last.is_a?(Hash) + last_arg = args.pop if args.last.is_a?(Array) + last_arg ||= {} + + # Look for a kwarg called :request_only, whose presence indicates + # that we want the request itself back, not the response body + if last_arg.is_a?(Hash) && last_arg[:request_only].present? + request_only = true + last_arg.delete(:request_only) + end + + params = last_arg + body ||= {} + request = Wordnik::Request.new(http_method, path, :params => params, :body => body) + request_only ? request : request.response.body + end + + # Returns comments made on the specified user + # + def get_comments_on_user(username, *args) + http_method = :get + path = '/feeds/people/{username}/commentsOn' + path.sub!('{username}', username.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') + # becomes {:limit => 10, :part_of_speech => 'verb'} + last_arg = args.pop if args.last.is_a?(Hash) + last_arg = args.pop if args.last.is_a?(Array) + last_arg ||= {} + + # Look for a kwarg called :request_only, whose presence indicates + # that we want the request itself back, not the response body + if last_arg.is_a?(Hash) && last_arg[:request_only].present? + request_only = true + last_arg.delete(:request_only) + end + + params = last_arg + body ||= {} + request = Wordnik::Request.new(http_method, path, :params => params, :body => body) + request_only ? request : request.response.body + end + + # Returns recently favorited words + # + def get_recent_favorites(*args) + http_method = :get + path = '/feeds/favorites' + + # 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') + # becomes {:limit => 10, :part_of_speech => 'verb'} + last_arg = args.pop if args.last.is_a?(Hash) + last_arg = args.pop if args.last.is_a?(Array) + last_arg ||= {} + + # Look for a kwarg called :request_only, whose presence indicates + # that we want the request itself back, not the response body + if last_arg.is_a?(Hash) && last_arg[:request_only].present? + request_only = true + last_arg.delete(:request_only) + end + + params = last_arg + body ||= {} + request = Wordnik::Request.new(http_method, path, :params => params, :body => body) + request_only ? request : request.response.body + end + + # Returns lists for the specified user + # + def get_user_lists(username, *args) + http_method = :get + path = '/feeds/people/{username}/lists' + path.sub!('{username}', username.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') + # becomes {:limit => 10, :part_of_speech => 'verb'} + last_arg = args.pop if args.last.is_a?(Hash) + last_arg = args.pop if args.last.is_a?(Array) + last_arg ||= {} + + # Look for a kwarg called :request_only, whose presence indicates + # that we want the request itself back, not the response body + if last_arg.is_a?(Hash) && last_arg[:request_only].present? + request_only = true + last_arg.delete(:request_only) + end + + params = last_arg + body ||= {} + request = Wordnik::Request.new(http_method, path, :params => params, :body => body) + request_only ? request : request.response.body + end + + # Returns favorites for the specified user + # + def get_user_favorites(username, *args) + http_method = :get + path = '/feeds/people/{username}/favorites' + path.sub!('{username}', username.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') + # becomes {:limit => 10, :part_of_speech => 'verb'} + last_arg = args.pop if args.last.is_a?(Hash) + last_arg = args.pop if args.last.is_a?(Array) + last_arg ||= {} + + # Look for a kwarg called :request_only, whose presence indicates + # that we want the request itself back, not the response body + if last_arg.is_a?(Hash) && last_arg[:request_only].present? + request_only = true + last_arg.delete(:request_only) + end + + params = last_arg + body ||= {} + request = Wordnik::Request.new(http_method, path, :params => params, :body => body) + request_only ? request : request.response.body + end + + # Returns recent lookups + # + def get_recent_lookups(*args) + http_method = :get + path = '/feeds/lookups' + + # 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') + # becomes {:limit => 10, :part_of_speech => 'verb'} + last_arg = args.pop if args.last.is_a?(Hash) + last_arg = args.pop if args.last.is_a?(Array) + last_arg ||= {} + + # Look for a kwarg called :request_only, whose presence indicates + # that we want the request itself back, not the response body + if last_arg.is_a?(Hash) && last_arg[:request_only].present? + request_only = true + last_arg.delete(:request_only) + end + + params = last_arg + body ||= {} + request = Wordnik::Request.new(http_method, path, :params => params, :body => body) + request_only ? request : request.response.body + end + + # Returns recent lists + # + def get_recent_user_lists(*args) + http_method = :get + path = '/feeds/lists' + + # 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') + # becomes {:limit => 10, :part_of_speech => 'verb'} + last_arg = args.pop if args.last.is_a?(Hash) + last_arg = args.pop if args.last.is_a?(Array) + last_arg ||= {} + + # Look for a kwarg called :request_only, whose presence indicates + # that we want the request itself back, not the response body + if last_arg.is_a?(Hash) && last_arg[:request_only].present? + request_only = true + last_arg.delete(:request_only) + end + + params = last_arg + body ||= {} + request = Wordnik::Request.new(http_method, path, :params => params, :body => body) + request_only ? request : request.response.body + end + + # Returns comments on the specified list + # + def get_user_list_comments(permalinkId, *args) + http_method = :get + path = '/feeds/lists/{permalinkId}/comments' + path.sub!('{permalinkId}', permalinkId.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') + # becomes {:limit => 10, :part_of_speech => 'verb'} + last_arg = args.pop if args.last.is_a?(Hash) + last_arg = args.pop if args.last.is_a?(Array) + last_arg ||= {} + + # Look for a kwarg called :request_only, whose presence indicates + # that we want the request itself back, not the response body + if last_arg.is_a?(Hash) && last_arg[:request_only].present? + request_only = true + last_arg.delete(:request_only) + end + + params = last_arg + body ||= {} + request = Wordnik::Request.new(http_method, path, :params => params, :body => body) + request_only ? request : request.response.body + end + + # Returns the specified wordList + # + def get_user_list(permalinkId, *args) + http_method = :get + path = '/feeds/lists/{permalinkId}' + path.sub!('{permalinkId}', permalinkId.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') + # becomes {:limit => 10, :part_of_speech => 'verb'} + last_arg = args.pop if args.last.is_a?(Hash) + last_arg = args.pop if args.last.is_a?(Array) + last_arg ||= {} + + # Look for a kwarg called :request_only, whose presence indicates + # that we want the request itself back, not the response body + if last_arg.is_a?(Hash) && last_arg[:request_only].present? + request_only = true + last_arg.delete(:request_only) + end + + params = last_arg + body ||= {} + request = Wordnik::Request.new(http_method, path, :params => params, :body => body) + request_only ? request : request.response.body + end + +end \ No newline at end of file diff --git a/lib/wordnik/resource_modules/system.rb b/lib/wordnik/resource_modules/system.rb index 2f17844..1d693e1 100644 --- a/lib/wordnik/resource_modules/system.rb +++ b/lib/wordnik/resource_modules/system.rb @@ -29,12 +29,11 @@ def get_providers(*args) request_only ? request : request.response.body end - # Returns weighted terms related to the input word + # Returns system-wide statistics for the platform. # - def get_related_words(word, *args) + def get_stats(*args) http_method = :get - path = '/system/{word}/related' - path.sub!('{word}', word.to_s) + path = '/system/stats' # 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') @@ -56,11 +55,11 @@ def get_related_words(word, *args) request_only ? request : request.response.body end - # Returns a word with attributes + # Returns weighted terms related to the input word # def get_related_words(word, *args) http_method = :get - path = '/system/{word}' + path = '/system/{word}/related' path.sub!('{word}', word.to_s) # Ruby turns all key-value arguments at the end into a single hash @@ -83,11 +82,12 @@ def get_related_words(word, *args) request_only ? request : request.response.body end - # Returns a graph response for the supplied terms + # Returns a word with attributes # - def get_word_by_id(*args) + def get_related_words(word, *args) http_method = :get - path = '/system/graph' + path = '/system/{word}' + 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') @@ -109,11 +109,11 @@ def get_word_by_id(*args) request_only ? request : request.response.body end - # Gets an Audio File ID for recording. + # Returns a graph response for the supplied terms # - def get_audio_record_id(*args) + def get_word_by_id(*args) http_method = :get - path = '/system/audioRecordId' + path = '/system/graph' # 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') @@ -135,13 +135,11 @@ def get_audio_record_id(*args) request_only ? request : request.response.body end - # Sets duration of an Audio File + # Gets an Audio File ID for recording. # - def set_audio_duration(audioFileId, duration, *args) - http_method = :post - path = '/system/audioDuration' - path.sub!('{audioFileId}', audioFileId.to_s) - path.sub!('{duration}', duration.to_s) + def get_audio_record_id(*args) + http_method = :get + path = '/system/audioRecordId' # 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') @@ -163,11 +161,13 @@ def set_audio_duration(audioFileId, duration, *args) request_only ? request : request.response.body end - # Returns system-wide statistics for the platform. + # Sets duration of an Audio File # - def get_stats(*args) - http_method = :get - path = '/system/stats' + def set_audio_duration(audioFileId, duration, *args) + http_method = :post + path = '/system/audioDuration' + path.sub!('{audioFileId}', audioFileId.to_s) + path.sub!('{duration}', duration.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') diff --git a/lib/wordnik/resource_modules/word.rb b/lib/wordnik/resource_modules/word.rb index 7f1567f..1d045c9 100644 --- a/lib/wordnik/resource_modules/word.rb +++ b/lib/wordnik/resource_modules/word.rb @@ -411,6 +411,33 @@ def get_related_words(word, *args) request_only ? request : request.response.body end + # Adds relationships to the Word Graph + # + def add_related_words(word, body, *args) + http_method = :post + path = '/word/{word}/relatedWords' + 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') + # becomes {:limit => 10, :part_of_speech => 'verb'} + last_arg = args.pop if args.last.is_a?(Hash) + last_arg = args.pop if args.last.is_a?(Array) + last_arg ||= {} + + # Look for a kwarg called :request_only, whose presence indicates + # that we want the request itself back, not the response body + if last_arg.is_a?(Hash) && last_arg[:request_only].present? + request_only = true + last_arg.delete(:request_only) + end + + params = last_arg + body ||= {} + request = Wordnik::Request.new(http_method, path, :params => params, :body => body) + request_only ? request : request.response.body + end + # Returns WordLists containing a word # def get_listed_in(word, *args) diff --git a/lib/wordnik/version.rb b/lib/wordnik/version.rb index 2a65400..fd63600 100644 --- a/lib/wordnik/version.rb +++ b/lib/wordnik/version.rb @@ -1,4 +1,4 @@ module Wordnik - VERSION = "4.06.12" + VERSION = "4.06.13" end