Apex Kimlik Doğrulama

API Anahtarı Alın

OrbitFlare gösterge panelini açın ve bir anahtar oluşturmak için Dashboard > Apex bölümüne gidin. Her anahtar bir katmana aittir ve katman, bahşiş tabanınızı ve hız sınırınızı belirler.

Anahtara bir parola gibi davranın. Onu elinde tutan herkes hız sınırınızı kullanarak işlem gönderebilir. Anahtar fonlarınızı harcayamaz: işlemler yine kendi anahtar çiftinizle imzalanır.

HTTP: başlık veya sorgu parametresi

HTTP üzerinde anahtar her istekle birlikte iletilir. Anahtarı iletmenin iki yolu vardır:

Yöntem	Örnek	Notlar
`x-api-key` başlığı (önerilen)	`x-api-key: YOUR_API_KEY`	Anahtarı URL’lerin, günlüklerin ve tarayıcı geçmişinin dışında tutar
`api-key` sorgu parametresi	`http://fra.apex.orbitflare.com?api-key=YOUR_API_KEY`	RPC URL alanı gibi yalnızca URL kabul eden araçlar için

curl -s http://fra.apex.orbitflare.com \
  -H "Content-Type: application/json" \
  -H "x-api-key: $APEX_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getTipAccounts","params":[]}'

curl -s "http://fra.apex.orbitflare.com?api-key=$APEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getTipAccounts","params":[]}'

Aynı iki seçenek düz HTTP rotalarında da (/send, /send-bin, /send-batch, /send-bundle) çalışır.

HTTP rotaları, diğer Solana gönderim servislerinde olduğu gibi şifrelenmez: API anahtarınız ve işlemleriniz ağ yolundaki herkes tarafından okunabilir. Anahtarın makinenizden hiç çıkmadığı QUIC’i tercih edin veya HTTP’yi yalnızca güvendiğiniz bir ağdan kullanın. Anahtarın açığa çıktığını düşünüyorsanız panelden yenileyin.

getTipAccounts, getVersion, health ve GET /ping anahtar gerektirmez. İşlem gönderen her şey gerektirir. Eksik veya geçersiz bir anahtar JSON-RPC hatası -32001 döndürür, düz rotalarda ise HTTP 401 döndürür. Hatalar ve hız sınırları sayfasına bakın.

QUIC: istemci sertifikası

QUIC üzerinde hiçbir şey istek başına doğrulanmaz ve API anahtarınız asla ağ üzerinden geçmez. Bunun yerine:

İstemciniz API anahtarından bir ed25519 anahtar çifti türetir.
QUIC el sıkışması sırasında bu açık anahtarı TLS istemci sertifikasında sunar.
Apex uç noktası açık anahtarı hesabınızla eşleştirir. O andan itibaren bu bağlantıdaki her akış size aittir.

Rust crate’i orbitflare-apex ve Go modülü orbitflare-apex-go bunların hepsini sizin yerinize yapar. Diğer diller için türetme şöyledir:

seed    = HKDF-SHA256(ikm = api_key bytes, salt = "orbitflare-apex", info = "orbitflare-apex/quic-client-cert/v1", L = 32)
keypair = ed25519 keypair from seed

Açık anahtarı Solana’nın sahte X.509 sertifikasına sarın. Bu, doğrulayıcıların TPU QUIC için kullandığı biçimle aynıdır (solana-tls-utils crate’indeki new_dummy_x509_certificate). Uç nokta yalnızca sertifikanın içindeki anahtarı kontrol eder. Diğer sertifika alanları yok sayılır. Test vektörü: test-api-key API anahtarı 2ovF9aU8fszHXpZwxaC1S9NF2m5VVDRBUvDUVQvXs4Tv açık anahtarını türetir. El sıkışma başarısız olursa uç nokta bağlantıyı bir uygulama hata koduyla kapatır:

Kapatma kodu	Anlamı
`1`	İstemci sertifikası sunulmadı
`2`	Sertifikanın anahtarı hiçbir API anahtarıyla eşleşmiyor
`3`	Çok fazla bağlantı: API anahtarı başına en fazla 128, adres başına en fazla 64. Bir bağlantı yeterlidir

Türetilen Anahtarınızı Kontrol Edin

Gösterge paneli, her API anahtarının yanında istemci açık anahtarını gösterir. QUIC bağlantınız reddedilirse ikisini karşılaştırın. Rust crate’i ile:

use orbitflare_apex::client_pubkey;

fn main() {
    let api_key = std::env::var("APEX_API_KEY").expect("APEX_API_KEY is required");
    // Prints the certificate key only, never the API key itself.
    println!("{}", client_pubkey(&api_key));
}

Go modülü ile:

package main

import (
	"fmt"
	"os"

	apex "github.com/orbitflare/orbitflare-apex-go"
)

func main() {
	fmt.Println(apex.ClientPubkey(os.Getenv("APEX_API_KEY")))
}

Uyuşmazlık, anahtarın yanlış kopyalandığı anlamına gelir.

Tarayıcılar

Her HTTP yanıtı Access-Control-Allow-Origin: * taşır ve OPTIONS ön kontrol istekleri yanıtlanır, dolayısıyla bir Apex uç noktasını tarayıcı kodundan çağırabilirsiniz.

Herkese açık bir web sayfasına gömülü API anahtarı her ziyaretçi tarafından görülebilir. Herkese açık ön yüzlerde gönderimi kendi arka ucunuz üzerinden yapın veya döndürmeye hazır olduğunuz bir anahtar kullanın.

Apex uç noktaları 80 numaralı portta düz HTTP üzerinden sunulur. Kendisi HTTPS üzerinden yüklenen bir sayfa, tarayıcının karışık içerik kurallarına tabidir, bu nedenle yayınlamayı planladığınız ortamdan test edin.

Başlarken

Ürünler

Çözümler

Veri Çekme

RPC

Veri Akışı

Apex

Ticaret API'leri

Apex Kimlik Doğrulama

API Anahtarı Alın

HTTP: başlık veya sorgu parametresi

QUIC: istemci sertifikası

Türetilen Anahtarınızı Kontrol Edin

Tarayıcılar

​API Anahtarı Alın

​HTTP: başlık veya sorgu parametresi

​QUIC: istemci sertifikası

​Türetilen Anahtarınızı Kontrol Edin

​Tarayıcılar

API Anahtarı Alın

HTTP: başlık veya sorgu parametresi

QUIC: istemci sertifikası

Türetilen Anahtarınızı Kontrol Edin

Tarayıcılar