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
Créez un compte Quicknode
Inscrivez-vous ici si ce n'est pas déjà fait.
Accédez à votre tableau de bord
Ouvrez le tableau de bord des endpoints depuis le menu latéral gauche pour gérer tous vos endpoints blockchain
Créez un nouvel endpoint
Click Create an Endpoint in the top-right corner, select NEAR as your blockchain, then select your preferred network
Copiez vos URL de fournisseur
Gardez l'URL HTTP à portée de main. Vous l'utiliserez dans vos requêtes ci-dessous.
Pour une présentation détaillée du tableau de bord Quicknode, consultez notre guide
Envoyer votre première requête
Your endpoint is ready. Now, let's make your first call to the NEAR blockchain. We’ll use the statut method, which returns general status information about the NEAR node including version, sync status, and validator information. Sélectionnez votre langage ou SDK préféré et suivez les étapes ci-dessous pour envoyer votre première requête.
- cURL
- Node.js
Python- Ruby
Vérifier l'installation de cURL
La plupart des systèmes basés sur *nix prennent en charge cURL nativement. Ouvrez votre terminal et vérifiez la version de cURL en exécutant la commande ci-dessous :
curl --version
Envoyer une requête 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}'
Exemple de réponse
{
"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
}
}
}
Configurer votre projet
Tout d'abord, vérifiez que Node.js est installé avec la commande node --version. S'il n'est pas installé, téléchargez-le depuis https://nodejs.org. Ensuite, créez un nouveau répertoire et initialisez un projet 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();
Exécutez votre script
Execute your script in the terminal to retrieve the node status:
node index.js
Configurer votre projet
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
Créer et activer un environnement virtuel
Créer un environnement virtuel pour gérer les dépendances :
python3 -m venv venv
source venv/bin/activate
Installer les dépendances
Installez la bibliothèque « requests » pour effectuer des requêtes HTTP :
pip install 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)
Exécutez votre script
Execute your script in the terminal to retrieve the node status:
python main.py
Configurer votre projet
First, create a new directory for your project:
mkdir near-api-quickstart
cd near-api-quickstart
Vérifier l'installation de Ruby
Vérifiez que Ruby est bien installé sur votre système. Si ce n'est pas le cas, installez-le à partir du site 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
Exécutez votre script
Execute your script in the terminal to retrieve the node status:
ruby main.rb
Si vous souhaitez en savoir plus sur la création de requêtes API, consultez nos guides et nos exemples d'applications.
Nous ❤️ les commentaires !
Si vous avez des commentaires ou des questions concernant cette documentation, faites-le nous savoir. Nous serions ravis de vous entendre !