Get raw table item

Esta página aún no está disponible en tu idioma.

POST

/tables/{table_handle}/raw_item

Test request

CURL *hnd = curl_easy_init();

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

CURLcode ret = curl_easy_perform(hnd);

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    RequestUri = new Uri("https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item"),
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

var client = new RestClient("https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item");
var request = new RestRequest(Method.POST);
IRestResponse response = client.Execute(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);
}

package main

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

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

  req, _ := http.NewRequest("POST", url, 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

AsyncHttpClient client = new DefaultAsyncHttpClient();
client.prepare("POST", "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item")
  .execute()
  .toCompletableFuture()
  .thenAccept(System.out::println)
  .join();

client.close();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item"))
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().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")
  .post(null)
  .build();

Response response = client.newCall(request).execute();

HttpResponse<String> response = Unirest.post("https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item")
  .asString();

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'
})

const settings = {
  async: true,
  crossDomain: true,
  url: 'https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item',
  method: 'POST',
  headers: {}
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

const data = null;

const xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener('readystatechange', function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open('POST', 'https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item');

xhr.send(data);

val client = OkHttpClient()

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

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

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

const axios = require('axios').default;

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 Cohttp_lwt_unix
open Cohttp
open Lwt

let uri = Uri.of_string "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item" in

Client.call `POST uri
>>= fun (res, body_stream) ->
  (* Do stuff with the result *)

$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');

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

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

import http.client

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

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

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

requests.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"
)

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

library(httr)

url <- "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item"

response <- VERB("POST", url, content_type("application/octet-stream"))

content(response, "text")

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 POST https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item

import Foundation

let request = NSMutableURLRequest(url: NSURL(string: "https://api.mainnet.aptoslabs.com/v1/tables/{table_handle}/raw_item")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

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

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

32425224034

Ledger version to get state of account

If not provided, it will be the latest version

Request Body ^required

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

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

unknown

Move struct value

object

string

Move string value

string

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

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

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

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

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

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

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

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

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

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

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

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

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