تیم GroupDocs همیشه مشتاقانه کار می کند تا راه حل های خارج از جعبه را برای کاربران خود ارائه دهد، در این راستا ما با افتخار اولین نسخه از نسل بعدی GroupDocs.Comparison Cloud 17.12 REST API را اعلام می کنیم. برای استفاده عمومی این یک API مقایسه اسناد مستقل از پلتفرم REST است که می تواند با هر زبان توسعه ای یکپارچه شود. Document Comparison Cloud API ما دو منبع اصلی را برای عملیات مقایسه اسناد ارائه می دهد، Changes و Comparison Document که به شما امکان می دهد مجموعه ای از تغییرات را دریافت کنید یا مسیر فایل سند نتیجه یا جریان را دریافت کنید. این API می تواند در برنامه های شما برای تجربه کاربری بهتر و عملکرد بهتر استفاده شود. از تمام فرمت‌های اصلی اسناد تجاری و تصویر پشتیبانی می‌کند، لطفاً برای جزئیات بیشتر اینجا را کلیک کنید.

ویژگی - GroupDocs.Comparison Cloud

GroupDocs.Comparison Cloud یک API REST برای مقایسه تقریباً تمام اسناد اصلی و فرمت‌های تصویر مانند Word، Cell، Html، PDF، PowerPoint و Image است. برخی از ویژگی های اصلی به شرح زیر است. برای جزئیات کامل می توانید از یادداشت های انتشار دیدن کنید.

منابع سند:

منبع تغییرات:

تغییرات را از اسناد مقایسه شده دریافت کنید

شما می توانید به سرعت سند را با سایر اسناد با فرمت های مشابه مقایسه کنید. در اینجا لیستی از [فرمت‌های پشتیبانی‌شده5 آمده است، لطفاً به مثال سریع مقایسه DOCX با DOCX با استفاده از GroupDocs.Comparison Cloud API نگاهی بیندازید.

URL

 https://apireference.groupdocs.cloud/comparison/#!/Changes/PostChanges

درخواست بدن

{'sourceFile':{'folder':'comparisons','name':'source.docx','password':''},'targetFiles':[{'folder':'comparisons','name':'target.docx','password':''}],'settings ':{'generateSummaryPage':true,'showDeletedContent':true,'styleChangeDetection':true,'insertedItemsStyle':{'color':'Blue','beginSeparatorString':'','endSeparatorString':'','bold':false,'italic':false,'strikeThrough':false},'deletedItemsStyle':{'color':'Red','beginSeparatorString':'','endSeparatorString':'','bold':false,'italic':false,'strikeThrough':false},'styleChangedItemsStyle':{'color':'Green','beginSeparatorString':'','endSeparatorString':'','bold':false,'italic':false,'strikeThrough':false},'wordsSeparatorChars':[],'detailLevel':'Low','useFramesForDelInsElements':false,'calculateComponentCoordinates':false,'markDeletedInsertedContentDeep':false},'changes':[{'id':0,'action':'Reject'},{'id':1,'action':'Reject'}]}"

مثال cURL

curl -v "https://api.groupdocs.cloud/v1.0/comparison/compareDocuments/changes?appsid=XXXX&signature=XXX-XX"
-H "content-type: application/json"
-X POST -d "{'sourceFile':{'folder':'comparisons','name':'source.docx','password':''},'targetFiles':[{'folder':'comparisons','name':'target.docx','password':''}],'settings ':{'generateSummaryPage':true,'showDeletedContent':true,'styleChangeDetection':true,'insertedItemsStyle':{'color':'Blue','beginSeparatorString':'','endSeparatorString':'','bold':false,'italic':false,'strikeThrough':false},'deletedItemsStyle':{'color':'Red','beginSeparatorString':'','endSeparatorString':'','bold':false,'italic':false,'strikeThrough':false},'styleChangedItemsStyle':{'color':'Green','beginSeparatorString':'','endSeparatorString':'','bold':false,'italic':false,'strikeThrough':false},'wordsSeparatorChars':[],'detailLevel':'Low','useFramesForDelInsElements':false,'calculateComponentCoordinates':false,'markDeletedInsertedContentDeep':false},'changes':[{'id':0,'action':'Reject'},{'id':1,'action':'Reject'}]}"

GoupDocs.Comparison Cloud API .NET SDK مثال

 var configuration = new Configuration

{
    AppSid = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    AppKey = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
};
// Initiate API object
var apiInstance = new ChangesApi(configuration);
try
{
    // Comparison Request
    ComparisonRequest comparisonRequest = new ComparisonRequest()
    {
        // Comparison Request Settings
        Settings = new ComparisonRequestSettings()
        {
            GenerateSummaryPage = true,
            ShowDeletedContent = true,
            StyleChangeDetection = true,
            UseFramesForDelInsElements = false,
            DetailLevel = "Low",
            DeletedItemsStyle = new StyleSettingsValues()
            {
                BeginSeparatorString = "",
                EndSeparatorString = "",
                Color = new Color().Red
            },
            InsertedItemsStyle = new StyleSettingsValues()
            {
               BeginSeparatorString = "",
                EndSeparatorString = "",
               Color = new Color().Blue
            },
            StyleChangedItemsStyle = new StyleSettingsValues()
            {
               BeginSeparatorString = "",
               EndSeparatorString = "",
                Color = new Color().Green
            },
            CalculateComponentCoordinates = false,
            CloneMetadata = "Source",
            MarkDeletedInsertedContentDeep = false,
            MetaData = new ComparisonMetadataValues()
          {
                Author = "GroupDocs",
                Company = "GroupDocs",
                LastSaveBy = "GroupDocs"
          },
            Password = "",
            PasswordSaveOption = ""

        },
        // Source file
        SourceFile = new ComparisonFileInfo()
        {
           Folder = "comparisons",
            Name = "source.docx",
            Password = ""
        }
    };

    List targets = new List();
    // Target file
    targets.Add(new ComparisonFileInfo()
    {
        Folder = "comparisons",
        Name = "target.docx",
        Password = ""
    });
    // Target file - single or multiple target files are allowed.
   comparisonRequest.TargetFiles = targets.ToArray();

    // Accept or Reject changes
    comparisonRequest.Changes = new List();
    comparisonRequest.Changes.Add(new ComparisonChange() { Id = 0, Action = "Accept" });
    comparisonRequest.Changes.Add(new ComparisonChange() { Id = 1, Action = "Reject" });

    // API call for response.

    var response = apiInstance.PostChanges(new Model.Requests.PostChangesRequest() { Request =    comparisonRequest });

    Console.WriteLine(string.Format("{0}: {1}", "response is List", response.Count.ToString()));
}
catch (Exception e)
{
    Console.WriteLine("Exception when calling ChangesApi.PostChanges: " + e.Message);
}

دریافت منابع سند

می‌توانید اسناد را با هم مقایسه کنید و با ارائه داده‌های JsonRequest Object در بدنه درخواست، مسیر سند نتیجه را دریافت کنید. نمونه زیر GroupDocs.Comparison Cloud REST API را می توان برای دریافت مسیر سند نتیجه استفاده کرد.

URL

 [`https://apireference.groupdocs.cloud/comparison/#!/Comparison/Comparison`](https://apireference.groupdocs.cloud/comparison/#!/Comparison/Comparison)

درخواست بدن

{'sourceFile':{'folder':'comparisons','name':'source.docx','password':''},'targetFiles':[{'folder':'comparisons','name':'target.docx','password':''}],'settings ':{'generateSummaryPage':true,'showDeletedContent':true,'styleChangeDetection':true,'insertedItemsStyle':{'color':'Blue','beginSeparatorString':'','endSeparatorString':'','bold':false,'italic':false,'strikeThrough':false},'deletedItemsStyle':{'color':'Red','beginSeparatorString':'','endSeparatorString':'','bold':false,'italic':false,'strikeThrough':false},'styleChangedItemsStyle':{'color':'Green','beginSeparatorString':'','endSeparatorString':'','bold':false,'italic':false,'strikeThrough':false},'wordsSeparatorChars':[],'detailLevel':'Low','useFramesForDelInsElements':false,'calculateComponentCoordinates':false,'markDeletedInsertedContentDeep':false},'changes':[{'id':0,'action':'Reject'},{'id':1,'action':'Reject'}]}"

مثال cURL

curl -v  "https://api.groupdocs.cloud/v1.0/comparison/compareDocuments?outPath=comparisons%2Fcomparedoutput.docx&appsid=XXXX&signature=XXX-XX" 
-H "Content-Type: application/json"
-X POST -d  "{'sourceFile':{'folder':'comparisons','name':'source.docx','password':''},'targetFiles':[{'folder':'comparisons','name':'target.docx','password':''}],'settings
  ':{'generateSummaryPage':true,'showDeletedContent':true,'styleChangeDetection':true,'insertedItemsStyle':{'color':'Blue','beginSeparatorString':'','endSeparatorString':'','bold':false,'italic':false,'strikeThrough':false},'deletedItemsStyle':{'color':'Red','beginSeparatorString':'','endSeparatorString':'','bold':false,'italic':false,'strikeThrough':false},'styleChangedItemsStyle':{'color':'Green','beginSeparatorString':'','endSeparatorString':'','bold':false,'italic':false,'strikeThrough':false},'wordsSeparatorChars':[],'detailLevel':'Low','useFramesForDelInsElements':false,'calculateComponentCoordinates':false,'markDeletedInsertedContentDeep':false},'changes':[{'id':0,'action':'Reject'},{'id':1,'action':'Reject'}]}"

GoupDocs.Comparison Cloud API .NET SDK مثال

 var configuration = new Configuration
{
    AppSid = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    AppKey = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
};

// Initiate API object
var apiInstance = new ComparisonApi(configuration);

try
{
    // Comparison Request
    ComparisonRequest comparisonRequest = new ComparisonRequest()
    {
        // Comparison Request Settings
        Settings = new ComparisonRequestSettings()
        {
            GenerateSummaryPage = true,
            ShowDeletedContent = true,
            StyleChangeDetection = true,
            UseFramesForDelInsElements = false,
            DetailLevel = "Low",
            DeletedItemsStyle = new StyleSettingsValues()
            {
                BeginSeparatorString = "",
                EndSeparatorString = "",
                Color = new Color().Red
            },
            InsertedItemsStyle = new StyleSettingsValues()
            {
                BeginSeparatorString = "",
                EndSeparatorString = "",
                Color = new Color().Blue
            },
            StyleChangedItemsStyle = new StyleSettingsValues()
            {
                BeginSeparatorString = "",
                EndSeparatorString = "",
                Color = new Color().Green
            },
            CalculateComponentCoordinates = false,
            CloneMetadata = "Source",
            MarkDeletedInsertedContentDeep = false,
            MetaData = new ComparisonMetadataValues()
            {
                Author = "GroupDocs",
                Company = "GroupDocs",
                LastSaveBy = "GroupDocs"
            },
            Password = "",
            PasswordSaveOption = ""
        },
        // Source file
        SourceFile = new ComparisonFileInfo()
        {
            Folder = "comparisons",
            Name = "source.docx",
            Password = ""
        }
    };

    List targets = new List();
    // Target file
    targets.Add(new ComparisonFileInfo()
    {
        Folder = "comparisons",
        Name = "target.docx",
        Password = ""
    });
    // Target file - single or multiple target files are allowed.
    comparisonRequest.TargetFiles = targets.ToArray();

    // API call for response.
    var response = apiInstance.Comparison(new Model.Requests.ComparisonRequest() { Request = comparisonRequest, OutPath = "comparisons/compare-result.docx" });

    Console.WriteLine(string.Format("{0}: {1}", "response is Link", response.Href.ToString()));
}
catch (Exception e)
{
    Console.WriteLine("Exception when calling ComparisonApi.Comparison: " + e.Message);
}

API Explorer

GroupDocs Cloud یک کاوشگر Web API برای آزمایش API ما بلافاصله در مرورگر شما فراهم می کند. این مجموعه ای از اسناد Swagger برای APIهای Cloud GroupDocs است. با استفاده از Web API explorer می توانید اطلاعاتی در مورد تمام منابع موجود در API بدست آورید. همچنین آزمایش و تعامل را برای اسناد نقطه پایانی API ما ارائه می دهد. لطفاً برای جزئیات بیشتر اینجا را کلیک کنید.

SDKsGroupDocs.Comparison

Cloud API SDKs را برای استفاده از ویژگی‌های آن در پلتفرم مورد علاقه‌تان مانند دات‌نت ارائه می‌کند. SDK ها در مخزن GitHub ما همراه با نمونه های کاری میزبانی می شوند تا در کمترین زمان شروع به کار کنید.

GroupDocs.Comparison

Cloud API Resourcesشما می توانید برای شروع و کار با API از منابع API زیر دیدن کنید.

امروز یک آزمایش رایگان را شروع کنید

یک آزمایش رایگان را از امروز شروع کنید – تنها چیزی که نیاز دارید این است که با سرویس GroupDocs Cloud ثبت نام کنید. پس از ثبت نام، آماده هستید تا ویژگی های پردازش فایل قدرتمند ارائه شده توسط GroupDocs Cloud را امتحان کنید.