Torii API ཀོ་ནི་ཟོལ

གློག་ཐག་འདི་ལག་ལེན་འཐབ་ OpenAPI སྒྲིག་གཞི་ཅིག་ལས་ཐོན་ཡོདཔ་ཨིན། Torii མཐའན་མཇུག་གི་སྒོ་སྒྲིག་ཚུ་ བརྟག་ཞིབ་འབད་ནི་དང་ བརྟག་དཔྱད་གྱི་ཞུ་ཡིག་གཏང་ནི་ དེ་ལས་ ཨེབ་གཏང་འབད་ནི་ curl བཀའ་རྒྱ་ཚུ་ བཏོན་ཞིནམ་ལས་ ཁྱོད་ཀྱིས་ client code བཟོ་ཚུགས།

Torii endpoint

Load a running Torii endpoint to inspect and test its live OpenAPI routes.

Generate clientTypeScript fetchPythonRustKotlinJavaSwift

export TORII_URL=https://taira.sora.org
node --input-type=module <<'EOF' > iroha-torii.openapi.json
const toriiUrl = process.env.TORII_URL
const response = await fetch(`${toriiUrl}/openapi.json`)
if (!response.ok) throw new Error(`HTTP ${response.status}`)
const spec = await response.json()
spec.servers = [{ url: toriiUrl, description: 'Selected Torii endpoint' }]
console.log(JSON.stringify(spec, null, 2))
EOF

pnpm dlx @openapitools/openapi-generator-cli generate
  -i iroha-torii.openapi.json \
  -g typescript-fetch \
  -o ./iroha-torii-typescript

Generated OpenAPI clients are best for JSON operator and app routes. Use the Iroha SDKs for signed ledger transactions, signed queries, and Norito-native payloads.

དགོས་མཁོ་ཚུ་

• Torii མཐའ་མཇུག་གི་ཐིག་ཁྲམ་ནང་ /openapi.json གསལ་སྟོན་འབད་དགོ།
• བལྟ་བཤལཔ་བརྟག་དཔྱད་འདི་ CORS གིས་ འ་ནི་ཡིག་ཆའི་འབྱུང་ཁུངས་ལུ་ ངོས་ལེན་འབད་དགོཔ་ཨིན།
• ཌའི་ལོག་ལག་ལེན་འཐབ་མི་གིས་ ཐད་ཀར་དུ་ མཇུག་མཐའན་མཇུག་གི་གནས་སྟངས་ལུ་ ལྷོད་ཚུགས་དགོཔ་ཨིན།
• ཀོ་ཌ་བཟོ་སྐྲུན་ལུ་ Node.js, pnpm དེ་ལས་ OpenAPI Generatorགི་དོན་ལུ་ Java runtime དགོཔ་ཨིན།

console འདི་ defaultསྦེ་ https://taira.sora.org ལུ་འབདཝ་ཨིན། ས་གནས་བཟོ་སྐྲུན་འདི་ འཕྲུལ་ཆས་ནང་ལུ་ ཁྱོད་ཀྱིས་ Torii རྒྱུག་པའི་སྐབས་ སྤྱིར་བཏང་ལུ་ http://127.0.0.1:8080 ལུ་ལཱ་འབད་འོང་།

དང་པ་ར་ Taira བརྟག་དཔྱད་འབད་

ཁྱོད་ཀྱིས་ client བཟོ་མ་ཚར་བའི་ཧེ་མར་ ཁྱོད་ཀྱིས་ public OpenAPI document འདི་ཁྱོད་ཀྱི་འཕྲུལ་ཆས་ནང་ལས་ལག་ལེན་འཐབ་ཚུགསཔ་ཨིན་ན་བརྟག་དཔྱད་འབད་:

curl -fsS https://taira.sora.org/openapi.json -o /tmp/taira-openapi.json
jq '{title: .info.title, version: .info.version, paths: (.paths | length)}' \
  /tmp/taira-openapi.json

འདི་གི་ཤུལ་ལས་ https://taira.sora.org/openapi.json འདི་ ཀྲུང་གོ་བོད་ཀྱི་ནང་ཨེབ་གཏང་འབད་ཞིནམ་ལས་ ཀློག་བཏུབ་པའི་ལམ་ལུགས་ཅིག་ བརྟག་དཔྱད་འབད་ དཔེར་ན་ GET /status, GET /v1/domains ཡང་ན་ GET /v1/assets/definitions. ཁྱོད་ཀྱི་ runtime གནས་སྟངས་ནང་ལས་ གསང་བ་ཚུ་ ལེན་མི་ SDK དང་ CLI ཌའི་ལོག་གི་དོན་ལུ་ ཐོ་བཀོད་ཅན་གྱི་ཚོང་འབྲེལ་དང་ སྒེར་གྱི་ལྡེ་མིག་གི་རྒྱུན་འགྲུལ་སླར་གསོ་འབད་ཚུགས།

བཟོ་སྐྲུན་འབད་མི་ ཚོང་མགྲོན་པ་

ཇི་ནེ་རེ་ཊར་གྱི་བཀའ་རྒྱ་འདི་ console ལུ་ཨེབ་གཏང་འབད་ཡོད་པའི་ OpenAPI ཡིག་ཆ་དེ་རང་ ལག་ལེན་འཐབ་ཨིན། འདི་ JSON ལས་འཛིན་, Explorer, app, དང་ telemetry ཕྲང་ལམ་ཚུ་གི་དོན་ལུ་ཕན་ཐོགས་ཡོདཔ་ཨིན།

ཐོ་བཀོད་ཅན་གྱི་རྩིས་དེབ་ཀྱི་ ཕྱིར་ཚོང་གྱི་དོན་ལུ་ ཐོ་བཀོད་ཀྱི་དྲི་ཚུ་དང་ Norito- རང་ལུགས་ཀྱི་ཁེ་ཕན་གྱི་མཁོ་ཆས་ཚུ་ གཞུང་གི་ཁ་ཐུག་ལས་ Iroha SDKs. OpenAPI ཚོང་མགྲོན་པ་ཚུ་གིས་ ཐོ་བཀོད་དང་རྩིས་ཁྲ་གི་ལྡེ་མིག་ཚུ་ འཛིན་སྐྱོང་འབད་ནི་ ཡང་ན་ ཨེན་ཀོ་ཌམ་རྐྱབ་མི་ཚུགས། Norito ཚོང་འབྲེལ་གྱི་སྡེ་ཚན་ཚུ་ ཁྱོད་གི་དོན་ལུ་ཨིན།

OpenAPI ཇི་ནེརེ་ཊར་གིས་ རྒྱབ་སྐྱོར་འབད་མི་ཇི་ནེརེ་ཚུ་ བརྟག་ཞིབ་འབད་ནིའི་དོན་ལུ་:

pnpm dlx @openapitools/openapi-generator-cli list