Get raw table item

此内容尚不支持你的语言。

POST

/tables/{table_handle}/raw_item

Select targetCC#ClojureDartF#GoHTTPJavaJavaScriptJuliaKotlinNode.jsObjective-COCamlPHPPowerShellPythonRRubyRustShellSwiftSelect clientCurlWgetHTTPieTest request

#include <curl/curl.h>

int main(void) {
  curl_global_init(CURL_GLOBAL_DEFAULT);
  CURL *curl = curl_easy_init();
  if (!curl) {
    curl_global_cleanup();
    return 1;
  }

  curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
  curl_easy_setopt(curl, CURLOPT_URL, "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item");

  CURLcode res = curl_easy_perform(curl);
  curl_easy_cleanup(curl);
  curl_global_cleanup();

  return (int)res;
}

using var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Post, "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item");

using var response = await client.SendAsync(request);

var client = new RestClient("https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item");
var request = new RestRequest("", Method.Post);
var response = await client.ExecuteAsync(request);

(require '[clj-http.client :as client])

(client/post "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item")

import 'package:http/http.dart' as http;

void main() async {
  final response = await http.post(Uri.parse('https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item'));
  print(response.body);
}

let httpRequestMessage = new HttpRequestMessage(
  HttpMethod("post"),
  new Uri("https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item")
)

let client = new HttpClient()
let! result = client.SendAsync(httpRequestMessage)

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  requestUrl := "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item"

  req, _ := http.NewRequest("POST", requestUrl, nil)

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

POST /v1/tables/{table_handle}/raw_item HTTP/1.1
Host: api.mainnet.aptoslabs.com

try (AsyncHttpClient client = new DefaultAsyncHttpClient()) {
  Response response = client.prepare("POST", "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item")
    .execute()
    .get();
  System.out.println(response.getResponseBody());
}

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
  .uri(java.net.URI.create("https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item"))
  .method("POST", HttpRequest.BodyPublishers.noBody())
  .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item")
  .method("POST", RequestBody.create(null, ""))
  .build();

try (Response response = client.newCall(request).execute()) {
  System.out.println(response.body().string());
}

HttpResponse<String> response = Unirest.request("POST", "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item")
  .asString();
System.out.println(response.getBody());

fetch('https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item', {
  method: 'POST'
})

import axios from 'axios'

const options = {
  method: 'POST',
  url: 'https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item'
}

try {
  const { data } = await axios.request(options)
  console.log(data)
} catch (error) {
  console.error(error)
}

import { ofetch } from 'ofetch'

ofetch('https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item', {
  method: 'POST'
})

$.ajax({
  url: "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item",
  method: "POST",
  processData: false,
  contentType: false,
  data: null
}).done((response) => console.log(response));

const xhr = new XMLHttpRequest();
xhr.open("POST", "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item");
xhr.withCredentials = true;
xhr.addEventListener("load", () => console.log(xhr.responseText));
xhr.send(null);

using HTTP

response = HTTP.post("https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item")

println(String(response.body))

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item")
  .post(RequestBody.create(null, ""))
  .build()

val response = client.newCall(request).execute()

fetch('https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item', {
  method: 'POST'
})

import axios from 'axios'

const options = {
  method: 'POST',
  url: 'https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item'
}

try {
  const { data } = await axios.request(options)
  console.log(data)
} catch (error) {
  console.error(error)
}

import { ofetch } from 'ofetch'

ofetch('https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item', {
  method: 'POST'
})

import { request } from 'undici'

const { statusCode, body } = await request('https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item', {
  method: 'POST'
})

#import <Foundation/Foundation.h>

NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item"]
                                                      cachePolicy:NSURLRequestUseProtocolCachePolicy
                                                  timeoutInterval:10.0];
[request setHTTPMethod:@"POST"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
  if (error) {
    NSLog(@"%@", error);
  } else {
    NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
    NSLog(@"%@", httpResponse);
  }
}];
[dataTask resume];

open Lwt.Infix

let () =
  Lwt_main.run (
    let uri = Uri.of_string "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item" in
    let headers = Cohttp.Header.of_list [
    ] in
    Cohttp_lwt_unix.Client.call ~headers (Cohttp.Code.method_of_string "POST") uri
    >>= fun (_response, body) ->
    Cohttp_lwt.Body.to_string body >>= Lwt_io.printl
  )

$ch = curl_init("https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item");

curl_setopt($ch, CURLOPT_POST, true);

curl_exec($ch);

curl_close($ch);

$client = new GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item');

use Illuminate\Support\Facades\Http;

$response = Http::post('https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item');

$response = Invoke-WebRequest -Uri 'https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item' -Method 'POST'
$response

$response = Invoke-RestMethod -Uri 'https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item' -Method 'POST'
$response

import http.client

conn = http.client.HTTPSConnection("api.mainnet.aptoslabs.com")

conn.request("POST", "/v1/tables/{table_handle}/raw_item")

response = conn.getresponse()
print(response.read().decode())

conn.close()

requests.post(
    "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item"
)

async with aiohttp.ClientSession() as session:
    await session.post(
        "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item"
    )

httpx.post(
    "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item"
)

async with httpx.AsyncClient() as client:
    await client.post(
        "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item"
    )

library(httr2)

response <- request("https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item") |>
  req_method("POST") |>
  req_perform()

resp_body_string(response)

require 'uri'
require 'net/http'

url = URI("https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

let client = reqwest::Client::new();

let request = client.post("https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item");

let response = request.send().await?;

curl 'https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item' \
  --request POST

wget --quiet \
  --method POST \
  --output-document \
  - 'https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item'

http --ignore-stdin 'POST' 'https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item'

import Foundation

var request = URLRequest(url: URL(string: "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item")!)
request.httpMethod = "POST"

let (data, response) = try await URLSession.shared.data(for: request)

guard let httpResponse = response as? HTTPURLResponse,
      200..<300 ~= httpResponse.statusCode else {
  throw URLError(.badServerResponse)
}

print(String(data: data, encoding: .utf8) ?? "")

Get a table item at a specific ledger version from the table identified by {table_handle} in the path and the “key” (RawTableItemRequest) provided in the request body.

The get_raw_table_item requires only a serialized key comparing to the full move type information comparing to the get_table_item api, and can only return the query in the bcs format.

The Aptos nodes prune account state history, via a configurable time window. If the requested ledger version has been pruned, the server responds with a 410.

Parameters

Path Parameters

table_handle

required

A hex encoded 32 byte Aptos account address.

This is represented in a string as a 64 character hex string, sometimes shortened by stripping leading 0s, and adding a 0x.

For example, address 0x0000000000000000000000000000000000000000000000000000000000000001 is represented as 0x1.

string format: hex

Example

0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1

Table handle hex encoded 32-byte string

Query Parameters

ledger_version

A string containing a 64-bit unsigned integer.

We represent u64 values as a string to ensure compatibility with languages such as JavaScript that do not parse u64s in JSON natively.

string format: uint64

Example

32425224034

Ledger version to get state of account

If not provided, it will be the latest version

Request Body^required

Media type application/json

Table Item request for the GetTableItemRaw API

object

key

required

All bytes (Vec) data is represented as hex-encoded string prefixed with 0x and fulfilled with two hex digits per byte.

Unlike the Address type, HexEncodedBytes will not trim any zeros.

string format: hex

Example

0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1

Responses

200

Any of:

integer

Move u8 value

integer format: uint8

integer

Move u16 value

integer format: uint16

integer

Move u32 value

integer format: uint32

unknown

Move u64 value

string format: uint64

unknown

Move u128 value

string format: uint128

unknown

Move u256 value

string format: uint256

boolean

Move bool value

boolean

unknown

Move address value

string format: hex

Array

Move vector value

Array

unknown

Move bytes value

string format: hex

object

Move struct value

object

string

Move string value

string

Example

32425224034

Array<integer>

Headers

X-APTOS-CHAIN-ID

required

integer format: uint8

Chain ID of the current chain

X-APTOS-LEDGER-VERSION

required

integer format: uint64

Current ledger version of the chain

X-APTOS-LEDGER-OLDEST-VERSION

required

integer format: uint64

Oldest non-pruned ledger version of the chain

X-APTOS-LEDGER-TIMESTAMPUSEC

required

integer format: uint64

Current timestamp of the chain

X-APTOS-EPOCH

required

integer format: uint64

Current epoch of the chain

X-APTOS-BLOCK-HEIGHT

required

integer format: uint64

Current block height of the chain

X-APTOS-OLDEST-BLOCK-HEIGHT

required

integer format: uint64

Oldest non-pruned block height of the chain

X-APTOS-GAS-USED

integer format: uint64

The cost of the call in terms of gas

X-APTOS-CURSOR

string

Cursor to be used for endpoints that support cursor-based pagination. Pass this to the start field of the endpoint on the next call to get the next page of results.

400

Media type application/json

This is the generic struct we use for all API errors, it contains a string message and an Aptos API specific error code.

object

message

required

A message describing the error

string

error_code

required

These codes provide more granular error information beyond just the HTTP status code of the response.

string

Allowed values: account_not_found resource_not_found module_not_found struct_field_not_found version_not_found transaction_not_found table_item_not_found block_not_found state_value_not_found version_pruned block_pruned invalid_input invalid_transaction_update sequence_number_too_old vm_error rejected_by_filter health_check_failed mempool_is_full internal_error web_framework_error bcs_not_supported api_disabled

vm_error_code

A code providing VM error details when submitting transactions to the VM

integer format: uint64

Example

{
  "error_code": "account_not_found"
}

Headers

X-APTOS-CHAIN-ID

integer format: uint8

Chain ID of the current chain

X-APTOS-LEDGER-VERSION

integer format: uint64

Current ledger version of the chain

X-APTOS-LEDGER-OLDEST-VERSION

integer format: uint64

Oldest non-pruned ledger version of the chain

X-APTOS-LEDGER-TIMESTAMPUSEC

integer format: uint64

Current timestamp of the chain

X-APTOS-EPOCH

integer format: uint64

Current epoch of the chain

X-APTOS-BLOCK-HEIGHT

integer format: uint64

Current block height of the chain

X-APTOS-OLDEST-BLOCK-HEIGHT

integer format: uint64

Oldest non-pruned block height of the chain

X-APTOS-GAS-USED

integer format: uint64

The cost of the call in terms of gas

403

Media type application/json

This is the generic struct we use for all API errors, it contains a string message and an Aptos API specific error code.

object

message

required

A message describing the error

string

error_code

required

These codes provide more granular error information beyond just the HTTP status code of the response.

string

Allowed values: account_not_found resource_not_found module_not_found struct_field_not_found version_not_found transaction_not_found table_item_not_found block_not_found state_value_not_found version_pruned block_pruned invalid_input invalid_transaction_update sequence_number_too_old vm_error rejected_by_filter health_check_failed mempool_is_full internal_error web_framework_error bcs_not_supported api_disabled

vm_error_code

A code providing VM error details when submitting transactions to the VM

integer format: uint64

Example

{
  "error_code": "account_not_found"
}

Headers

X-APTOS-CHAIN-ID

integer format: uint8

Chain ID of the current chain

X-APTOS-LEDGER-VERSION

integer format: uint64

Current ledger version of the chain

X-APTOS-LEDGER-OLDEST-VERSION

integer format: uint64

Oldest non-pruned ledger version of the chain

X-APTOS-LEDGER-TIMESTAMPUSEC

integer format: uint64

Current timestamp of the chain

X-APTOS-EPOCH

integer format: uint64

Current epoch of the chain

X-APTOS-BLOCK-HEIGHT

integer format: uint64

Current block height of the chain

X-APTOS-OLDEST-BLOCK-HEIGHT

integer format: uint64

Oldest non-pruned block height of the chain

X-APTOS-GAS-USED

integer format: uint64

The cost of the call in terms of gas

404

Media type application/json

This is the generic struct we use for all API errors, it contains a string message and an Aptos API specific error code.

object

message

required

A message describing the error

string

error_code

required

These codes provide more granular error information beyond just the HTTP status code of the response.

string

Allowed values: account_not_found resource_not_found module_not_found struct_field_not_found version_not_found transaction_not_found table_item_not_found block_not_found state_value_not_found version_pruned block_pruned invalid_input invalid_transaction_update sequence_number_too_old vm_error rejected_by_filter health_check_failed mempool_is_full internal_error web_framework_error bcs_not_supported api_disabled

vm_error_code

A code providing VM error details when submitting transactions to the VM

integer format: uint64

Example

{
  "error_code": "account_not_found"
}

Headers

X-APTOS-CHAIN-ID

integer format: uint8

Chain ID of the current chain

X-APTOS-LEDGER-VERSION

integer format: uint64

Current ledger version of the chain

X-APTOS-LEDGER-OLDEST-VERSION

integer format: uint64

Oldest non-pruned ledger version of the chain

X-APTOS-LEDGER-TIMESTAMPUSEC

integer format: uint64

Current timestamp of the chain

X-APTOS-EPOCH

integer format: uint64

Current epoch of the chain

X-APTOS-BLOCK-HEIGHT

integer format: uint64

Current block height of the chain

X-APTOS-OLDEST-BLOCK-HEIGHT

integer format: uint64

Oldest non-pruned block height of the chain

X-APTOS-GAS-USED

integer format: uint64

The cost of the call in terms of gas

410

Media type application/json

This is the generic struct we use for all API errors, it contains a string message and an Aptos API specific error code.

object

message

required

A message describing the error

string

error_code

required

These codes provide more granular error information beyond just the HTTP status code of the response.

string

Allowed values: account_not_found resource_not_found module_not_found struct_field_not_found version_not_found transaction_not_found table_item_not_found block_not_found state_value_not_found version_pruned block_pruned invalid_input invalid_transaction_update sequence_number_too_old vm_error rejected_by_filter health_check_failed mempool_is_full internal_error web_framework_error bcs_not_supported api_disabled

vm_error_code

A code providing VM error details when submitting transactions to the VM

integer format: uint64

Example

{
  "error_code": "account_not_found"
}

Headers

X-APTOS-CHAIN-ID

integer format: uint8

Chain ID of the current chain

X-APTOS-LEDGER-VERSION

integer format: uint64

Current ledger version of the chain

X-APTOS-LEDGER-OLDEST-VERSION

integer format: uint64

Oldest non-pruned ledger version of the chain

X-APTOS-LEDGER-TIMESTAMPUSEC

integer format: uint64

Current timestamp of the chain

X-APTOS-EPOCH

integer format: uint64

Current epoch of the chain

X-APTOS-BLOCK-HEIGHT

integer format: uint64

Current block height of the chain

X-APTOS-OLDEST-BLOCK-HEIGHT

integer format: uint64

Oldest non-pruned block height of the chain

X-APTOS-GAS-USED

integer format: uint64

The cost of the call in terms of gas

500

Media type application/json

This is the generic struct we use for all API errors, it contains a string message and an Aptos API specific error code.

object

message

required

A message describing the error

string

error_code

required

These codes provide more granular error information beyond just the HTTP status code of the response.

string

Allowed values: account_not_found resource_not_found module_not_found struct_field_not_found version_not_found transaction_not_found table_item_not_found block_not_found state_value_not_found version_pruned block_pruned invalid_input invalid_transaction_update sequence_number_too_old vm_error rejected_by_filter health_check_failed mempool_is_full internal_error web_framework_error bcs_not_supported api_disabled

vm_error_code

A code providing VM error details when submitting transactions to the VM

integer format: uint64

Example

{
  "error_code": "account_not_found"
}

Headers

X-APTOS-CHAIN-ID

integer format: uint8

Chain ID of the current chain

X-APTOS-LEDGER-VERSION

integer format: uint64

Current ledger version of the chain

X-APTOS-LEDGER-OLDEST-VERSION

integer format: uint64

Oldest non-pruned ledger version of the chain

X-APTOS-LEDGER-TIMESTAMPUSEC

integer format: uint64

Current timestamp of the chain

X-APTOS-EPOCH

integer format: uint64

Current epoch of the chain

X-APTOS-BLOCK-HEIGHT

integer format: uint64

Current block height of the chain

X-APTOS-OLDEST-BLOCK-HEIGHT

integer format: uint64

Oldest non-pruned block height of the chain

X-APTOS-GAS-USED

integer format: uint64

The cost of the call in terms of gas

503

Media type application/json

This is the generic struct we use for all API errors, it contains a string message and an Aptos API specific error code.

object

message

required

A message describing the error

string

error_code

required

These codes provide more granular error information beyond just the HTTP status code of the response.

string

Allowed values: account_not_found resource_not_found module_not_found struct_field_not_found version_not_found transaction_not_found table_item_not_found block_not_found state_value_not_found version_pruned block_pruned invalid_input invalid_transaction_update sequence_number_too_old vm_error rejected_by_filter health_check_failed mempool_is_full internal_error web_framework_error bcs_not_supported api_disabled

vm_error_code

A code providing VM error details when submitting transactions to the VM

integer format: uint64

Example

{
  "error_code": "account_not_found"
}

Headers

X-APTOS-CHAIN-ID

integer format: uint8

Chain ID of the current chain

X-APTOS-LEDGER-VERSION

integer format: uint64

Current ledger version of the chain

X-APTOS-LEDGER-OLDEST-VERSION

integer format: uint64

Oldest non-pruned ledger version of the chain

X-APTOS-LEDGER-TIMESTAMPUSEC

integer format: uint64

Current timestamp of the chain

X-APTOS-EPOCH

integer format: uint64

Current epoch of the chain

X-APTOS-BLOCK-HEIGHT

integer format: uint64

Current block height of the chain

X-APTOS-OLDEST-BLOCK-HEIGHT

integer format: uint64

Oldest non-pruned block height of the chain

X-APTOS-GAS-USED

integer format: uint64

The cost of the call in terms of gas