
कोड से NordBastion चलाएं.
KYC-free, crypto-paid, पूरी तरह scriptable.
पंजीकरण करें, कुंजी बनाएँ और पहुँच जाँचें। कोई जमा राशि आवश्यक नहीं है।
भुगतान से पहले अपनी API कुंजी बनाएँ।
पंजीकरण करें, कुंजी बनाएँ और पहुँच जाँचें। कोई जमा राशि आवश्यक नहीं है।
cURL
सीमित अनुमतियों वाली API कुंजी बनाने के लिए पंजीकरण या लॉगिन से मिला एक्सेस टोकन उपयोग करें। कुंजी सादे पाठ में केवल एक बार लौटाई जाती है।
# bash + curl + jq
# Set NB_EMAIL and NB_PASSWORD in your environment.
set -eu
: "${NB_EMAIL:?Set NB_EMAIL}" "${NB_PASSWORD:?Set NB_PASSWORD}"
API=https://nordbastion.com/v1
TOKEN=$(jq -n '{email:env.NB_EMAIL,password:env.NB_PASSWORD}' |
curl --fail-with-body -sS "$API/auth/register" \
-H 'Content-Type: application/json' --data-binary @- |
jq -er '.tokens.access_token')
KEY=$(curl --fail-with-body -sS "$API/auth/api-keys" \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' \
-d '{"name":"agent-read","scope":"read"}' |
jq -er '.plaintext')
curl --fail-with-body -sS "$API/account/balance" \
-H "Authorization: Bearer $KEY"
# Store KEY in your secret store. Do not print it.
unset TOKEN KEY
Python
भुगतान से पहले अपनी API कुंजी बनाएँ।
import os
import requests
api = "https://nordbastion.com/v1"
with requests.Session() as client:
signup = client.post(api + "/auth/register", json={
"email": os.environ["NB_EMAIL"],
"password": os.environ["NB_PASSWORD"],
}, timeout=30)
signup.raise_for_status()
token = signup.json()["tokens"]["access_token"]
created = client.post(api + "/auth/api-keys",
headers={"Authorization": f"Bearer {token}"},
json={"name": "agent-read", "scope": "read"},
timeout=30)
created.raise_for_status()
key = created.json()["plaintext"]
# Store key in your secret store; never log it.
balance = client.get(api + "/account/balance",
headers={"Authorization": f"Bearer {key}"},
timeout=30)
balance.raise_for_status()
print(balance.json())
API कुंजी से पहुँच भुगतान से स्वतंत्र है। प्रति खाते अधिकतम 10 सक्रिय कुंजियाँ; अनुपयोगी कुंजियाँ रद्द करें।
संगतता और संस्करण
होस्ट किया गया MCP एंडपॉइंट यहाँ अपडेट होता है। संस्करणबद्ध stdio डाउनलोड में स्रोत कोड और SHA-256 चेकसम शामिल हैं।
होस्ट किया गया MCP
https://nordbastion.com/mcp
- Version
- 1.1.0
- प्रोटोकॉल संस्करण
- 2026-07-28 · 2025-11-25 · 2025-06-18 · 2025-03-26
- अंतिम सत्यापन
- 2026-09-15
पहचान संबंधी जानकारी Authorization हेडर में भेजें। यदि आपका MCP क्लाइंट हेडर सेट नहीं कर सकता, तो access_token आर्ग्युमेंट का उपयोग करें।
ब्राउज़र में OAuth प्राधिकरण उपलब्ध नहीं है। Bearer टोकन या स्पष्ट access_token आर्ग्युमेंट का उपयोग करें।
MCP · register_account → create_api_key
{"name":"register_account","arguments":{
"email":"agent@example.com",
"password":"YOUR_STRONG_PASSWORD"
}}
{"name":"create_api_key","arguments":{
"name":"agent-read",
"scope":"read",
"access_token":"ACCESS_TOKEN_FROM_SIGNUP"
}}
{"name":"get_balance","arguments":{
"access_token":"PLAINTEXT_FROM_CREATE_API_KEY"
}}
SSH कुंजियाँ स्थानीय रूप से बनाएँ। केवल सार्वजनिक कुंजी अपलोड करें; निजी कुंजी अपने डिवाइस पर रखें।
ssh-keygen -t ed25519 -f ~/.ssh/nordbastion_agent
# add_ssh_key: public_key = contents of the .pub file
Endpoint reference
Python, TypeScript, Go और Rust के SDK तथा CLI की योजना है। अभी REST या MCP का उपयोग करें।
| Method | एंडपॉइंट | दायरा | स्थिति |
|---|---|---|---|
| POST | /v1/auth/register | public | LIVE |
| POST | /v1/auth/login | public | LIVE |
| POST | /v1/auth/login/totp | public | LIVE |
| POST | /v1/auth/token/refresh | public | LIVE |
| POST | /v1/auth/recover | public | PLANNED |
| GET | /v1/auth/sessions | full | LIVE |
| DELETE | /v1/auth/sessions/{token_id} | full | LIVE |
| POST | /v1/auth/totp/setup | full | LIVE |
| POST | /v1/auth/totp/enable | full | LIVE |
| POST | /v1/auth/totp/disable | full | LIVE |
| POST | /v1/auth/password | full | LIVE |
| POST | /v1/auth/api-keys | full | LIVE |
| GET | /v1/auth/api-keys | read | LIVE |
| DELETE | /v1/auth/api-keys/{key_id} | full | LIVE |
| GET | /v1/account | read | LIVE |
| PATCH | /v1/account | full | PLANNED |
| GET | /v1/account/balance | read | LIVE |
| GET | /v1/account/usage | read | LIVE |
| GET | /v1/account/audit-log | read | LIVE |
| GET | /v1/billing/coins | public | LIVE |
| POST | /v1/billing/topups | billing | LIVE |
| GET | /v1/billing/topups | read | LIVE |
| GET | /v1/billing/topups/{order_number} | read | LIVE |
| POST | /v1/billing/topups/{order_number}/cancel | billing | LIVE |
| GET | /v1/billing/bonus-tiers | public | LIVE |
| GET | /v1/catalog | public | LIVE |
| GET | /v1/catalog/vps | public | LIVE |
| GET | /v1/catalog/dedicated | public | LIVE |
| GET | /v1/catalog/bastions | public | LIVE |
| GET | /v1/catalog/images | public | LIVE |
| GET | /v1/catalog/{code} | public | LIVE |
| POST | /v1/servers | servers | LIVE |
| GET | /v1/servers | read | LIVE |
| GET | /v1/servers/{order_number} | read | LIVE |
| PATCH | /v1/servers/{order_number} | servers | LIVE |
| DELETE | /v1/servers/{order_number} | servers | LIVE |
| POST | /v1/ssh-keys | servers | LIVE |
| GET | /v1/ssh-keys | read | LIVE |
| GET | /v1/ssh-keys/{id} | read | LIVE |
| DELETE | /v1/ssh-keys/{id} | servers | LIVE |
| POST | /v1/webhooks | full | LIVE |
| GET | /v1/webhooks | read | LIVE |
| DELETE | /v1/webhooks/{id} | full | LIVE |
| POST | /v1/webhooks/{id}/test | full | LIVE |
| GET | /v1/transparency/canary | public | LIVE |
| GET | /v1/transparency/peering | public | LIVE |
| GET | /v1/transparency/status | public | LIVE |
| GET | /v1/agents/directory | public | LIVE |
| POST | /v1/agents/directory | full | LIVE |
| POST | /v1/oauth/register | public | LIVE |
| POST | /v1/oauth/token | public | LIVE |
| POST | /v1/oauth/revoke | public | LIVE |
| GET | /v1/oauth/introspect | public | LIVE |
भुगतान
राशि जोड़ने से पहले देखें और जाँचें। क्रिप्टो से राशि जोड़ना केवल सशुल्क सेवाओं के लिए आवश्यक है।
POST /v1/billing/topups · {"amount_usd":50,"crypto":"XMR"} · USD 30–10,000
x402 राशि जोड़ने वाले एंडपॉइंट से Base पर हस्ताक्षरित USDC भुगतान स्वीकार करता है। ऑर्डर देने से पहले शेष राशि की पुष्टि की प्रतीक्षा करें।
x402: POST /v1/billing/topups · X-Payment-Mode: x402 · {"amount_usd":50}
दर सीमाएं
API key: 120 / min · 3,000 / hour · public: 30 / min · HTTP 429 + Retry-After
खाते की गतिविधि API ऑडिट लॉग में दर्ज होती है। पहचान संबंधी जानकारी और अनुरोध का मुख्य भाग इसमें शामिल नहीं होते।
API key प्राप्त करें