API Dokümantasyonu

VixPaste RESTful API'si ile programatik olarak paste oluşturabilir, görüntüleyebilir ve yönetebilirsiniz.

Hızlı Başlangıç

Base URL

https://paste.vixware.net/api/

Response Format

application/json

Rate Limiting

IP başına saatte 20 paste oluşturabilirsiniz

Test Endpoint

API Test Et

POST Paste Oluşturma

Yeni bir paste oluşturur

Endpoint

https://paste.vixware.net/api/create

Parametreler

content Gerekli

Paste içeriği (max: 1 MB)

title Opsiyonel

Paste başlığı (max: 100 karakter)

language Opsiyonel

Programlama dili (varsayılan: text)

expiry Opsiyonel

Saniye cinsinden yaşam süresi (0 = kalıcı)

Örnek İstek

curl -X POST "https://paste.vixware.net/api/create" \
  -F "content=console.log('Hello World');" \
  -F "title=My JavaScript Code" \
  -F "language=javascript" \
  -F "expiry=86400"

Başarılı Yanıt (201)

{
  "success": true,
  "message": "Paste created successfully",
  "id": "abc123",
  "url": "https://paste.vixware.net/paste/abc123",
  "raw_url": "https://paste.vixware.net/raw/abc123",
  "created_at": 1770165875}

GET Paste Getirme

Belirtilen ID'ye sahip paste'i getirir

Endpoint

https://paste.vixware.net/api/get/{id}

Örnek İstek

curl "https://paste.vixware.net/api/get/abc123"

# Şifre korumalı paste için:
curl "https://paste.vixware.net/api/get/abc123?password=mypass"

Başarılı Yanıt (200)

{
  "success": true,
  "paste": {
    "id": "abc123",
    "title": "My Code",
    "content": "console.log('Hello');",
    "language": "javascript",
    "created_at": 1770165875,
    "views": 5,
    "urls": {
      "view": "https://paste.vixware.net/paste/abc123",
      "raw": "https://paste.vixware.net/raw/abc123"
    }
  }
}

GET Platform İstatistikleri

Platform kullanım istatistiklerini getirir

Endpoint

https://paste.vixware.net/api/stats

Örnek İstek

curl "https://paste.vixware.net/api/stats"

Yanıt İçeriği

total_pastes - Toplam paste sayısı
total_views - Toplam görüntülenme
language_distribution - Dil dağılımı
recent_pastes - Son pasteler

Hata Kodları

HTTP Kodu Açıklama Olası Sebepler
200 Success İstek başarılı
201 Created Paste başarıyla oluşturuldu
400 Bad Request Geçersiz parametreler, eksik content
401 Unauthorized Şifre gerekli
404 Not Found Paste bulunamadı veya süresi dolmuş
429 Too Many Requests Rate limit aşıldı
500 Internal Server Error Sunucu hatası

Kod Örnekleri

JavaScript (Fetch API)

// Paste oluşturma
async function createPaste(content, title) {
  const formData = new FormData();
  formData.append('content', content);
  formData.append('title', title);
  
  const response = await fetch('/api/create', {
    method: 'POST',
    body: formData
  });
  
  return await response.json();
}

// Kullanım
createPaste('console.log("Hello");', 'Test')
  .then(data => console.log(data.url));

Python (requests)

import requests

# Paste oluşturma
def create_paste(content, title=''):
    url = 'https://paste.vixware.net/api/create'
    data = {
        'content': content,
        'title': title,
        'language': 'python'
    }
    
    response = requests.post(url, data=data)
    return response.json()

# Kullanım
result = create_paste('print("Hello")', 'Test')
print(result['url'])

Destek

API ile ilgili sorularınız için aşağıdaki kanalları kullanabilirsiniz: