Hosting Service Resource¶

Added in 2.5

Provides information on registered hosting services.

Review Board has a list of supported remote hosting services for repositories and bug trackers. These hosting services contain the information needed for Review Board to link with any repositories hosted on that service and access content for display in the diff viewer.

This resource allows for querying that list and determining what capabilities of the hosting service can be used by Review Board.

Details¶

Name	`hosting_service`
URI	`/api/hosting-services/{hosting_service_id}/`
Token Policy ID	`hosting_service`
HTTP Methods	GET - Returns information on a particular hosting service.
Parent Resource	Hosting Service List Resource
Child Resources	None
Anonymous Access	Yes, if anonymous site access is enabled

Fields¶

idString	The hosting service’s unique ID.
nameString	The name of the hosting service.
needs_authorizationBoolean	Whether an account must be authorized and linked in order to use this service.
self_hostedBoolean	Whether the service is meant to be self-hosted in the network.
supported_scmtoolsList of String	The list of supported types of repositories.
supports_bug_trackersBoolean	Whether bug trackers are available.
supports_list_remote_repositoriesBoolean	Whether remote repositories on the hosting service can be listed through the API.
supports_repositoriesBoolean	Whether repository linking is supported.
supports_two_factor_authBoolean	Whether two-factor authentication is supported when linking an account.

Links¶

Name	Method	Resource
accounts	GET	Hosting Service Resource
repositories	GET	Hosting Service Resource
self	GET	Hosting Service Resource

HTTP GET¶

Returns information on a particular hosting service.

This will cover the capabilities of the hosting service, and information needed to help link repositories and bug trackers hosted on it.

Errors¶

100 - Does Not ExistHTTP 404 - Not Found	Object does not exist
101 - Permission DeniedHTTP 403 - Forbidden	You don’t have permission for this
103 - Not Logged InHTTP 401 - Unauthorized	You are not logged in

Examples¶

application/vnd.reviewboard.org.hosting-service+json¶

$ curl http://reviews.example.com/api/hosting-services/googlecode/ -H "Accept: application/json"

Vary: Accept, Cookie
ETag: d8b3fb58aa1f06d8f2f85e19f4baf6101f6105b2
Content-Type: application/vnd.reviewboard.org.hosting-service+json
X-Content-Type-Options: nosniff

{
  "hosting_service": {
    "id": "googlecode", 
    "links": {
      "accounts": {
        "href": "http://reviews.example.com/api/hosting-service-accounts/?service=googlecode", 
        "method": "GET"
      }, 
      "repositories": {
        "href": "http://reviews.example.com/api/repositories/?hosting-service=googlecode", 
        "method": "GET"
      }, 
      "self": {
        "href": "http://reviews.example.com/api/hosting-services/googlecode/", 
        "method": "GET"
      }
    }, 
    "name": "Google Code", 
    "needs_authorization": false, 
    "self_hosted": false, 
    "supported_scmtools": [
      "Mercurial", 
      "Subversion"
    ], 
    "supports_bug_trackers": true, 
    "supports_list_remote_repositories": false, 
    "supports_repositories": true, 
    "supports_two_factor_auth": false
  }, 
  "stat": "ok"
}