Integration oluştur
Workspace'inizde yeni bir özel entegrasyon oluşturun
Workspace'inizde yeni bir özel entegrasyon oluşturur. Oluşturduktan sonra entegrasyona action ve trigger ekleyebilirsiniz.
Base URL
https://api.ajan.io/integrations/v1/createDedicated deployments Tüm isteklerde
api.ajan.com'u/api/publicile değiştirin.
Required Scopes
Bu endpoint INTEGRATION_API kapsamı gerektirir.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Entegrasyon adı (maks. 40 karakter) |
description | string | No | Entegrasyon açıklaması (maks. 90 karakter) |
Example
javascript
const axios = require("axios");
async function createIntegration() {
const response = await axios.post(
"https://api.ajan.io/integrations/v1/create",
{
name: "My Custom Integration",
description: "Connects to my internal company API for data retrieval"
},
{
headers: {
Authorization: "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
}
);
console.log("Created integration:", response.data.integration);
return response.data.integration.id;
}
createIntegration();Response Format
Success Response (201 Created)
typescript
{
integration: {
id: string; // UUID of the created integration
name: string; // Integration name
description: string; // Integration description
createdAt: string; // ISO 8601 timestamp
};
}Example Response
json
{
"integration": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "My Custom Integration",
"description": "Connects to my internal company API for data retrieval",
"createdAt": "2025-02-18T10:30:00.000Z"
}
}Error Handling
| Status Code | Description |
|---|---|
| 400 | Geçersiz istek gövdesi (ad çok uzun, geçersiz karakterler) |
| 401 | Geçersiz veya eksik API anahtarı |
| 429 | Rate limit aşıldı |
| 500 | İç sunucu hatası |
Sonraki adımlar
Bir entegrasyon oluşturduktan sonra genellikle şunları yaparsınız:
- Agent'ların yürütebileceği action ekleyin
- İş akışlarını başlatan trigger ekleyin
- Entegrasyonunuz gerektiriyorsa authentication yapılandırın
ajan, API anahtarınızı korumak ve uygulamalarınızın güvenliğini sağlamak için tarayıcı kaynaklı istekleri bilinçli olarak engeller. Daha fazla bilgi için API Key Best Practices kılavuzuna bakın.