账本API
<span class="x2mdx-ref-breadcrumb-separator">›</span>
<a href="/zh/docs/canton/reference-protobuf-index">Protobuf</a>
<span class="x2mdx-ref-breadcrumb-separator">›</span>
<a href="https://docs.canton.network/reference/protobuf/packages/com-daml-ledger-api-v2-admin">com.daml.ledger.api.v2.admin</a>
<span class="x2mdx-ref-breadcrumb-separator">›</span>
<span>分配ExternalParty</span>
</div>
<div class="x2mdx-ref-hero">
<p class="x2mdx-ref-eyebrow">com.daml.ledger.api.v2.admin</p>
<h1 class="x2mdx-ref-title">分配ExternalParty</h1>
<div class="x2mdx-ref-badges">
<span class="x2mdx-ref-badge x2mdx-ref-badge--protocol">gRPC</span>
<span class="x2mdx-ref-badge x2mdx-ref-badge--linked">自 3.4.0 起</span>
</div>
</div>
<div class="x2mdx-ref-operation-bar">
<span class="x2mdx-ref-operation-method x2mdx-ref-operation-method--rpc">RPC</span>
<code>/com.daml.ledger.api.v2.admin.PartyManagementService/AllocateExternalParty</code>
</div>
## 协议详细信息
<dl class="x2mdx-ref-meta-grid">
<div class="x2mdx-ref-meta-item">
<dt>协议</dt>
<dd>gRPC</dd>
</div>
<div class="x2mdx-ref-meta-item">
<dt>服务</dt>
<dd>派对管理服务</dd>
</div>
<div class="x2mdx-ref-meta-item">
<dt>RPC</dt>
<dd>分配ExternalParty</dd>
</div>
<div class="x2mdx-ref-meta-item">
<dt>客户端流</dt>
<dd>否</dd>
</div>
<div class="x2mdx-ref-meta-item">
<dt>服务器流</dt>
<dd>否</dd>
</div>
</dl>
## 输入
<div class="x2mdx-ref-panel">
<div class="x2mdx-ref-panel-head">
<h3>分配ExternalPartyRequest</h3>
</div>
<dl class="x2mdx-ref-meta-grid">
<div class="x2mdx-ref-meta-item">
<dt>消息</dt>
<dd>com.daml.ledger.api.v2.admin.AllocateExternalPartyRequest</dd>
</div>
<div class="x2mdx-ref-meta-item">
<dt>客户端流</dt>
<dd>否</dd>
</div>
</dl>
<div class="x2mdx-ref-fields">
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">同步器</code>
<span class="x2mdx-ref-type-badge">字符串</span>
</div>
</div><div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">入职\_交易</code>
<span class="x2mdx-ref-type-badge">重复签名交易</span>
</div>
</div>
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">多重\_hash\_signatures</code>
<span class="x2mdx-ref-type-badge">重复签名</span>
</div>
</div>
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">身份\_provider\_id</code>
<span class="x2mdx-ref-type-badge">字符串</span>
</div>
</div>
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">等待\_for\_分配</code>
<span class="x2mdx-ref-type-badge">布尔</span>
</div>
</div>
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">用户\_id</code>
<span class="x2mdx-ref-type-badge">字符串</span>
</div>
</div>
</div>
</div>
## 输出
<div class="x2mdx-ref-panel">
<div class="x2mdx-ref-panel-head">
<h3>分配ExternalPartyResponse</h3>
</div>
<dl class="x2mdx-ref-meta-grid">
<div class="x2mdx-ref-meta-item">
<dt>消息</dt>
<dd>com.daml.ledger.api.v2.admin.AllocateExternalPartyResponse</dd>
</div>
<div class="x2mdx-ref-meta-item">
<dt>服务器流</dt>
<dd>否</dd>
</div>
</dl>
<div class="x2mdx-ref-fields">
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">party\_id</code>
<span class="x2mdx-ref-type-badge">字符串</span>
</div>
</div>
</div>
</div>
## 生命周期变化
<div class="x2mdx-ref-change-list">
<div class="x2mdx-ref-change-item">
<span class="x2mdx-ref-change-version">3.4.0</span>
<span class="x2mdx-ref-change-detail">引入</span>
</div>
</div>
## 相关模式<手风琴组>
<手风琴标题=“com.daml.ledger.api.v2.admin.AllocateExternalPartyRequest”>
<div class="x2mdx-ref-schema" id="schema-com-daml-ledger-api-v2-admin-allocateexternalpartyrequest">
<div class="x2mdx-ref-fields">
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">同步器</code>
<span class="x2mdx-ref-type-badge">字符串</span>
</div>
</div>
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">入职\_交易</code>
<span class="x2mdx-ref-type-badge">重复签名交易</span>
</div>
</div>
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">多重\_hash\_signatures</code>
<span class="x2mdx-ref-type-badge">重复签名</span>
</div>
</div>
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">身份\_provider\_id</code>
<span class="x2mdx-ref-type-badge">字符串</span>
</div>
</div>
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">等待\_for\_分配</code>
<span class="x2mdx-ref-type-badge">布尔</span>
</div>
</div>
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">用户\_id</code>
<span class="x2mdx-ref-type-badge">字符串</span>
</div>
</div>
</div>
</div>
</手风琴>
<手风琴标题=“com.daml.ledger.api.v2.admin.AllocateExternalPartyRequest.SignedTransaction”>
<div class="x2mdx-ref-schema" id="schema-com-daml-ledger-api-v2-admin-allocateexternalpartyrequest-signedtransaction">
<div class="x2mdx-ref-fields">
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">交易</code>
<span class="x2mdx-ref-type-badge">字节</span>
</div>
</div><div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">签名</code>
<span class="x2mdx-ref-type-badge">重复签名</span>
</div>
</div>
</div>
</div>
</手风琴>
<手风琴标题=“com.daml.ledger.api.v2.Signature”>
<div class="x2mdx-ref-schema" id="schema-com-daml-ledger-api-v2-signature">
<div class="x2mdx-ref-fields">
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">格式</code>
<span class="x2mdx-ref-type-badge">签名格式</span>
</div>
</div>
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">签名</code>
<span class="x2mdx-ref-type-badge">字节</span>
</div>
</div>
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">签名\_by</code>
<span class="x2mdx-ref-type-badge">字符串</span>
</div>
</div>
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">签名\_算法\_spec</code>
<span class="x2mdx-ref-type-badge">签名算法规范</span>
</div>
</div>
</div>
</div>
</手风琴>
<手风琴标题=“com.daml.ledger.api.v2.SignatureFormat”>
<div class="x2mdx-ref-schema" id="schema-com-daml-ledger-api-v2-signatureformat">
<ul class="x2mdx-ref-enum-list">
<li><code>签名\_格式\_UNSPECIFIED</code></li>
<li><code>SIGNATURE\_FORMAT\_RAW</code></li>
<li><code>SIGNATURE\_FORMAT\_DER</code></li>
<li><code>SIGNATURE\_FORMAT\_CONCAT</code></li>
<li><code>签名\_FORMAT\_SYMBOLIC</code></li>
</ul>
</div>
</手风琴>
<手风琴标题=“com.daml.ledger.api.v2.SigningAlgorithmSpec”>
<div class="x2mdx-ref-schema" id="schema-com-daml-ledger-api-v2-signingalgorithmspec">
<ul class="x2mdx-ref-enum-list">
<li><code>签名\_算法\_SPEC\_UNSPECIFIED</code></li>
<li><code>签名\_算法\_SPEC\_ED25519</code></li>
<li><code>签名\_算法\_SPEC\_EC\_DSA\_SHA\_256</code></li>
<li><code>签名\_算法\_SPEC\_EC\_DSA\_SHA\_384</code></li>
</ul>
</div>
</手风琴><手风琴标题=“com.daml.ledger.api.v2.admin.AllocateExternalPartyResponse”>
<div class="x2mdx-ref-schema" id="schema-com-daml-ledger-api-v2-admin-allocateexternalpartyresponse">
<div class="x2mdx-ref-fields">
<div class="x2mdx-ref-field-row">
<div class="x2mdx-ref-field-main">
<code class="x2mdx-ref-field-name">party\_id</code>
<span class="x2mdx-ref-type-badge">字符串</span>
</div>
</div>
</div>
</div>
</手风琴>
</手风琴组>
grpcurl
```bash grpcurl theme={"theme":{"light":"github-light","dark":"github-dark"}}
# Add -plaintext if the server is not using TLS.
grpcurl \
-d @ \
<HOST:PORT> \
com.daml.ledger.api.v2.admin.PartyManagementService/AllocateExternalParty <<'EOF'
{
"同步器": "string",
"onboardingTransactions": [
{
"transaction": "BASE64_ENCODED_BYTES",
"signatures": [
{
"format": "SIGNATURE_FORMAT_UNSPECIFIED",
"signature": "BASE64_ENCODED_BYTES",
"signedBy": "string",
"signingAlgorithmSpec": "SIGNING_ALGORITHM_SPEC_UNSPECIFIED"
}
]
}
],
"multiHashSignatures": [
{
"format": "SIGNATURE_FORMAT_UNSPECIFIED",
"signature": "BASE64_ENCODED_BYTES",
"signedBy": "string",
"signingAlgorithmSpec": "SIGNING_ALGORITHM_SPEC_UNSPECIFIED"
}
],
"identityProviderId": "string",
"waitForAllocation": true,
"userId": "string"
}
EOF
```
</div>
</div>
<div className="x2mdx-ref-rail-panel">
<div className="x2mdx-ref-rail-code x2mdx-ref-rail-code--response">
<div className="x2mdx-ref-rail-head">
<span className="x2mdx-ref-rail-heading">确定</span>
<span className="x2mdx-ref-response-label">application/json</span>
</div>
```json OK theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"partyId": "string"
}
```
</div>
</div>
本文由 CC Privacy Club 根据 Canton Network 官方文档（CC-BY-4.0）整理翻译，仅供学习；实现细节以官方最新版本为准。
