Torii API ኮንሶል

መስመሮችን ለመፈተሽ፣ የሙከራ ጥያቄዎችን ለመላክ፣ curl ትዕዛዞችን ለመቅዳት እና የደንበኛ ኮድ ለማመንጨት ከሂደቱ Torii መጨረሻ ነጥብ የቀጥታ OpenAPI ሰነዱን ይጠቀሙ።

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.

የኮንሶሉ ነባሪነት https://taira.sora.org. አካባቢያዊ ልማት አብዛኛውን ጊዜ http://127.0.0.1:8080 ስትሮጥ Torii በማሽኑ ላይ።

መጀመሪያ Taira ይሞክሩ

ደንበኛ ከመፍጠርዎ በፊት የህዝብ OpenAPI ሰነድ ከማሽኑዎ ተደራሽ መሆኑን ያረጋግጡ:

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 ያሉ ለማንበብ-ብቻ መንገድ ይሞክሩ ። የተፈረሙትን ግብይቶች እና የግል ቁልፍ ፍሰቶችን ከስራ ሰዓት አካባቢዎ ሚስጥሮችን ለሚጭነው የ SDK ወይም CLI ደንበኛ ያስቀምጡ።

የተፈጠሩ ደንበኞች

የጄኔሬተር ትዕዛዙ በኮንሶሉ ውስጥ የሚጫነው ተመሳሳይ የቀጥታ OpenAPI ሰነድ ይጠቀማል ። ይህ ለ JSON ኦፕሬተር ፣ አሳሽ ፣ መተግበሪያ እና ለቴሌሜትሪ መስመሮች ጠቃሚ ነው።

ለተፈረሙ መቁጠሪያ ግብይቶች, ለተፈረሙ ጥያቄዎች, እና Norito- የአገሬው ተወላጅ ሸክሞች፣ ባለሥልጣናትን ይመርጣሉ። Iroha SDKs. OpenAPI ደንበኞች ፊርማዎችን አያሰባስቡም ፣ የሂሳብ ቁልፎችን አያስተዳድሩም ወይም አይኮዱም Norito የግብይት አካላት ለእርስዎ።

በ OpenAPI ጀነሬተር የሚደገፉትን እያንዳንዱን ጄኔሬተር ለመመርመር የሚከተሉትን ይሂዱ:

pnpm dlx @openapitools/openapi-generator-cli list