ApiTranslator 1.0.0

ApiTranslator 🔄

REST, GraphQL ve SOAP API'leri arasında otomatik çeviri yapan .NET 8 middleware paketi.

📦 Kurulum

dotnet add package ApiTranslator

🚀 Kullanım

Fluent API

using ApiTranslator;
using ApiTranslator.Core.Enums;

// REST → GraphQL
var result = await ApiTranslate
    .From(ApiProtocol.REST)
    .To(ApiProtocol.GraphQL)
    .WithUrl("https://api.example.com/graphql")
    .WithParam("id", "1")
    .SendAsync();

// REST → SOAP
var result = await ApiTranslate
    .From(ApiProtocol.REST)
    .To(ApiProtocol.SOAP)
    .WithUrl("https://service.com/calculator.asmx")
    .WithMethod("POST")
    .WithBody("{\"intA\": 10, \"intB\": 5}")
    .SendAsync();

// GraphQL → REST
var result = await ApiTranslate
    .From(ApiProtocol.GraphQL)
    .To(ApiProtocol.REST)
    .WithUrl("https://jsonplaceholder.typicode.com/users/1")
    .WithBody("{ \"query\": \"{ user(id: 1) { id name email } }\" }")
    .SendAsync();

// SOAP → REST
var result = await ApiTranslate
    .From(ApiProtocol.SOAP)
    .To(ApiProtocol.REST)
    .WithUrl("https://jsonplaceholder.typicode.com/users/1")
    .WithMethod("GET")
    .SendAsync();

🔐 Authentication

// 1. API Key
var result = await ApiTranslate
    .From(ApiProtocol.REST)
    .To(ApiProtocol.GraphQL)
    .WithUrl("https://api.example.com/graphql")
    .WithApiKey("my-secret-key")
    .SendAsync();

// 2. Bearer Token
var result = await ApiTranslate
    .From(ApiProtocol.REST)
    .To(ApiProtocol.SOAP)
    .WithUrl("https://service.com/api")
    .WithBearerToken("eyJhbGciOiJIUzI1NiJ9...")
    .SendAsync();

// 3. Basic Auth
var result = await ApiTranslate
    .From(ApiProtocol.GraphQL)
    .To(ApiProtocol.REST)
    .WithUrl("https://api.example.com/users")
    .WithBasicAuth("admin", "password123")
    .SendAsync();

// 4. OAuth2 — token otomatik alınır
var result = await ApiTranslate
    .From(ApiProtocol.REST)
    .To(ApiProtocol.GraphQL)
    .WithUrl("https://api.example.com/graphql")
    .WithOAuth2(
        tokenEndpoint: "https://auth.example.com/token",
        clientId:      "my-client-id",
        clientSecret:  "my-secret",
        scope:         "api.read"
    )
    .SendAsync();

🏗️ Dependency Injection

// Program.cs
using ApiTranslator.Handlers;

builder.Services.AddApiTranslator(options =>
{
    options.IgnoreSslErrors = false;
    options.Timeout = TimeSpan.FromSeconds(30);
});

// Controller
public class MyController : ControllerBase
{
    private readonly ITranslationEngine _translator;

    public MyController(ITranslationEngine translator)
        => _translator = translator;

    public async Task<IActionResult> MyAction()
    {
        var result = await _translator.TranslateAsync(new TranslationRequest
        {
            SourceProtocol = ApiProtocol.REST,
            TargetProtocol = ApiProtocol.GraphQL,
            TargetUrl      = "https://api.example.com/graphql",
            QueryParams    = new() { { "id", "1" } }
        });

        return Ok(result.Body);
    }
}

🔄 Desteklenen Çeviriler

🔐 Desteklenen Auth Yöntemleri

🏗️ Mimari

ApiTranslator
├── Core        → Interface'ler ve modeller
├── Handlers    → REST, GraphQL, SOAP handler'ları
└── Gateway     → Demo Web API (Swagger)

Strategy Pattern + Adapter Pattern kullanılmıştır.

📄 Lisans

MIT © 2024