The quickest way to start building on NEAR with Quicknode is by sending a JSON-RPC request to your endpoint. In this quickstart, you’ll create an endpoint, copy its provider URL, and make your first request. Code samples are available in cURL, JavaScript, Python, and Ruby.
Get Your NEAR Endpoint
如需了解 Quicknode 儀表板的詳細操作指南，請參閱我們的 指南
發送您的第一個請求
Your endpoint is ready. Now, let's make your first call to the NEAR blockchain. We’ll use the 狀態 method, which returns general status information about the NEAR node including version, sync status, and validator information. 請選擇您偏好的語言或 SDK，並依照以下步驟發送您的第一個請求.
- cURL
- Node.js
Python- Ruby
檢查 cURL 的安裝狀況
大多數基於 *nix 的系統預設即支援 cURL。請開啟終端機，並執行以下指令以檢查 cURL 的版本：
curl --version
傳送一個 JSON-RPC 請求
In your terminal, copy and paste the following cURL command to retrieve the node status:
curl -X POST YOUR_QUICKNODE_ENDPOINT_URL/ \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"status","params":[],"id":1}'
範例回應
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"version": {
"version": "1.37.1",
"build": "crates-0.21.1-216-gd6385b0eb"
},
"chain_id": "mainnet",
"sync_info": {
"latest_block_hash": "44L5qF4NitTZgNd5haxFLgWaJJ3FD9VafPo4WdL1p3M8",
"latest_block_height": 106503813,
"latest_state_root": "7Bf2aQoAqo1FcYjSddJvPEkrSCsw5j9uEPMBbEE7Kk8",
"latest_block_time": "2024-01-15T12:00:00.000000000Z",
"syncing": false
}
}
}
設定您的專案
首先，請使用 `node --version` 確認是否已安裝 Node.js。若尚未安裝，請從 https://nodejs.org 下載。接著建立一個新目錄，並初始化一個 Node.js 專案：
mkdir near-api-quickstart
cd near-api-quickstart
npm init -y
Create your script
Create a new file called index.js and add the following code to retrieve the node status:
const https = require('https');
const data = JSON.stringify({
"jsonrpc": "2.0",
"method": "status",
"params": [],
"id": 1
});
const options = {
hostname: '{your-endpoint-name}.quiknode.pro',
path: '/{your-token}/',
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Content-Length': data.length
}
};
const req = https.request(options, (res) => {
let result = '';
res.on('data', (chunk) => {
result += chunk;
});
res.on('end', () => {
console.log(result);
});
});
req.on('error', (error) => {
console.error('Error:', error);
});
req.write(data);
req.end();
Run your script
Execute your script in the terminal to retrieve the node status:
node index.js
設定您的專案
First, verify Python is installed with python --version or python3 --version. Then create a new directory for your project:
mkdir near-api-quickstart
cd near-api-quickstart
建立並啟用虛擬環境
建立一個虛擬環境來管理依賴項：
python3 -m venv venv
source venv/bin/activate
Install dependencies
安裝 requests 函式庫以進行 HTTP 請求：
pip 安裝 requests
Create your script
Create a new file called main.py and add the following code to retrieve the node status:
import requests
import json
url = "YOUR_QUICKNODE_ENDPOINT_URL/"
payload = json.dumps({
"jsonrpc": "2.0",
"method": "status",
"params": [],
"id": 1
})
headers = {
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
Run your script
Execute your script in the terminal to retrieve the node status:
python main.py
設定您的專案
First, create a new directory for your project:
mkdir near-api-quickstart
cd near-api-quickstart
檢查 Ruby 的安裝狀況
請確認您的系統上是否已安裝 Ruby。若尚未安裝，請從 https://ruby-lang.org 進行安裝：
ruby --version
Create your script
Create a new file called main.rb and add the following code to retrieve the node status:
require "uri"
require "json"
require "net/http"
url = URI("YOUR_QUICKNODE_ENDPOINT_URL/")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
"jsonrpc": "2.0",
"method": "status",
"params": [],
"id": 1
})
response = https.request(request)
puts response.read_body
Run your script
Execute your script in the terminal to retrieve the node status:
Ruby main.rb
如果您想進一步了解如何發送 API 請求，請參閱我們的指南和 範例應用程式。
我們 ❤️ 您的回饋！
如果您對這份文件有任何意見或疑問，請告訴我們。我們非常樂意聽取您的意見！