Data centers
Nexconn provides global data centers to support applications with users in different regions.
When creating an application in the Console, you must specify a data center.
- Client SDKs are consistent across data centers. Applications using global data centers must configure the SDK appropriately during integration.
- Different data centers require their corresponding Server API addresses.
- Data cannot be migrated between data centers. Choose your data center carefully.
Choose a Data Center
You can select from the following data centers:
- Singapore (default)
- North America
- Saudi Arabia
Global data centers
Choose the Global Data Center if your application serves international users. The Singapore data center is Nexconn's default global infrastructure. Learn about Nexconn's global access points in Global Access Points.
When using the Global Data Center (Singapore, North America, or Saudi Arabia):
- In the Console, select Singapore, North America, or Saudi Arabia as your data center when creating your application.
- Configure client SDKs to connect to the corresponding global data center by passing the area code during SDK initialization.
- When integrating Server APIs, use the global data center API addresses.
Configure SDK via Area Code
To simplify global data center configuration, Nexconn SDKs encapsulate different data center configurations as area codes. If your App Key uses a global data center, pass the corresponding AreaCode or NCAreaCode value during SDK initialization.
Your App Key's data center must match the client SDK's configured data center.
Android
InitParams params = new InitParams(context, "Singapore_dev_AppKey");
params.setAreaCode(AreaCode.SG);
NCEngine.initialize(params);
iOS
import NexconnChatSDK
let appKey = "Your_AppKey" // example: bos9p5rlcm2ba
let params = InitParams(appKey: appKey)
params.areaCode = .sg
NCEngine.initialize(params)
Web
Import AreaCode from @nexconn/chat and pass the value that matches your App Key's data center. The example below configures the Singapore data center.
import { AreaCode, NCEngine } from '@nexconn/chat';
NCEngine.initialize({
appKey: '<Your-App-Key>',
areaCode: AreaCode.SG,
});
Flutter
Use the public areaCode field during initialization:
await NCEngine.initialize(InitParams(
appKey: '<Your-App-Key>',
areaCode: AreaCode.sg,
));
Use Global Server API Addresses
Your App Key's data center must match the Server API's data center.
If your application uses a global data center, use Nexconn global data center API addresses when calling Server APIs from your application server:
Nexconn Global Data Center Domains:
- Singapore: api.sg-light-api.com (primary), api-b.sg-light-api.com (backup)
- North America: api.us-light-api.com (primary), api-b.us-light-api.com (backup)
- Saudi Arabia: api.sau-light-api.com (primary), api-b.sau-light-api.com (backup)
Code example:
POST /v4/auth/access-token/issue HTTP/1.1
Host: api.sg-light-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/json
{
"userId": "jlk456j5",
"name": "Ironman",
"avatarUrl": "http://abc.com/myportrait.jpg"
}
Global Data Center Features
For applications using global data centers, Nexconn client SDKs provide the following features to better serve international users:
- Android: FCM push notification support
- iOS: iOS CallKit support for VoIP push, enabling incoming call notifications for audio/video scenarios
Global Access Points
Applicable to Chat and Call signaling services.
Global access points are located in over 100 locations worldwide. The combination of active access points may change without notice. Due to equipment maintenance, equipment failures, new access point rollouts, old access point removal, and other events, this list may not accurately reflect currently active access points.
Many of the following cities have multiple access points to support service demand.
-
North America
Ashburn VA, Atlanta GA, Charleston SC, Chicago IL, Council Bluffs IA, Dallas/Fort Worth TX, Denver CO, Las Vegas NV, Lenoir NC, Los Angeles CA, Miami FL, Montreal Quebec Canada, New York City NY, Querétaro Mexico, Salt Lake City UT, San Francisco CA, Seattle WA, The Dalles OR, Toronto Ontario Canada, Tulsa OK
-
South America
Bogotá Colombia, Buenos Aires Argentina, Rio de Janeiro Brazil, Santiago Chile, São Paulo Brazil
-
Europe
Amsterdam Netherlands, Budapest Hungary, Dublin Ireland, Frankfurt Germany, Groningen Netherlands, Hamburg Germany, Hamina Finland, Helsinki Finland, London UK, Madrid Spain, Marseille France, Milan Italy, Munich Germany, Paris France, Prague Czech Republic, Sofia Bulgaria, St. Ghislain Belgium, Stockholm Sweden, Warsaw Poland, Zurich Switzerland
-
Middle East
Fujairah UAE, Muscat Oman
-
Asia Pacific
Changhua County Taiwan China, Chennai India, Hong Kong SAR China, Jakarta Indonesia, Kuala Lumpur Malaysia, Mumbai India, Delhi India, Osaka Japan, Seoul South Korea, Singapore, Taipei Taiwan China, Tokyo Japan
-
Oceania
Sydney Australia, Melbourne Australia
-
Africa
Johannesburg South Africa, Lagos Nigeria, Mombasa Kenya