diff options
| author | franck cuny <franck@lumberjaph.net> | 2010-11-17 11:51:18 +0100 |
|---|---|---|
| committer | franck cuny <franck@lumberjaph.net> | 2010-11-17 11:51:18 +0100 |
| commit | e03f48683b982f8b9efd4ca0dae0bd6bca7411b5 (patch) | |
| tree | 552b892fb679ccd18f929e8a901b7f375c7a1ad5 /services | |
| parent | add format (diff) | |
| parent | spore2dot: split note & doc (diff) | |
| download | api-description-e03f48683b982f8b9efd4ca0dae0bd6bca7411b5.tar.gz | |
Merge branch 'master' of github.com:SPORE/api-description
* 'master' of github.com:SPORE/api-description:
spore2dot: split note & doc
add modularized CouchDB
spore2dot: add note
Ohloh: typo
add the Ohloh API, http://www.ohloh.net
CouchDB: an alternate description (still incomplete)
spore2dot: add a detailed generation
Github: rename some methods s/^get_/list_/;
Github/network: missing params
Diffstat (limited to 'services')
| -rw-r--r-- | services/Makefile | 2 | ||||
| -rw-r--r-- | services/github.json | 62 | ||||
| -rw-r--r-- | services/github.png | bin | 199198 -> 192731 bytes | |||
| -rw-r--r-- | services/github/commit.json | 6 | ||||
| -rw-r--r-- | services/github/gist.json | 4 | ||||
| -rw-r--r-- | services/github/github.png | bin | 195024 -> 196502 bytes | |||
| -rw-r--r-- | services/github/issue.json | 10 | ||||
| -rw-r--r-- | services/github/network.json | 8 | ||||
| -rw-r--r-- | services/github/object.json | 10 | ||||
| -rw-r--r-- | services/github/repository.json | 24 | ||||
| -rw-r--r-- | services/github/user.json | 12 | ||||
| -rw-r--r-- | services/ohloh.json | 292 | ||||
| -rw-r--r-- | services/ohloh.png | bin | 0 -> 85913 bytes |
13 files changed, 366 insertions, 64 deletions
diff --git a/services/Makefile b/services/Makefile index 0e0835f..dbca662 100644 --- a/services/Makefile +++ b/services/Makefile @@ -7,6 +7,7 @@ check: spore_validation.rx @$(VALIDATOR) backtype.json @$(VALIDATOR) github.json @$(VALIDATOR) ihackernews.json + @$(VALIDATOR) ohloh.json @$(VALIDATOR) twitter.json test: check @@ -19,6 +20,7 @@ png: \ backtype.png \ github.png \ ihackernews.png \ + ohloh.png \ twitter.png @make -C github png diff --git a/services/github.json b/services/github.json index 66c1369..a58481a 100644 --- a/services/github.json +++ b/services/github.json @@ -1,6 +1,6 @@ { "base_url" : "http://github.com/api/v2/", - "version" : "0.3", + "version" : "0.4", "methods" : { "user_search" : { "path" : "/:format/user/search/:search", @@ -49,7 +49,7 @@ ], "authentication" : true }, - "get_following" : { + "list_following" : { "path" : "/:format/user/show/:user/following", "method" : "GET", "required_params" : [ @@ -57,7 +57,7 @@ "user" ] }, - "get_followers" : { + "list_followers" : { "path" : "/:format/user/show/:user/followers", "method" : "GET", "required_params" : [ @@ -83,7 +83,7 @@ ], "authentication" : true }, - "get_watched_repos" : { + "list_watched_repos" : { "path" : "/:format/repos/watched/:user", "method" : "GET", "required_params" : [ @@ -91,7 +91,7 @@ "user" ] }, - "get_keys" : { + "list_keys" : { "path" : "/:format/user/keys", "method" : "GET", "required_params" : [ @@ -125,7 +125,7 @@ ], "authentication" : true }, - "get_emails" : { + "list_emails" : { "path" : "/:format/user/emails", "method" : "GET", "required_params" : [ @@ -169,7 +169,7 @@ "search_term" ] }, - "get_issues" : { + "list_issues" : { "path" : "/:format/issues/list/:user/:repo/:state", "method" : "GET", "required_params" : [ @@ -179,7 +179,7 @@ "state" ] }, - "get_issues_by_label" : { + "list_issues_by_label" : { "path" : "/:format/issues/list/:user/:repo/label/:label", "method" : "GET", "required_params" : [ @@ -199,7 +199,7 @@ "number" ] }, - "get_comments" : { + "list_comments" : { "path" : "/:format/issues/comments/:user/:repo/:number", "method" : "GET", "required_params" : [ @@ -268,7 +268,7 @@ ], "authentication" : true }, - "get_labels" : { + "list_labels" : { "path" : "/:format/issues/labels/:user/:repo", "method" : "GET", "required_params" : [ @@ -335,7 +335,7 @@ "filename" ] }, - "get_gists" : { + "list_gists" : { "base_url" : "http://gist.github.com/api/v1/", "path" : "/:format/gists/:login", "method" : "GET", @@ -353,13 +353,17 @@ "repo" ] }, - "get_network_data" : { + "list_network_data" : { "path" : "/:user/:repo/network_data_chunk", "method" : "GET", "required_params" : [ "user", "repo", "nethash" + ], + "optional_params" : [ + "start", + "end" ] }, @@ -408,7 +412,7 @@ ], "authentication" : true }, - "get_repos" : { + "list_repos" : { "path" : "/:format/repos/show/:user", "method" : "GET", "required_params" : [ @@ -496,7 +500,7 @@ ], "authentication" : true }, - "get_repo_keys" : { + "list_repo_keys" : { "path" : "/:format/repos/keys/:user/:repo", "method" : "GET", "required_params" : [ @@ -536,7 +540,7 @@ ], "authentication" : true }, - "get_collaborators" : { + "list_collaborators" : { "path" : "/:format/repos/show/:user/:repo/collaborators", "method" : "GET", "required_params" : [ @@ -568,7 +572,7 @@ ], "authentication" : true }, - "get_pushable" : { + "list_pushable" : { "path" : "/:format/repos/pushable", "method" : "GET", "required_params" : [ @@ -576,7 +580,7 @@ ], "authentication" : true }, - "get_contributors" : { + "list_contributors" : { "path" : "/:format/repos/show/:user/:repo/contributors", "method" : "GET", "required_params" : [ @@ -585,7 +589,7 @@ "repo" ] }, - "get_anon_contributors" : { + "list_anon_contributors" : { "path" : "/:format/repos/show/:user/:repo/contributors/anon", "method" : "GET", "required_params" : [ @@ -594,7 +598,7 @@ "repo" ] }, - "get_watchers" : { + "list_watchers" : { "path" : "/:format/repos/show/:user/:repo/watchers", "method" : "GET", "required_params" : [ @@ -603,7 +607,7 @@ "repo" ] }, - "get_network" : { + "list_network" : { "path" : "/:format/repos/show/:user/:repo/network", "method" : "GET", "required_params" : [ @@ -612,7 +616,7 @@ "repo" ] }, - "get_languages" : { + "list_languages" : { "path" : "/:format/repos/show/:user/:repo/languages", "method" : "GET", "required_params" : [ @@ -621,7 +625,7 @@ "repo" ] }, - "get_tags" : { + "list_tags" : { "path" : "/:format/repos/show/:user/:repo/tags", "method" : "GET", "required_params" : [ @@ -630,7 +634,7 @@ "repo" ] }, - "get_branches" : { + "list_branches" : { "path" : "/:format/repos/show/:user/:repo/branches", "method" : "GET", "required_params" : [ @@ -640,7 +644,7 @@ ] }, - "get_commits" : { + "list_commits" : { "path" : "/:format/commits/list/:user/:repo/:branch", "method" : "GET", "required_params" : [ @@ -650,7 +654,7 @@ "branch" ] }, - "get_file_commits" : { + "list_file_commits" : { "path" : "/:format/commits/list/:user/:repo/:branch/:path", "method" : "GET", "required_params" : [ @@ -672,7 +676,7 @@ ] }, - "get_tree" : { + "list_tree" : { "path" : "/:format/tree/show/:user/:repo/:tree_sha", "method" : "GET", "required_params" : [ @@ -696,7 +700,7 @@ "meta" ] }, - "get_blobs" : { + "list_blobs" : { "path" : "/:format/blob/all/:user/:repo/:tree_sha", "method" : "GET", "required_params" : [ @@ -706,7 +710,7 @@ "sha" ] }, - "get_full_blobs" : { + "list_full_blobs" : { "path" : "/:format/blob/full/:user/:repo/:tree_sha", "method" : "GET", "required_params" : [ @@ -716,7 +720,7 @@ "tree_sha" ] }, - "get_full_tree" : { + "list_full_tree" : { "path" : "/:format/tree/full/:user/:repo/:tree_sha", "method" : "GET", "required_params" : [ diff --git a/services/github.png b/services/github.png Binary files differindex 96ff922..d128b2c 100644 --- a/services/github.png +++ b/services/github.png diff --git a/services/github/commit.json b/services/github/commit.json index 8fe4823..3abd9e8 100644 --- a/services/github/commit.json +++ b/services/github/commit.json @@ -1,8 +1,8 @@ { "base_url" : "http://github.com/api/v2/", - "version" : "0.3", + "version" : "0.4", "methods" : { - "get_commits" : { + "list_commits" : { "path" : "/:format/commits/list/:user/:repo/:branch", "method" : "GET", "required_params" : [ @@ -12,7 +12,7 @@ "branch" ] }, - "get_file_commits" : { + "list_file_commits" : { "path" : "/:format/commits/list/:user/:repo/:branch/:path", "method" : "GET", "required_params" : [ diff --git a/services/github/gist.json b/services/github/gist.json index c10949f..3cc7614 100644 --- a/services/github/gist.json +++ b/services/github/gist.json @@ -1,6 +1,6 @@ { "base_url" : "http://gist.github.com/api/v1/", - "version" : "0.3", + "version" : "0.4", "methods" : { "get_gist_info" : { "path" : "/:format/:gist_id", @@ -19,7 +19,7 @@ "filename" ] }, - "get_gists" : { + "list_gists" : { "path" : "/:format/gists/:login", "method" : "GET", "required_params" : [ diff --git a/services/github/github.png b/services/github/github.png Binary files differindex 1d2b070..103c83e 100644 --- a/services/github/github.png +++ b/services/github/github.png diff --git a/services/github/issue.json b/services/github/issue.json index f574c01..e269a24 100644 --- a/services/github/issue.json +++ b/services/github/issue.json @@ -1,6 +1,6 @@ { "base_url" : "http://github.com/api/v2/", - "version" : "0.3", + "version" : "0.4", "methods" : { "issue_search" : { "path" : "/:format/issues/search/:user/:repo/:state/:search_term", @@ -13,7 +13,7 @@ "search_term" ] }, - "get_issues" : { + "list_issues" : { "path" : "/:format/issues/list/:user/:repo/:state", "method" : "GET", "required_params" : [ @@ -23,7 +23,7 @@ "state" ] }, - "get_issues_by_label" : { + "list_issues_by_label" : { "path" : "/:format/issues/list/:user/:repo/label/:label", "method" : "GET", "required_params" : [ @@ -43,7 +43,7 @@ "number" ] }, - "get_comments" : { + "list_comments" : { "path" : "/:format/issues/comments/:user/:repo/:number", "method" : "GET", "required_params" : [ @@ -112,7 +112,7 @@ ], "authentication" : true }, - "get_labels" : { + "list_labels" : { "path" : "/:format/issues/labels/:user/:repo", "method" : "GET", "required_params" : [ diff --git a/services/github/network.json b/services/github/network.json index 2833783..bb8792d 100644 --- a/services/github/network.json +++ b/services/github/network.json @@ -1,6 +1,6 @@ { "base_url" : "http://github.com/api/v2/", - "version" : "0.3", + "version" : "0.4", "methods" : { "get_network_meta" : { "path" : "/:user/:repo/network_meta", @@ -10,13 +10,17 @@ "repo" ] }, - "get_network_data" : { + "list_network_data" : { "path" : "/:user/:repo/network_data_chunk", "method" : "GET", "required_params" : [ "user", "repo", "nethash" + ], + "optional_params" : [ + "start", + "end" ] } }, diff --git a/services/github/object.json b/services/github/object.json index 8891242..08ece21 100644 --- a/services/github/object.json +++ b/services/github/object.json @@ -1,8 +1,8 @@ { "base_url" : "http://github.com/api/v2/", - "version" : "0.3", + "version" : "0.4", "methods" : { - "get_tree" : { + "list_tree" : { "path" : "/:format/tree/show/:user/:repo/:tree_sha", "method" : "GET", "required_params" : [ @@ -26,7 +26,7 @@ "meta" ] }, - "get_blobs" : { + "list_blobs" : { "path" : "/:format/blob/all/:user/:repo/:tree_sha", "method" : "GET", "required_params" : [ @@ -36,7 +36,7 @@ "sha" ] }, - "get_full_blobs" : { + "list_full_blobs" : { "path" : "/:format/blob/full/:user/:repo/:tree_sha", "method" : "GET", "required_params" : [ @@ -46,7 +46,7 @@ "tree_sha" ] }, - "get_full_tree" : { + "list_full_tree" : { "path" : "/:format/tree/full/:user/:repo/:tree_sha", "method" : "GET", "required_params" : [ diff --git a/services/github/repository.json b/services/github/repository.json index 85c5246..d106c56 100644 --- a/services/github/repository.json +++ b/services/github/repository.json @@ -1,6 +1,6 @@ { "base_url" : "http://github.com/api/v2/", - "version" : "0.3", + "version" : "0.4", "methods" : { "repo_search" : { "path" : "/:format/repos/search/:q", @@ -47,7 +47,7 @@ ], "authentication" : true }, - "get_repos" : { + "list_repos" : { "path" : "/:format/repos/show/:user", "method" : "GET", "required_params" : [ @@ -135,7 +135,7 @@ ], "authentication" : true }, - "get_repo_keys" : { + "list_repo_keys" : { "path" : "/:format/repos/keys/:user/:repo", "method" : "GET", "required_params" : [ @@ -175,7 +175,7 @@ ], "authentication" : true }, - "get_collaborators" : { + "list_collaborators" : { "path" : "/:format/repos/show/:user/:repo/collaborators", "method" : "GET", "required_params" : [ @@ -207,7 +207,7 @@ ], "authentication" : true }, - "get_pushable" : { + "list_pushable" : { "path" : "/:format/repos/pushable", "method" : "GET", "required_params" : [ @@ -215,7 +215,7 @@ ], "authentication" : true }, - "get_contributors" : { + "list_contributors" : { "path" : "/:format/repos/show/:user/:repo/contributors", "method" : "GET", "required_params" : [ @@ -224,7 +224,7 @@ "repo" ] }, - "get_anon_contributors" : { + "list_anon_contributors" : { "path" : "/:format/repos/show/:user/:repo/contributors/anon", "method" : "GET", "required_params" : [ @@ -233,7 +233,7 @@ "repo" ] }, - "get_watchers" : { + "list_watchers" : { "path" : "/:format/repos/show/:user/:repo/watchers", "method" : "GET", "required_params" : [ @@ -242,7 +242,7 @@ "repo" ] }, - "get_network" : { + "list_network" : { "path" : "/:format/repos/show/:user/:repo/network", "method" : "GET", "required_params" : [ @@ -251,7 +251,7 @@ "repo" ] }, - "get_languages" : { + "list_languages" : { "path" : "/:format/repos/show/:user/:repo/languages", "method" : "GET", "required_params" : [ @@ -260,7 +260,7 @@ "repo" ] }, - "get_tags" : { + "list_tags" : { "path" : "/:format/repos/show/:user/:repo/tags", "method" : "GET", "required_params" : [ @@ -269,7 +269,7 @@ "repo" ] }, - "get_branches" : { + "list_branches" : { "path" : "/:format/repos/show/:user/:repo/branches", "method" : "GET", "required_params" : [ diff --git a/services/github/user.json b/services/github/user.json index 60a1875..5f5399e 100644 --- a/services/github/user.json +++ b/services/github/user.json @@ -1,6 +1,6 @@ { "base_url" : "http://github.com/api/v2/", - "version" : "0.3", + "version" : "0.4", "methods" : { "user_search" : { "path" : "/:format/user/search/:search", @@ -49,7 +49,7 @@ ], "authentication" : true }, - "get_following" : { + "list_following" : { "path" : "/:format/user/show/:user/following", "method" : "GET", "required_params" : [ @@ -57,7 +57,7 @@ "user" ] }, - "get_followers" : { + "list_followers" : { "path" : "/:format/user/show/:user/followers", "method" : "GET", "required_params" : [ @@ -83,7 +83,7 @@ ], "authentication" : true }, - "get_watched_repos" : { + "list_watched_repos" : { "path" : "/:format/repos/watched/:user", "method" : "GET", "required_params" : [ @@ -91,7 +91,7 @@ "user" ] }, - "get_keys" : { + "list_keys" : { "path" : "/:format/user/keys", "method" : "GET", "required_params" : [ @@ -125,7 +125,7 @@ ], "authentication" : true }, - "get_emails" : { + "list_emails" : { "path" : "/:format/user/emails", "method" : "GET", "required_params" : [ diff --git a/services/ohloh.json b/services/ohloh.json new file mode 100644 index 0000000..9152586 --- /dev/null +++ b/services/ohloh.json @@ -0,0 +1,292 @@ +{ + "name" : "Ohloh", + "version" : "0.1", + "base_url" : "http://www.ohloh.net", + "methods" : { + "get_account" : { + "path" : "/accounts/:account_id.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "account_id" + ] + }, + "list_accounts" : { + "path" : "/accounts.xml", + "method" : "GET", + "required_params" : [ + "api_key" + ], + "optional_params" : [ + "query", + "sort", + "page" + ] + }, + + "list_activity_facts" : { + "path" : "/projects/:project_id/analyses/:analysis_id/activity_facts.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id", + "analysis_id" + ] + }, + "list_latest_activity_facts" : { + "path" : "/projects/:project_id/analyses/latest/activity_facts.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id" + ] + }, + + "get_analysis" : { + "path" : "/projects/:project_id/analyses/:analysis_id.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id", + "analysis_id" + ] + }, + "get_latest_analysis" : { + "path" : "/projects/:project_id/analyses/latest.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id" + ] + }, + + "get_contributor_fact" : { + "path" : "/projects/:project_id/contributors/:contributor_id.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id", + "contributor_id" + ] + }, + "list_contributor_facts" : { + "path" : "/projects/:project_id/contributors.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id" + ] + }, + + "list_contributor_language_facts" : { + "path" : "/projects/:project_id/contributors/:contributor_id.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id", + "contributor_id" + ] + }, + + "get_enlistment" : { + "path" : "projects/:project_id/enlistment/:enlistment_id.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id", + "enlistment_id" + ] + }, + "list_enlistments" : { + "path" : "projects/:project_id/enlistments.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id" + ], + "optional_params" : [ + "query", + "sort", + "page" + ] + }, + + "get_factoid" : { + "path" : "projects/:project_id/factoids/:factoid_id.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id", + "factoid_id" + ] + }, + "list_factoids" : { + "path" : "projects/:project_id/factoids.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id" + ] + }, + + "list_kudos" : { + "path" : "/accounts/:account_id/kudos.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "account_id" + ] + }, + "list_kudos_sent" : { + "path" : "/accounts/:account_id/kudos/sent.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "account_id" + ] + }, + + "get_language" : { + "path" : "/languages/:language_id.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "language_id" + ] + }, + "list_languages" : { + "path" : "/languages.xml", + "method" : "GET", + "required_params" : [ + "api_key" + ], + "optional_params" : [ + "query", + "sort", + "page" + ] + }, + + "get_message" : { + "path" : "/accounts/:account_id/messages/:message_id.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "account_id", + "message_id" + ] + }, + "list_messages_by_account" : { + "path" : "/accounts/:account_id/messages.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "account_id" + ] + }, + "list_messages_by_project" : { + "path" : "/projects/:project_id/messages.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id" + ] + }, + "create_message" : { + "path" : "/accounts/me/messages.xml", + "method" : "POST", + "form-data" : { + "message[body]" : ":body" + }, + "required_params" : [ + "body" + ], + "authentication" : true + }, + + "list_news" : { + "path" : "/accounts/:account_id/news.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "account_id" + ] + }, + + "get_project" : { + "path" : "/projects/:project_id.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id" + ] + }, + "list_projects" : { + "path" : "/projects.xml", + "method" : "GET", + "required_params" : [ + "api_key" + ], + "optional_params" : [ + "query", + "sort", + "page" + ] + }, + + "list_size_facts" : { + "path" : "/projects/:project_id/analyses/:analysis_id/size_facts.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id", + "analysis_id" + ] + }, + "list_latest_size_facts" : { + "path" : "/projects/:project_id/analyses/latest/size_facts.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id" + ] + }, + + "get_stack" : { + "path" : "/accounts/:account_id/stacks/:stack_id.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "account_id", + "stack_id" + ] + }, + "get_default_stack" : { + "path" : "/accounts/:account_id/stacks/default.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "account_id" + ] + }, + "list_stacks" : { + "path" : "/projects/:project_id/stacks.xml", + "method" : "GET", + "required_params" : [ + "api_key", + "project_id" + ], + "optional_params" : [ + "query", + "sort", + "page" + ] + } + }, + "expected_status" : [ 200, 400 ], + "formats" : [ "xml" ], + "authority" : "http://github.com/SPORE", + "meta" : { + "documentation" : "http://www.ohloh.net/api/getting_started" + } +} diff --git a/services/ohloh.png b/services/ohloh.png Binary files differnew file mode 100644 index 0000000..3fdef1b --- /dev/null +++ b/services/ohloh.png |
