RetrieveNetwork

 

NetworkService / RetrieveNetwork

 

Description: Retrieve network by id or guid

URL: http://{your-server-url}/api/v1/core/networks/{networkidOrGuid}

Method: GET

Token Required: True


Request Headers:
currentaccountid: {accountid - optional and default value is user's own account}
content-type: application/json or content-type: application/xml
token: {token}
Required Roles:

Portal Administrator, Account Administrator, Account Owner, Network Administrator

Rights:

Type: Nexus.AppSpace.Service.Contract.Model.Enums.Rights.Rights

Right Require
Network_Management Yes

Request Query Parameters:
Parameter Type Nullable Description
includesubnetwork boolean True include sub networks
includeplayers boolean True include players for the networks
includeplayergroups boolean True include player groups for the networks

Example: http://{your-server-url}/api/v1/core/networks/{networkidOrGuid}?


Response:

Type: Nexus.AppSpace.Service.Contract.Messages.AppSpaceIntegration.v1.Network.NetworkResponse

Parameter Type
Response.Networks Nexus.AppSpace.Service.Contract.Model.DTO.AppSpaceIntegration.v1.Networks.Network[]

The following is an example response Xml body:
<NetworkResponse xmlns="http://schemas.datacontract.org/2004/07/Nexus.AppSpace.Service.Contract.Messages.AppSpaceIntegration.v1.Network" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <DebugMessage xmlns="http://schemas.datacontract.org/2004/07/Nexus.AppSpace.Service.Contract.Messages">String</DebugMessage>
  <Errors xmlns="http://schemas.datacontract.org/2004/07/Nexus.AppSpace.Service.Contract.Messages">
    <Error>
      <Code>String</Code>
      <Message>String</Message>
      <StackTrace>String</StackTrace>
    </Error>
  </Errors>
  <Status xmlns="http://schemas.datacontract.org/2004/07/Nexus.AppSpace.Service.Contract.Messages">Success</Status>
  <Networks xmlns:a="http://schemas.datacontract.org/2004/07/Nexus.AppSpace.Service.Contract.Model.DTO.AppSpaceIntegration.v1.Networks">
    <a:Network>
      <a:AccountId>123</a:AccountId>
      <a:Guid>11111111-1111-1111-1111-111111111111</a:Guid>
      <a:Id>123</a:Id>
      <a:LastUpdate>2014-09-18T11:01:10.8698598Z</a:LastUpdate>
      <a:Name>String</a:Name>
      <a:ParentId>123</a:ParentId>
    </a:Network>
  </Networks>
</NetworkResponse>

The following is an example response Json body:
{
	"DebugMessage":"String",
	"Errors":[
		{
			"Code":"String",
			"Message":"String",
			"StackTrace":"String"
		}
	],
	"Status":1,
	"Networks":[
		{
			"AccountId":123,
			"Guid":"11111111-1111-1111-1111-111111111111",
			"Id":123,
			"LastUpdate":"\/Date(1411038070869)\/",
			"Name":"String",
			"ParentId":123
		}
	]
}