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
Crear una cuenta en Quicknode
Regístrate aquí si aún no lo has hecho.
Ve a tu panel de control
Abre el panel de control de Endpoints desde el menú de la barra lateral izquierda para gestionar todos tus puntos de conexión de la cadena de bloques
Crear un nuevo punto final
Click Create an Endpoint in the top-right corner, select NEAR as your blockchain, then select your preferred network
Copia las URL de tus proveedores
Ten a mano la URL HTTP. La vas a utilizar en las solicitudes que vas a realizar a continuación.
Si quieres ver una explicación detallada del panel de control de Quicknode, echa un vistazo a nuestra guía
Envía tu primera solicitud
Your endpoint is ready. Now, let's make your first call to the NEAR blockchain. We’ll use the estado method, which returns general status information about the NEAR node including version, sync status, and validator information. Selecciona tu idioma o SDK preferido y sigue los pasos que se indican a continuación para enviar tu primera solicitud.
- cURL
- Node.js
Python- Rubí
Comprobar la instalación de cURL
La mayoría de los sistemas basados en *nix son compatibles con cURL de serie. Abre el terminal y comprueba la versión de cURL ejecutando el siguiente comando:
curl --versión
Enviar una solicitud 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}'
Ejemplo de respuesta
{
"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
}
}
}
Configura tu proyecto
En primer lugar, comprueba que Node.js esté instalado ejecutando el comando `node --version`. Si no está instalado, descárgalo desde https://nodejs.org. A continuación, crea un nuevo directorio e inicializa un proyecto de 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();
Ejecuta tu script
Execute your script in the terminal to retrieve the node status:
nodo index.js
Configura tu proyecto
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
Crear y activar un entorno virtual
Crear un entorno virtual para gestionar las dependencias:
python3 -m venv venv
source venv/bin/activate
Install dependencies
Instala la biblioteca «requests» para realizar solicitudes HTTP:
pip instalar 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)
Ejecuta tu script
Execute your script in the terminal to retrieve the node status:
python main.py
Configura tu proyecto
First, create a new directory for your project:
mkdir near-api-quickstart
cd near-api-quickstart
Comprobar la instalación de Ruby
Comprueba que Ruby esté instalado en tu sistema. Si no es así, instálalo desde https://ruby-lang.org:
ruby --versión
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
Ejecuta tu script
Execute your script in the terminal to retrieve the node status:
ruby main.rb
Si quieres seguir aprendiendo a realizar solicitudes a la API, echa un vistazo a nuestras guías y aplicaciones de ejemplo.
¡Nos encanta recibir comentarios!
Si tienes algún comentario o pregunta sobre esta documentación, háznoslo saber. ¡Nos encantaría saber tu opinión!