YamanVM Public API Dokümantasyonu

Swagger referansı ve gerçek entegrasyon örnekleri birlikte hazır.

Bu sayfa endpoint referansını verir. Hızlı başlamak için PHP, Node.js ve Python örneklerini hemen aşağıda görebilir, daha öğretici akış için ayrı how-to sayfasına geçebilirsiniz.

1. Token oluşturun

Admin panelden API client oluşturun ve tokenı sadece üretildiği anda kaydedin.

2. Ping ile test edin

`GET /api/v1/ping` ile auth, header ve connectivity tarafını doğrulayın.

3. Task modelini benimseyin

Provision, format ve snapshot işlemleri asenkron task döner; sonucu task endpoint’lerinden takip edin.

Hızlı Başlangıç Örnekleri

Aşağıdaki örnekler Swagger kullanmadan da entegrasyonun iskeletini kurmanızı sağlar. Daha ayrıntılı anlatım için How-To Rehberi.

Starter PHP

Düz PHP + cURL başlangıç dosyası.

php-client.php

Starter Node.js

Basit fetch tabanlı başlangıç dosyası.

node-client.mjs

Starter Python

Requests tabanlı başlangıç dosyası.

python-client.py

Postman

İçe aktarılabilir Postman collection.

postman_collection.json

<?php
$baseUrl = rtrim('https://yamanvm.yamanhosting.com', '/');
$token = 'yvm_live_xxxxxxxxxxxxxxxxx';
$requestId = 'php-quickstart-001';

$headers = [
    'Authorization: Bearer ' . $token,
    'Accept: application/json',
    'X-Request-Id: ' . $requestId,
];

$ch = curl_init($baseUrl . '/api/v1/ping');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers,
]);

$raw = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($raw, true);
var_dump($status, $data);

const baseUrl = 'https://yamanvm.yamanhosting.com';
const token = 'yvm_live_xxxxxxxxxxxxxxxxx';

const response = await fetch(`${baseUrl}/api/v1/servers`, {
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: 'application/json',
    'X-Request-Id': 'node-quickstart-001',
  },
});

const data = await response.json();
console.log(response.status, data);

import requests

base_url = "https://yamanvm.yamanhosting.com"
token = "yvm_live_xxxxxxxxxxxxxxxxx"

response = requests.get(
    f"{base_url}/api/v1/servers/3/tasks",
    headers={
        "Authorization": f"Bearer {token}",
        "Accept": "application/json",
        "X-Request-Id": "python-quickstart-001",
    },
    timeout=30,
)

print(response.status_code)
print(response.json())