API Referansı
Solidus sekiz API yüzeyi sunar. Yedisi REST hizmetidir ve biri doğrudan blok zinciri erişimi için bir JSON-RPC uç noktasıdır. Explorer tamamen herkese açıktır; geri kalanı kimlik doğrulaması gerektirir.
Hizmetler
| Service | Base URL | Purpose |
|---|---|---|
| Verify | https://verify.solidus.network/v1 | KYC doğrulama — belge yükleme, OCR, yüz eşleştirme, kimlik bilgisi düzenleme |
| Identity | https://identity.solidus.network/v1 | DID cüzdanı — kimlik bilgileri, paylaşım, bağlı hesaplar, herkese açık profiller |
| Agents | https://agents.solidus.network/v1 | Yapay zeka ajanı kimliği — ajan DID’leri, BBS+ kimlik bilgileri, ERC-8004 pasaportları, harcama yetkilendirmeleri |
| Auth OIDC | https://auth.solidus.network | DID tabanlı kimlikle OpenID Connect sağlayıcısı |
| JSON-RPC | https://rpc.solidus.network | Blok zinciri düğümü — bloklar, işlemler, DID çözümleme |
| Explorer | https://explorer.solidus.network/api/v1 | Zincir verisi — bloklar, işlemler, adresler, DID’ler, kimlik bilgileri, doğrulayıcılar. Kimlik doğrulama yok. |
| Relay | https://relay.solidus.network | DIDComm v2 aracısı — mesaj alma, iletme yönlendirmesi, anahtar listeleri — artı bir operatör API’si |
| Wallet | https://wallet.solidus.network/v1 | Cüzdan hesapları — portföy, transferler, stake etme, sosyal kurtarma. Gözetimsiz (non-custodial): anahtarlar hiçbir zaman sunucuya ulaşmaz |
| Pod | https://pod.solidus.network | Solid pod’ları (Community Solid Server) — LDP kaynakları, WAC, Solid-OIDC — artı bir provizyonlama API’si |
Tüm REST uç noktaları JSON döndürür. JSON-RPC uç noktası, JSON-RPC 2.0 spesifikasyonunu izler.
Agents API ayrıca tam, otomatik üretilen bir OpenAPI 3.1 spesifikasyonu yayınlar
(https://agents.solidus.network/openapi.json, /documentation’da göz atılabilir) — bkz.
Agents API.
Kimlik Doğrulama Yöntemleri
Solidus API’leri, bağlama bağlı olarak üç kimlik doğrulama yöntemi kullanır.
JWT Bearer Token’ları
/auth/login üzerinden giriş yaparak veya bir OAuth akışını tamamlayarak elde edilir. Bunları
Authorization başlığında iletin.
curl https://verify.solidus.network/v1/auth/me \
-H "Authorization: Bearer eyJhbGciOiJFZERTQSIs..."API Anahtarları
Verify kontrol panelinden üretilir. Bunları x-api-key başlığında iletin. Her anahtar live veya
sandbox moduna kapsamlanmıştır.
curl https://verify.solidus.network/v1/verifications \
-H "x-api-key: sk_live_abc123def456..."Oturum Token’ları
Barındırılan doğrulama akışında kullanılır. Token, oturum URL’sine gömülüdür ve tek bir doğrulama oturumunu tanımlar. Hiçbir başlık gerekmez — token, URL yolunun bir parçasıdır.
https://verify.solidus.network/v/s/sess_tok_7Hk3mRtQZv...Temel URL’ler
| Environment | Verify | Identity | Agents | Auth | RPC |
|---|---|---|---|---|---|
| Testnet | https://verify.solidus.network/v1 | https://identity.solidus.network/v1 | https://agents.solidus.network/v1 | https://auth.solidus.network | https://rpc.solidus.network |
| Mainnet | Henüz kullanılamıyor | Henüz kullanılamıyor | Henüz kullanılamıyor | Henüz kullanılamıyor | Henüz kullanılamıyor |
Şu anki tüm uç noktalar testnet üzerinde çalışır. Mainnet URL’leri, başlatıldığında aynı yapıyı izleyecektir.
Hata Biçimi
Tüm REST API’leri hataları tutarlı bir biçimde döndürür.
{
"error": "Unauthorized",
"message": "Invalid or expired token",
"statusCode": 401
}Yaygın durum kodları:
| Code | Meaning |
|---|---|
400 | Hatalı istek — geçersiz veya eksik parametreler |
401 | Yetkisiz — eksik veya geçersiz kimlik doğrulama |
403 | Yasak — geçerli kimlik doğrulama ama yetersiz izin |
404 | Bulunamadı — kaynak mevcut değil |
409 | Çakışma — kaynak zaten mevcut (ör. yinelenen e-posta) |
422 | İşlenemez — doğrulama başarısız oldu |
429 | Hız sınırlandı |
500 | Sunucu iç hatası |
Hız Sınırları
Testnet şu anda hız sınırına sahip değildir. Üretim hız sınırları mainnet lansmanında uygulanacak ve burada belgelenecektir.
API Bölümleri
- Verify API — KYC doğrulama oturumları, belge yükleme, canlılık, webhook’lar
- Identity API — DID cüzdanı, kimlik bilgileri, paylaşım, gelen kutusu
- Agents API — Ajan DID’leri, BBS+ kimlik bilgileri, ERC-8004 pasaportları, harcama yetkilendirmeleri
- Auth OIDC — OpenID Connect yetkilendirme, token’lar, userinfo
- JSON-RPC — Blok zinciri sorguları, DID çözümleme, işlemler