本文翻译自三星bada的官方文档，通过本文你可以了解bada API的结构和使用方法，以及Privileged API的使用方法。Bada的开放API可以被分为三个层次：非优先的，普通的和系统，对此开发人员有不同的优先级。
bada API参考概览
bada API参考说明了所有bada命名空间，类和方法。Osp是根命名空间，包含bada内的所有其它命名空间。
下面的信息与各个命名空间相关：
| 次命名空间（如果有）；
变量与枚举； 详细说明； 要求的头文件和库； 命名空间概述； 说明 |
下面的部分说明如何使用bada API参考：
| 1. 方法说明结构；
2. 使用API； 3. 使用Privileged API； 4. 使用登陆 |
1．方法说明结构
在各个类的成员功能文件中，说明了使用统一的结构的方法，如下所示：
2．使用API
为了能够使用API，你需要采取以下步骤：
a. 检查所要求的头文件。
为了能在你的项目中使用特定的API，你需要包含它的头文件。所要求的文件列出在bada API Reference中的备注下。例如，如果你的程序使用Osp::App::AppControl类，你必须包括FApp.h，如Osp::App页面上的备注下所示。
b. 在你的源代码中添加所要求的头文件
例如，为了使用Osp::App::AppControl类，你必须在源代码中包含FApp.h 文件，如下所示：
c. 检查所需库
为了能在你的项目中使用特定的API，你还需要包含所要求的库文件。要求的库列出在bada API参考中的备注下。例如，如果你的程序使用Osp::App::AppControl类，你必须添加FApp库，如Osp::App页面上的备注下内容所示。
d. 在你的项目库列表中添加所要求的库。
为了添加库搜索路径和库：
a) 在bada IDE Project Explorer中，右击项目，选择属性；
b) 选择 C/C++ Build > Settings；
c) 在Tool Settings tab中，选择配置，添加库和库搜索路径。
d) 为了添加库，点击Add图标，填写库名称，点击OK。
e) 为了添加库搜索路径，点击Add图标，填写库搜索路径，点击OK
f) 点击Apply，保存更改到项目属性。
3．使用Privileged API
bada API的开放程度不同。有些API被称之为privileged API，处理平台和用户敏感数据。为了能使用privileged API，程序必须在bada开发人员网站上赋值相应的privilege groups。并且，privilege API的使用必须在manifest file中恰当说明。
Bada的开放API可以被分为三个层次：非优先的，普通的和系统。下面的表格包括了相关的信息，及相应的开发人员成员等级。
表：API 优先等级
| 优先等级 | 要求的开发人员成员等级 | 说明 |
| 非优先 | - | 本等级包括使用自由使用的API，而无需任何特别权限。因此，你不需要在bada开发人员网站上赋值privilege group，以能够使用属于这个等级的API。 |
| 普通 | 基本 | 这个等级包括作为bada成员的开发人员才能够使用的API，如果它们在bada开发人员网站上赋值特定的privilege group。 |
| 系统 | 合作伙伴 | 这个等级包括与三星与特定合作关系的开发人员使用的API。 |
每个API的优先等级都在API参考中有所说明。
例如， Osp::Commerce::Store::ItemService::ItemService( void ) constructor 具有系统优先等级，要求你的程序赋值COMMERCE_STORE privilege group，如下所示：
为了使用Osp::Commerce::Store::ItemService::ItemService( void ), 你需要持有在bada开发人员网站上的合作伙伴成员等级，因为constructor的优先等级是系统。
而且，你必须选择bada开发人员网站上的My Applications > Application Manager里的COMMERCE STORE。
从开发人员网站上下载manifest.xml 文件，放入你的项目的根目录中，覆盖现有的manifest file。
注意：如果你开始开发程序了，但是没有包含开发人员网站上定义的设置的manifest.xml文件，你需要在manifest file（从开发人员网站上下载）上创建一个应用程序项目。
4. 使用登陆
程序可以使用sign-in AppControl登录到bada服务器。登陆的过程包括使用认证，这样程序用户必须在bada服务器上有一个用户配置文件，使用密码认证。登录AppControl支持单次的登录，这就意味着用户只需要登录一次，并且可以使用其它程序登陆bada服务器，而不需再次登录。认证保持有效，直到电话被关系。
如果某个方法要求登录，这就显示在先决条件下的API参考中，如下所示。
Precondition:
User should be authenticated.
For more information, see the sign in Application control (Osp::App::APPCONTROL_SIGNIN).
下面是一个使用sign-in AppControl的代码范例：
- void
- MyAppClass::AppControlSignInSample(void)
- {
- ArrayList* pDataList = null;
- AppControl* pAc = AppManager::FindAppControlN(APPCONTROL_SIGNIN,
- OPERATION_SIGNIN);
- if(pAc)
- {
- pAc->Start(null, this);
- delete pAc;
- }
- }