GET/
Root
Root endpoint - provides API information.
الاستجابات
| الحالة | الوصف | المتن |
|---|---|---|
200 | Successful Response |
|
واجهة REST API لـ core-node
Small REST surface exposed by the TensorCash core-node alongside the JSON-RPC server. Used by the miner-api to query model metadata and node metrics. The full chain surface is the JSON-RPC at /docs/rpc/.
واجهة السلسلة الكاملة هي JSON-RPC. أمّا هذه فواجهة REST صغيرة بجانب العقدة، تستخدمها واجهة API المحلّية للمُعدِّن للبيانات الوصفية للنماذج ومقاييس العقدة. المنفذ 8050 في بيئة الإنتاج.
نقاط النهاية
GET
GET/health
Health Check
Health check endpoint - no auth required.
الاستجابات
| الحالة | الوصف | المتن |
|---|---|---|
200 | Successful Response |
|
GET/api/v1/models
Get Models List
Get list of models with rate limiting.
المعاملات
| الاسم | الموقع | النوع | مطلوب | الوصف |
|---|---|---|---|---|
extended | query | boolean | — |
متن الطلب
-
HTTPAuthorizationCredentials | null
الاستجابات
| الحالة | الوصف | المتن |
|---|---|---|
200 | Successful Response | |
422 | Validation Error |
GET/api/v1/blockchaininfo
Get Blockchain Info
Pass-through to the node's getblockchaininfo RPC.
Used by the verification orchestrator to compute distance-to-verdict for
PendingVerification model records and trigger anticipatory smell-stat
pre-bake before a model flips to Registered.
متن الطلب
-
HTTPAuthorizationCredentials | null
الاستجابات
| الحالة | الوصف | المتن |
|---|---|---|
200 | Successful Response |
|
422 | Validation Error |
GET/api/v1/models/{model_hash}
Get Model Info
Get model information with input validation.
المعاملات
| الاسم | الموقع | النوع | مطلوب | الوصف |
|---|---|---|---|---|
model_hash | path | string | نعم |
متن الطلب
-
HTTPAuthorizationCredentials | null
الاستجابات
| الحالة | الوصف | المتن |
|---|---|---|
200 | Successful Response |
|
422 | Validation Error |
GET/api/v1/miner/metrics
Get Miner Metrics
Get mining throughput metrics from the miner proxy. Returns token throughput (tokens/sec), completion rate, and totals.
متن الطلب
-
HTTPAuthorizationCredentials | null
الاستجابات
| الحالة | الوصف | المتن |
|---|---|---|
200 | Successful Response |
|
422 | Validation Error |
المخطّطات
HTTPAuthorizationCredentials
The HTTP authorization credentials in the result of using HTTPBearer or
HTTPDigest in a dependency.
The HTTP authorization header value is split by the first space.
The first part is the scheme, the second part is the credentials.
For example, in an HTTP Bearer token scheme, the client will send a header
like:
``
Authorization: Bearer deadbeef12346
`
In this case:
* scheme will have the value "Bearer"
* credentials will have the value "deadbeef12346"`
| الحقل | النوع | مطلوب | الوصف |
|---|---|---|---|
scheme | string | نعم | |
credentials | string | نعم |
HTTPValidationError
| الحقل | النوع | مطلوب | الوصف |
|---|---|---|---|
detail | ValidationError[] | — |
ModelInfo
| الحقل | النوع | مطلوب | الوصف |
|---|---|---|---|
model_hash | string | نعم | |
model_name | string | نعم | |
model_commit | string | نعم | |
difficulty | integer | نعم | |
status | integer | null | — | |
cid | string | null | — | |
extra | string | null | — | |
txid | string | null | — | |
block_hash | string | null | — | |
block_height | integer | null | — | |
deposit_txid | string | null | — | |
deposit_vout | integer | null | — | |
deposit_amount | integer | null | — | |
owner_key_hash | string | null | — | |
deposit_block_hash | string | null | — | |
deposit_block_height | integer | null | — | |
commit_txid | string | null | — | |
commit_block_hash | string | null | — | |
commit_block_height | integer | null | — | |
verification_code | integer | null | — | |
verification_details | string | null | — |
ValidationError
| الحقل | النوع | مطلوب | الوصف |
|---|---|---|---|
loc | string | integer[] | نعم | |
msg | string | نعم | |
type | string | نعم |