Domain Data Returned by the roles Service
The REST roles service lets you dynamically discover the following types of domains for any NetSuite account.
Type of Domain |
Examples |
---|---|
RESTlet |
https://<accountID>.restlets.netsuite.com |
System |
https://<accountID>.app.netsuite.com |
Web services |
https://<accountID>.suitetalk.api.netsuite.com |
Dynamically discovering these domains is important because they can change for any NetSuite account. They can change because NetSuite hosts accounts in multiple data centers, and your account's location might change. So, any integration with full URLs should include logic for dynamic discovery of these domains. A hard-coded URL might fail.
Account-specific domains are supported for RESTlets, and you can access your RESTlet domain at the following URL, where <123456> is a variable representing your account ID: <123456>.restlets.api.netsuite.com. For more information, see URLs for Account-Specific Domains.
As of 2020.1, when you call the REST roles service on an account specific domain, only the account specific information is returned. All roles are returned for the user, including the Customer Center roles, and any roles created based on the Customer Center role.