B3 Profiles API

Free Social Profiles API

Lihat referensi API profil

Ikhtisar

Layanan B3 Profiles berfungsi sebagai data API untuk menyelesaikan identitas pengguna terdesentralisasi di seluruh ekosistem EVM. Ini mengagregasi data profil dari berbagai sumber dan protokol, menyediakan pengembang dengan satu titik akhir API untuk mengakses informasi pengguna yang komprehensif dan konteks sosial.

Fitur Utama

Aggregasi Multi-Sumber

Menggabungkan data dari Basement, ENS, Thirdweb Social, dan penyedia identitas Web3 lainnya

Integrasi Identitas Sosial

Mengambil profil sosial dari ENS, Lens Protocol, dan jaringan Farcaster

Pencachingan Cerdas

Menggunakan penyimpanan KV Cloudflare untuk pencachingan data yang efisien dengan TTL yang dapat dikonfigurasi

Preferensi Pengguna

Memungkinkan pengguna untuk menetapkan sumber profil yang disukai melalui tanda tangan kriptografis

Sumber Data yang Didukung

  • ENS (Ethereum Name Service)
  • Lens Protocol
  • Farcaster
  • B3.ID
  • Profil Basement

Titik Akhir API

Lihat referensi API untuk detail lebih lanjut.

Pencarian Profil

Ambil informasi profil teragregasi untuk alamat dompet atau nama pengguna apa pun.
GET https://profiles.b3.fun/?address=0x1234567890abcdef1234567890abcdef12345678
GET https://profiles.b3.fun/?name=vitalik.eth
GET https://profiles.b3.fun/?name=sean.b3.fun

Menetapkan Preferensi Profil

Memungkinkan pengguna untuk menentukan sumber profil yang disukai melalui tanda tangan kriptografis.
POST /preference

Nama Tampilan Kustom

Memungkinkan pengguna untuk menetapkan nama tampilan kustom yang menggantikan semua sumber lain.
POST /display-name

Format Respons

Layanan mengembalikan objek profil terpadu yang menggabungkan data dari semua sumber:
{
  "name": "vitalik.eth",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "avatar": "https://example.com/avatar.jpg",
  "bio": "Co-founder Ethereum",
  "displayName": "Vitalik Buterin",
  "profiles": [
    {
      "type": "ensdata",
      "address": "0x123...",
      "name": "vitalik.eth",
      "avatar": "https://...",
      "bio": null,
      "displayName": null
    },
    {
      "type": "thirdweb-farcaster",
      "address": "0x123...",
      "name": "vitalik",
      "avatar": "https://...",
      "bio": "Co-founder Ethereum",
      "displayName": "Vitalik Buterin"
    }
  ]
}

Kasus Penggunaan

Autentikasi Dompet yang Ditingkatkan

Memberikan konteks kaya tentang pengguna saat koneksi dompet, menampilkan identitas sosial dan reputasi Web3 mereka di berbagai platform.

Integrasi Gaming Sosial

Menampilkan profil pemain yang komprehensif dalam game, termasuk nama ENS, pegangan sosial, dan identitas lintas platform.

Pengalaman Pengguna DeFi

Meningkatkan antarmuka perdagangan dengan menampilkan identitas pedagang dari Lens, Farcaster, dan ENS bukan hanya alamat dompet.

Manajemen Komunitas

Membangun alat komunitas yang lebih baik dengan mengagregasi identitas pengguna dari berbagai platform sosial Web3.

Contoh Penggunaan

Pencarian Profil Dasar

// Ambil profil berdasarkan alamat
const response = await fetch('https://profiles.b3.fun/?address=0x123...');
const profile = await response.json();

console.log(profile.displayName); // "Vitalik Buterin"
console.log(profile.profiles.length); // Jumlah sumber yang ditemukan

Resolusi Nama ENS

// Ambil profil berdasarkan nama ENS
const response = await fetch('https://profiles.b3.fun/?name=vitalik.eth');
const profile = await response.json();

console.log(profile.address); // Alamat dompet yang diselesaikan
console.log(profile.avatar); // URL avatar ENS

Menetapkan Preferensi Pengguna

// Tetapkan sumber profil yang disukai dengan tanda tangan
const message = `SetProfilePreference:${address}:thirdweb-farcaster:${timestamp}`;
const signature = await wallet.signMessage(message);

await fetch('https://profiles.b3.fun/preference', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    key: address,
    preferredType: 'thirdweb-farcaster',
    signature,
    signer: address,
    timestamp
  })
});

Performa & Pencachingan

  • Durasi Cache: 1 jam untuk data profil
  • Data Segar: Gunakan ?fresh=true untuk melewati cache
  • CDN Global: Didukung oleh jaringan edge Cloudflare
  • Penyimpanan KV: Penyimpanan kunci-nilai yang efisien untuk preferensi

Batas Tarif

Layanan mewarisi perlindungan DDoS bawaan Cloudflare dan pembatasan tarif. Untuk aplikasi bervolume tinggi, pertimbangkan untuk mengimplementasikan caching sisi klien atau hubungi tim B3 untuk akses perusahaan.

Membangun onchain menjadi mudah

Lihat referensi API untuk detail lebih lanjut.