Spext Geliştirici Platformu & REST API

Güvenli, şifreli ve süreli transfer altyapısını REST API, gerçek zamanlı Webhook ve yapay zeka Model Context Protocol (MCP) ile kendi uygulamanıza bağlayın.

REST API v1

Metin, dosya ve bağlantıları programatik olarak oluşturun, sorgulayın ve yaşam döngülerini yönetin.

Gerçek Zamanlı Webhooks

Transfer oluşturulduğunda, indirildiğinde veya silindiğinde HMAC SHA-256 imzalı anlık bildirimler alın.

Model Context Protocol (MCP)

Spext yeteneklerini Claude Desktop, Cursor ve bağımsız AI ajanlarına yerel araç olarak bağlayın.

Kriptografik Güvenlik (SSP)

PBKDF2 ve AES-GCM şifreleme zarfı ile sıfır bilgi (zero-knowledge) gizlilik prensibi.

Tek Seferlik (Burn-After-Reading)

İlk okuma anında bellekten ve veritabanından kalıcı olarak silinen atomik güvenlik mimarisi.

Idempotency Desteği

Ağ kopmalarında Idempotency-Key başlığı ile mükerrer işlem riskini sıfıra indirin.

Hızlı Başlangıç (Quickstart)

3 adımda ilk güvenli transferinizi oluşturun ve sisteminize entegre edin.

curl -X POST https://spext.fun/api/v1/transfers \
  -H "Authorization: Bearer spx_sk_live_abc123" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "type": "text",
    "text": "Gizli konfigürasyon anahtarı ve veritabanı parolası",
    "expiration": "1h",
    "oneTime": true
  }'

Kimlik Doğrulama & İzin Kapsamları (Scopes)

Spext REST API, endüstri standardı Bearer Token yöntemi ile korunmaktadır.

Authorization

Yetki Kapsamları (Granular Scopes)

En az yetki prensibi (least privilege) doğrultusunda API anahtarlarınıza yalnızca ihtiyaç duyulan kapsamları verin:

SECURITY BEST PRACTICES

• API anahtarlarınızı asla istemci tarafı (client-side) JavaScript kodunda veya Git depolarında tutmayın.
• Üretim ortamında ortam değişkenleri (Environment Variables) kullanın.
• Sızma şüphesinde Geliştirici Ayarları panelinden anahtarı derhal iptal edin (Revoke).
• Webhook isteklerinde her zaman X-Spext-Signature imzasını doğrulayın.

Kod yazmadan önce gerçek uç noktaları test edin, parametreleri değiştirin ve yanıt akışını izleyin.

API Referansı (Endpoints)

REST documentation with schemas, parameters, payloads, and response structures.

Webhooks & Olay Bildirimleri

Transfer erişimlerini, dosya indirmelerini ve sır tüketimlerini sunucunuza push bildirim olarak alın.

Kriptografik İmza Doğrulama (HMAC SHA-256)

Spext, her webhook isteğine X-Spext-Signature başlığı ekler. İsteğin gerçekten Spext sunucularından geldiğini teyit etmek için imza doğrulamasını uygulayın:

import crypto from 'crypto';

export function verifySpextWebhook(payloadString, signatureHeader, secretKey) {
  const [tPart, v1Part] = signatureHeader.split(',');
  const timestamp = tPart.split('=')[1];
  const signature = v1Part.split('=')[1];

  const signedPayload = `${timestamp}.${payloadString}`;
  const expectedSignature = crypto
    .createHmac('sha256', secretKey)
    .update(signedPayload)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expectedSignature)
  );
}

Model Context Protocol (MCP) Sunucusu

Spext yeteneklerini doğrudan Claude Desktop, Cursor, LangChain ve AI ajanlarına bağlayın.

Claude Desktop Yapılandırması (claude_desktop_config.json)

{
  "mcpServers": {
    "spext": {
      "command": "npx",
      "args": ["-y", "@spext/mcp-server"],
      "env": {
        "SPEXT_API_KEY": "spx_sk_live_your_key_here"
      }
    }
  }
}

Hız Limitleri, Hata Kodları & Idempotency

Yüksek erişilebilirlik ve güvenilirlik için belirlenmiş standart limit ve protokoller.

HTTP Status Codes

Geliştirici Sıkça Sorulan Sorular

Entegrasyon sürecinde merak edilen teknik detaylar ve yanıtları.

Spext API ile Entegrasyona Hemen Başlayın

Geliştirici anahtarınızı 30 saniyede oluşturun, dakikalar içinde güvenli ve şifreli veri transferi yapın.