Wespoke
Dokümantasyon

Workflow URL

Araç düzenleme sayfasının URL'sini alın

Endpoint

GET/api/v1/tools/:toolId/workflow-url

Belirtilen aracın dashboard üzerinde düzenleme sayfasına yönlendiren URL'i döner. Bu URL, kullanıcıları doğrudan araç düzenleme arayüzüne yönlendirmek için kullanılabilir.

URL Parametreleri

toolIdstring (gerekli)

Workflow URL'i alınacak aracın ID'si

İstek Örneği

cURL
curl -X GET https://api.wespoke.ai/api/v1/tools/tool_abc123/workflow-url \
  -H "Authorization: Bearer YOUR_API_KEY"

Yanıt Örneği

200 OK
{
  "success": true,
  "data": {
    "url": "https://dashboard.wespoke.ai/dashboard/tools/tool_abc123"
  }
}

Yanıt Alanları

urlstring

Aracın dashboard üzerinde düzenleme sayfasının tam URL'i

Kullanım Senaryoları

Otomatik Yönlendirme: API üzerinden araç oluşturduktan sonra kullanıcıyı düzenleme sayfasına yönlendirin

E-posta Bildirimleri: Araç oluşturulduğunda kullanıcıya gönderilen e-postalara düzenleme linkini ekleyin

Entegrasyon Araçları: Üçüncü parti uygulamalardan direkt Wespoke dashboard'a yönlendirme

Hata Ayıklama: Sorunlu araçlar için destek ekibine hızlı erişim linki sağlayın

Örnek Kullanım Akışı

1. Araç Oluşturma

Node.js
// Yeni araç oluştur
const createResponse = await fetch('https://api.wespoke.ai/api/v1/tools', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Yeni Araç',
    type: 'API_REQUEST',
    description: 'Test aracı',
    config: { url: 'https://api.example.com', method: 'GET' }
  })
});

const tool = await createResponse.json();
const toolId = tool.data.id;

2. Workflow URL'i Al

Node.js
// Workflow URL'i al
const urlResponse = await fetch(
  `https://api.wespoke.ai/api/v1/tools/${toolId}/workflow-url`,
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);

const urlData = await urlResponse.json();
const workflowUrl = urlData.data.url;

3. Kullanıcıyı Yönlendir

Node.js
// Kullanıcıyı dashboard'a yönlendir
window.location.href = workflowUrl;

// veya e-posta ile gönder
await sendEmail({
  to: user.email,
  subject: 'Aracınız oluşturuldu',
  body: `Aracınızı düzenlemek için: ${workflowUrl}`
});

Hata Yanıtları

404 Not Found
{
  "success": false,
  "error": {
    "code": "TOOL_NOT_FOUND",
    "message": "Araç bulunamadı"
  }
}

Önemli Notlar

• Dönen URL kullanıcının giriş yapması gerektirir.

• URL formatı değişebilir, API'den aldığınız tam URL'i kullanın.

• URL kalıcıdır ve aracın ID'si değişmedikçe geçerli kalır.

• Silinmiş araçlar için URL 404 hatası verir.

Araç SilBilgi Tabanları