Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
11ab6920
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
11ab6920
编写于
10月 21, 2022
作者:
O
openharmony_ci
提交者:
Gitee
10月 21, 2022
浏览文件
操作
浏览文件
下载
差异文件
!10845 modify account api docs
Merge pull request !10845 from jidong/dev_101903
上级
2a127cb9
bd51e500
变更
5
展开全部
隐藏空白更改
内联
并排
Showing
5 changed file
with
2268 addition
and
1721 deletion
+2268
-1721
zh-cn/application-dev/reference/apis/js-apis-appAccount.md
zh-cn/application-dev/reference/apis/js-apis-appAccount.md
+1570
-1445
zh-cn/application-dev/reference/apis/js-apis-distributed-account.md
...ication-dev/reference/apis/js-apis-distributed-account.md
+19
-25
zh-cn/application-dev/reference/apis/js-apis-osAccount.md
zh-cn/application-dev/reference/apis/js-apis-osAccount.md
+487
-103
zh-cn/application-dev/reference/errorcodes/errcode-Account.md
...n/application-dev/reference/errorcodes/errcode-Account.md
+175
-74
zh-cn/application-dev/reference/errorcodes/errorcode-app-account.md
...ication-dev/reference/errorcodes/errorcode-app-account.md
+17
-74
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-appAccount.md
浏览文件 @
11ab6920
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-distributed-account.md
浏览文件 @
11ab6920
...
...
@@ -54,20 +54,18 @@ getOsAccountDistributedInfo(callback: AsyncCallback<DistributedInfo>): voi
**错误码:**
| 错误码ID | 错误信息|
| ------- | -------|
| 201 | permission denied. |
| 401 | the parameter check failed. |
| 12300001 | system service exception. |
| 错误码ID | 错误信息|
| -------- | ------------------- |
| 12300001 | System service exception. |
**示例:**
```
js
const
accountAbility
=
account_distributedAccount
.
getDistributedAccountAbility
();
try
{
accountAbility
.
getOsAccountDistributedInfo
((
err
,
data
)
=>
{
console
.
log
(
"
getOsAccountDistributedInfo err:
"
+
JSON
.
stringify
(
err
));
console
.
log
(
'
Query account info name:
'
+
data
.
name
);
console
.
log
(
'
Query account info id:
'
+
data
.
id
);
console
.
log
(
"
getOsAccountDistributedInfo err:
"
+
JSON
.
stringify
(
err
));
console
.
log
(
'
Query account info name:
'
+
data
.
name
);
console
.
log
(
'
Query account info id:
'
+
data
.
id
);
});
}
catch
(
e
)
{
console
.
log
(
"
getOsAccountDistributedInfo exception:
"
+
JSON
.
stringify
(
e
));
...
...
@@ -92,11 +90,9 @@ getOsAccountDistributedInfo(): Promise<DistributedInfo>
**错误码:**
| 错误码ID | 错误信息|
| ------- | -------|
| 201 | permission denied. |
| 401 | the parameter check failed. |
| 12300001 | system service exception. |
| 错误码ID | 错误信息|
| -------- | ------------------- |
| 12300001 | System service exception. |
**示例:**
```
js
...
...
@@ -146,6 +142,7 @@ queryOsAccountDistributedInfo(callback: AsyncCallback<DistributedInfo>): v
queryOsAccountDistributedInfo(): Promise
<
DistributedInfo
>
获取分布式帐号信息。使用Promise异步回调。
> **说明:** 从API version 9开始废弃,建议使用[getOsAccountDistributedInfo](#getosaccountdistributedinfo9-1)
>
> 从 API version 7开始支持。
...
...
@@ -190,12 +187,10 @@ setOsAccountDistributedInfo(accountInfo: DistributedInfo, callback: AsyncCallbac
**错误码:**
| 错误码ID | 错误信息|
| ------- | -------|
| 201 | permission denied. |
| 401 | the parameter check failed. |
| 12300001 | system service exception. |
| 12300002 | invalid accountInfo. |
| 错误码ID | 错误信息|
| -------- | ------------------- |
| 12300001 | System service exception. |
| 12300002 | invalid accountInfo. |
**示例:**
```
js
...
...
@@ -234,12 +229,10 @@ setOsAccountDistributedInfo(accountInfo: DistributedInfo): Promise<void>
**错误码:**
| 错误码ID | 错误信息|
| ------- | -------|
| 201 | permission denied. |
| 401 | the parameter check failed. |
| 12300001 | system service exception. |
| 12300002 | invalid accountInfo. |
| 错误码ID | 错误信息|
| -------- | ------------------- |
| 12300001 | System service exception. |
| 12300002 | invalid accountInfo. |
**示例:**
```
js
...
...
@@ -260,6 +253,7 @@ setOsAccountDistributedInfo(accountInfo: DistributedInfo): Promise<void>
updateOsAccountDistributedInfo(accountInfo: DistributedInfo, callback: AsyncCallback
<
void
>
): void
更新分布式帐号信息。使用callback异步回调。
> **说明:** 从API version 9开始废弃,建议使用[setOsAccountDistributedInfo](#setosaccountdistributedinfo9)
>
> 从 API version 7开始支持。
...
...
zh-cn/application-dev/reference/apis/js-apis-osAccount.md
浏览文件 @
11ab6920
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/errorcodes/errcode-Account.md
浏览文件 @
11ab6920
# Account错误码
以下错误码包括系统帐号
和分布式
帐号错误码。
以下错误码包括系统帐号
、分布式帐号和应用
帐号错误码。
## 12300001 系统服务异常
...
...
@@ -37,7 +37,7 @@ Invalid parameter.
1.
用户名为空。
2.
系统帐号用户名长度大于1024。
3.
分布式帐号用户名长度大于256。
4.
系统帐号id小于0、小于100或大于10
00
。
4.
系统帐号id小于0、小于100或大于10
99
。
5.
分布式帐号id长度大于512。
6.
分布式帐号传入不支持的事件类型。
7.
域名为空。
...
...
@@ -55,6 +55,9 @@ Invalid parameter.
19.
令牌长度超过1024。
20.
键名长度超过1024。
21.
自定义数据值长度超过1024。
22.
无效的令牌。
23.
无效的上下文标识。
24.
无效的凭据标识。
**处理步骤**
...
...
@@ -85,82 +88,82 @@ The account does not exist.
请检查帐号是否存在。
## 12300004
操作受限帐号
## 12300004
帐号已存在
**错误信息**
The
specified account is restricted
.
The
account already exists
.
**可能原因**
该错误码表示操作的是受限帐号,可能原因如下:
1.
删除系统保留用户。
2.
查询系统保留用户的约束源类型。
3.
创建id为0-100的帐号。
该错误码表示帐号已存在,可能原因如下:
创建已存在的帐号。
**处理步骤**
指定id为系统保留用户,无法操作
。
请取消创建,或使用其他账户号名重试
。
## 12300005
监听器已注册
## 12300005
不支持多用户
**错误信息**
The listener has been register
ed.
Multi-user is not support
ed.
**可能原因**
该错误码表示
监听器已注册
,可能原因如下:
当前
应用向系统注册一个已经注册过的监听器,无法重复注册。
该错误码表示
不支持多用户
,可能原因如下:
当前
设备不支持多用户,无法创建帐号
**处理步骤**
请取消注册,或使用未注册过的监听器重新注册。
无法创建其他帐号,请取消创建
## 12300006
监听器未注册
## 12300006
不支持的帐号类型
**错误信息**
The
Listener is not register
ed.
The
account type is not support
ed.
**可能原因**
该错误码表示
监听器未注册
,可能原因如下:
解注册一个未注册过的监听器。
该错误码表示
提供了不支持的帐号类型
,可能原因如下:
当前设备不支持创建指定类型的帐号
**处理步骤**
请
使用注册的监听器执行解注册操作
请
创建其他类型的帐号
## 12300007
PIN码输入器已注册
## 12300007
帐号数量已达上限
**错误信息**
The
PIN inputer already exists.
The
account number has reached the upper limit.
**可能原因**
该错误码表示
PIN码输入器已注册
,可能原因如下:
PIN码输入器已注册,解注册之前无法重复注册
。
该错误码表示
帐号数量已达上限
,可能原因如下:
创建系统帐号/应用帐号时,已存在1000个帐号
。
**处理步骤**
PIN码输入器已存在,请勿重复操作
。
请删除其他帐号后再创建
。
## 12300008
帐号已存在
## 12300008
受限的帐号
**错误信息**
The
account already exists
.
The
specified account is restricted
.
**可能原因**
该错误码表示帐号已存在,可能原因如下:
创建已存在的帐号。
该错误码表示操作的是受限帐号,可能原因如下:
1.
删除系统保留用户。
2.
查询系统保留用户的约束源类型。
3.
创建id为0-100的帐号。
**处理步骤**
请取消创建,或使用其他账户号名重试
。
指定id为系统保留用户,无法操作
。
## 12300009 帐号已激活
...
...
@@ -177,7 +180,7 @@ The account has been activated.
当前帐号已激活,请勿重复操作。
## 12300010 帐号服务忙
## 12300010 帐号服务忙
碌
**错误信息**
...
...
@@ -193,52 +196,101 @@ The account service is busy.
请等待一段时间后重试,并降低调用频率。
## 12300011
帐号数量已达上限
## 12300011
事件监听器已注册
**错误信息**
The
account number has reached the upper limit.
The
event listener has been registered.
**可能原因**
该错误码表示
帐号数量已达上限
,可能原因如下:
创建系统帐号/应用帐号时,已存在1000个帐号
。
该错误码表示
监听器已注册
,可能原因如下:
当前应用向系统注册一个已经注册过的监听器,无法重复注册
。
**处理步骤**
请
删除其他帐号后再创建
。
请
取消注册,或使用未注册过的监听器重新注册
。
## 12300012
不支持多用户
## 12300012
事件监听器未注册
**错误信息**
Multi-user is not support
ed.
The event listener has not been register
ed.
**可能原因**
该错误码表示
不支持多用户
,可能原因如下:
当前设备不支持多用户,无法创建帐号
该错误码表示
监听器未注册
,可能原因如下:
解注册一个未注册过的监听器。
**处理步骤**
无法创建其他帐号,请取消创建
请使用注册的监听器执行解注册操作
## 12300
013 不支持的帐号类型
## 12300
101 凭据不正确
**错误信息**
The
account type is not supported
.
The
credential is incorrect
.
**可能原因**
该错误码表示提供了不支持的帐号类型,可能原因如下:
当前设备不支持创建管理员帐号
该错误码表示凭据不正确,可能原因如下:
1.
密码输入错误;
2.
生物特征不匹配;
2.
令牌失效;
**处理步骤**
请输入正确有效的凭据重试。
## 12300102 凭据不存在
**错误信息**
The credential does not exist.
**可能原因**
该错误码表示凭据不存在,可能原因如下:
1.
认证未录入的凭据类型。
2.
查询未录入的凭据类型。
3.
删除未录入的凭据类型。
**处理步骤**
请确认凭据类型是否存在。
## 12300103 凭据输入器已注册
**错误信息**
The crdential inputer already exists.
**可能原因**
该错误码表示凭据输入器已注册,可能原因如下:
PIN码输入器已注册,解注册之前无法重复注册。
**处理步骤**
请创建非管理员帐号
凭据输入器已存在,请勿重复操作。
## 12300014 可信等级不支持
## 12300104 凭据输入器不存在
**错误信息**
The crdential inputer not found.
**可能原因**
该错误码表示凭据输入器不存在,可能原因如下:
认证、添加、修改凭据时,未注册凭据输入器。
**处理步骤**
注册凭据输入器。
## 12300105 可信等级不支持
**错误信息**
...
...
@@ -253,7 +305,7 @@ The trust level is not supported.
请输入正确的可信等级。
## 12300
015
认证类型不支持
## 12300
106
认证类型不支持
**错误信息**
...
...
@@ -268,81 +320,130 @@ The auth type is not supported.
请提供系统支持的认证类型。
## 123000
16 认证超时
## 123000
07 认证类型不存在
**错误信息**
The auth service is timeout.
The auth type does not exist.
**可能原因**
该错误码表示认证类型不存在,可能原因如下:
查询/删除令牌时,指定的鉴权类型不存在。
**处理步骤**
请使用存在的认证类型查询/删除。
## 12300008 认证会话不存在
**错误信息**
The authentication session does not exist.
**可能原因**
该错误码表示
认证超时
,可能原因如下:
1.
认证录入超过三分钟。
2.
认证服务因网络原因无法及时响应而超时
。
该错误码表示
会话不存在
,可能原因如下:
查询不存在的会话回调
。
**处理步骤**
1.
认证录入超时,请重试。
2.
请确认网络环境无问题后重试。
请使用已成功打开的会话标识查询会话回调。
## 12300
017 认证服务忙
## 12300
109 认证被取消
**错误信息**
The auth
service is busy
.
The auth
entication is canceled
.
**可能原因**
该错误码表示认证
服务忙
,可能原因如下:
认证
总数超过5个
。
该错误码表示认证
被取消
,可能原因如下:
认证
过程中,用户取消认证操作
。
**处理步骤**
当前认证服务忙,请稍后重试
。
重新或结束认证操作
。
## 12300
018 认证服务
锁定
## 12300
110 认证被
锁定
**错误信息**
The auth
service
is locked.
The auth
entication
is locked.
**可能原因**
该错误码表示认证
服务
锁定,可能原因如下:
该错误码表示认证
被
锁定,可能原因如下:
认证类型错误次数超过上限。
**处理步骤**
认证错误次数超过上限,请在freezingTime之后重试。
## 12300
019 凭据不存在
## 12300
111 认证超时
**错误信息**
The
credential does not exis
t.
The
authentication is timeou
t.
**可能原因**
该错误码表示凭据不存在,可能原因如下:
1.
认证未录入的凭据类型。
2.
查询未录入的凭据类型。
3.
删除未录入的凭据类型。
该错误码表示认证超时,可能原因如下:
1.
对于系统帐号,认证、录入超过三分钟。
2.
认证服务因网络原因无法及时响应而超时。
**处理步骤**
请确认凭据类型是否存在。
1.
认证录入超时,请重试。
2.
请确认网络环境无问题后重试。
## 12300112 认证服务忙
**错误信息**
The auth service is busy.
**可能原因**
该错误码表示认证服务忙,可能原因如下:
系统帐号认证时,认证总数超过5个。
应用帐号认证时,三方应用的认证器服务忙碌(根据实际情况决定)。
**处理步骤**
当前认证服务忙,请稍后重试。
## 12300
020 无效的contextId
## 12300
113 认证服务不存在
**错误信息**
The contextId is invalid.
The account authenticator service does not exist.
**可能原因**
该错误码表示认证服务不存在,可能原因如下:
对于应用帐号:
1.
请求鉴权时,帐号所属应用不支持认证器服务。
2.
隐式添加帐号时,帐号所属应用不支持认证器服务。
3.
验证指定帐号的凭据时,该帐号所属应用不支持认证器服务。
4.
设置应用的认证器属性时,指定的应用不支持认证器服务。
5.
检查帐号标签时,指定的应用不支持认证器服务。
**处理步骤**
请取消操作,或向支持认证服务的应用进行认证。
## 12300114 认证服务异常
**错误信息**
The account authenticator service works abnormally.
**可能原因**
该错误码表示contextId无效,可能原因如下:
传入取消的contexId未发起认证录入或已经完成。
该错误码表示帐号认证服务异常,可能原因如下:
1.
身份认证服务出现未知错误;
2.
应用认证器不符合规范;
**处理步骤**
请输入正确的contextId。
1.
请重试或重启系统;
2.
按照规范开发应用认证器;
zh-cn/application-dev/reference/errorcodes/errorcode-app-account.md
浏览文件 @
11ab6920
...
...
@@ -16,85 +16,42 @@ The application does not exist.
请取消设置,或使用已安装的应用包名重试。
## 12400002
帐号认证器服务
不存在
## 12400002
自定义数据
不存在
**错误信息**
The account authenticator service does not exist.
**可能原因**
该错误码表示帐号认证器服务不存在,可能原因如下:
1.
请求鉴权时,帐号所属应用不支持认证器服务。
2.
隐式添加帐号时,帐号所属应用不支持认证器服务。
3.
验证指定帐号的凭据时,该帐号所属应用不支持认证器服务。
4.
设置应用的认证器属性时,指定的应用不支持认证器服务。
**处理步骤**
请取消操作,或使用支持认证器服务的应用的包名重试。
## 12400003 帐号认证器服务异常
**错误信息**
The account authenticator service works abnormally.
**可能原因**
该错误码表示帐号认证器服务异常,可能原因如下:
三方应用的鉴权服务接连失败。
**处理步骤**
请重试或重启系统。
## 12400004 鉴权类型不存在
**错误信息**
The custom data does not exist.
The auth type does not exist.
**可能原因**
该错误码表示
鉴权类型
不存在,可能原因如下:
查询
/删除令牌时,指定的鉴权类型
不存在。
该错误码表示
自定义数据
不存在,可能原因如下:
查询
帐号的自定义数据时,输入的键名
不存在。
**处理步骤**
请使用存在的
鉴权类型查询/删除
。
请使用存在的
自定义数据的键名查询
。
## 1240000
5 会话不存在
## 1240000
3 自定义数据的数量已达上限
**错误信息**
The
session does not exis
t.
The
number of custom data reaches upper limi
t.
**可能原因**
该错误码表示会话不存在,可能原因如下:
查询不存在的会话回调。
该错误码表示自定义数据的数量已达上限,可能原因如下:
设置自定义数据时,目标帐号的自定义数据数量已达512。
**处理步骤**
请使用已成功打开的会话标识查询会话回调。
## 12400006 授权列表已达上限
**错误信息**
The size of authorization list reaches upper limit.
**可能原因**
该错误码表示授权列表已达上限,可能原因如下:
设置访问/开放授权时,授权列表的大小超过1024。
**处理步骤**
1.
请取消设置操作,或者撤销已存在的访问/开放授权后再设置。
请取消设置操作,或者删除已存在的自定义数据。
## 1240000
7
令牌数量已达上限
## 1240000
4
令牌数量已达上限
**错误信息**
The number of token reaches upper limit.
**可能原因**
该错误码表示令牌数量已达上限,可能原因如下:
...
...
@@ -104,31 +61,17 @@ The number of token reaches upper limit.
请取消添加操作,或者删除已存在的令牌后再添加。
## 12400008 自定义数据的数量已达上限
**错误信息**
The number of custom data reaches upper limit.
**可能原因**
该错误码表示自定义数据的数量已达上限,可能原因如下:
设置自定义数据时,目标帐号的自定义数据数量已达512。
**处理步骤**
请取消设置操作,或者删除已存在的自定义数据。
## 12400009 自定义数据不存在
## 12400005 授权列表已达上限
**错误信息**
The
custom data does not exis
t.
The
size of authorization list reaches upper limi
t.
**可能原因**
该错误码表示
自定义数据不存在
,可能原因如下:
查询帐号的自定义数据时,输入的键名不存在
。
该错误码表示
授权列表已达上限
,可能原因如下:
设置访问/开放授权时,授权列表的大小超过1024
。
**处理步骤**
请使用存在的自定义数据的键名查询
。
1.
请取消设置操作,或者撤销已存在的访问/开放授权后再设置
。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录