وثائق API للتدقيق النحوي والإملائي

التحقق من القواعد النحوية للنص

https://api.textgears.com/grammar

تسمح لك هذه الطريقة بفحص النص بحثًا عن الأخطاء النحوية والإملائية وعلامات الترقيم والأسلوب.

معلمات الطلب

https://api.textgears.com/grammar?key=DEMO_KEY&text=I+is+an+engeneer!&language=en-GB

                                            
{
    status : true, // false in case of checking error
    response : {
        errors : [  // array of errors info
            0 : {
                id : "e492411846",  // unique error id
                offset : 2,  // error text offset
                length : 2,  // error text length
                bad : "is",  // error text
                better : [  // array of suggestions
                    0 : "am"
                ],
                type : "grammar"
            },
            1 : {
                id : "e627659964",  // unique error id
                offset : 8,  // error text offset
                length : 8,  // error text length
                bad : "engeneer",  // error text
                better : [  // array of suggestions
                    0 : "engineer",
                    1 : "engender"
                ],
                type : "spelling"
            }
        ]
    }
}
                                            
                                        

التدقيق الإملائي للنص

https://api.textgears.com/spelling

تقوم الطريقة بفحص النص بحثًا عن الأخطاء الإملائية باستخدام القاموس المحدث

معلمات الطلب

https://api.textgears.com/spelling?key=DEMO_KEY&text=I+is+an+engeneer!&language=en-GB

                                            
{
    status : true, // false in case of checking error
    response : {
        errors : [  // array of errors info
            0 : {
                id : "e627659964",  // unique error id
                offset : 8,  // error text offset
                length : 8,  // error text length
                bad : "engeneer",  // error text
                description: "Error description",
                better : [  // array of suggestions
                    0 : "engineer",
                    1 : "engender"
                ],
                type : "spelling"
            }
        ]
    }
}
                                            
                                        

نص التصحيح التلقائي

https://api.textgears.com/correct

هناك طريقتان للتصحيح التلقائي للنص. طريقة "correct" أكثر دقة بشكل ملحوظ ، لكنها تنطبق على طلبات الذكاء الاصطناعي.

معلمات الطلب

https://api.textgears.com/correct?text=What+are+you+name%3F&language=en-GB&key=DEMO_KEY

                                            
{
    status : true,  // false in case of checking error
    response : {
        corrected : "What is your name?"  // corrected text
    }
}
                                            
                                        

https://api.textgears.com/suggest

يقوم نظام التحقق تلقائيًا بتصحيح الأخطاء في النص ويقترح استمرار الجملة الأخيرة.

معلمات الطلب

https://api.textgears.com/suggest?key=DEMO_KEY&text=I+is+an+engeneer!+My+na

                                            
{
    status : true,  // false in case of checking error
    response : {
        corrected : "My name is Seth. My family",  // corrected text
        suggestions : [  // array of suggested text endings
            0 : {
                text : "My name is Seth. My family wishes",
                next_word : "wishes"
            },
            1 : {
                text : "My name is Seth. My family traditions",
                next_word : "traditions"
            },
            2 : {
                text : "My name is Seth. My family together",
                next_word : "together"
            },
            3 : {
                text : "My name is Seth. My family support",
                next_word : "support"
            },
            4 : {
                text : "My name is Seth. My family respectfully",
                next_word : "respectfully"
            }
        ]
    }
}
                                            
                                        

سهولة قراءة النص

https://api.textgears.com/readability

حساب قابلية قراءة النص وفقًا للخوارزميات الأكثر شيوعًا وتكييفها لمعظم اللغات. يمكنك معرفة المزيد حول مقاييس سهولة القراءة. من خلال قراءة مقالتنا المنفصلة .

معلمات الطلب

https://api.textgears.com/readability?key=DEMO_KEY&text=...

                                            
{
    status : true,  // false in case of checking error
    response : {
        stats : {
            fleschKincaid : { // Flesch–Kincaid index (https://en.wikipedia.org/wiki/Flesch–Kincaid_readability_tests)
                readingEase : 53.4, // Index value
                grade : "10th to 12th grade", // Flesch–Kincaid grade
                interpretation : "Fairly difficult to read" // index value interpretation
            },
            gunningFog : 12.2, // https://en.wikipedia.org/wiki/Gunning_fog_index
            colemanLiau : 12, // https://en.wikipedia.org/wiki/Coleman–Liau_index
            SMOG : 12, // https://en.wikipedia.org/wiki/SMOG
            vocabularySize : {
                active : null, // How many words author uses every day
                passive : null // How many words author knows
            },
            emotion : { // text emotion classifier
                positive : 0.79,
                negative : 0.21
            },
            counters : {
                length : 1128,
                clearLength : 936,
                words : 187,
                sentences : 10
            }
        }
    }
}
                                            
                                        

تحليل النص

https://api.textgears.com/analyze

تحليل نصي شامل. فهو يعثر على جميع أنواع الأخطاء ، ويحسب مقاييس القراءة ، ويصنف الإملاء على مقياس من 100 نقطة ، ويقيم أيضًا الحالة المزاجية العاطفية للنص.

معلمات الطلب

https://api.textgears.com/analyze?key=DEMO_KEY&text=...

                                            
{
    status : true, // false in case of checking error
    response : {
        grammar: {
            errors : [  // array of errors info
                0 : {
                    id : "e492411846",  // unique error id
                    offset : 2,  // error text offset
                    length : 2,  // error text length
                    description: "Error description",
                    bad : "is",  // error text
                    better : [  // array of suggestions
                        0 : "am"
                    ],
                    type : "grammar"
                },
                1 : {
                    id : "e627659964",  // unique error id
                    offset : 8,  // error text offset
                    length : 8,  // error text length
                    bad : "engeneer",  // error text
                    description: "Error description",
                    better : [  // array of suggestions
                        0 : "engineer",
                        1 : "engender"
                    ],
                    type : "spelling"
                }
            ],
        },
        stats: {
             fleschKincaid : { // Flesch–Kincaid index (https://en.wikipedia.org/wiki/Flesch–Kincaid_readability_tests)
                readingEase: 63.3, // Index value
                grade : "8th or 9th grade", // Flesch–Kincaid grade
                interpretation: "Plain English. Easily understood by 13- to 15-year-old students", // index value interpretation
             }
            gunningFog : 9.4, // https://en.wikipedia.org/wiki/Gunning_fog_index
            colemanLiau : 12, // https://en.wikipedia.org/wiki/Coleman–Liau_index
            SMOG : 6.5, // https://en.wikipedia.org/wiki/SMOG
            vocabularySize : {
                active: 5000, // How many words author uses every day
                passinve: 60000, // How many words author knows
            }
            emotion: { // text emotion classifier
                positive: 0.79, // probability
                negative: 0.21,
            }
        }
    }
}
                                            
                                        

كشف اللغة

https://api.textgears.com/detect

تحديد لغة النص وافتراض لهجته. تُرجع الطريقة مجموعة من الخيارات المحتملة لكل لغة ، فإذا لم يكن من الممكن تحديد اللغة بشكل لا لبس فيه ، فإن حقل language يعود null

معلمات الطلب

https://api.textgears.com/detect?key=DEMO_KEY&text=...

                                            
{
    status : true, // false in case of checking error
    response : {
        language : "en", // null if language was not detected
        dialect : "en-GB", // language dialect suggestion
        probabilities : { // descending
            "en" : 0.95,
            "fr" : 0.61,
            "ge" : 0.60,
            "fi" : 0.51,
        }
    }
}
                                            
                                        

التلخيص واستخراج الكلمات المفتاحية

https://api.textgears.com/summarize

معلمات الطلب

https://api.textgears.com/summarize?key=DEMO_KEY&language=en-GB&text=...

                                            
{
    status : true,  // false in case of checking error
    response : {
        keywords : [
            0 : "text",
            1 : "readability",
            2 : "english",
            3 : "printing",
            4 : "fewer",
            5 : "words",
            6 : "terms",
            7 : "higher",
            8 : "features",
            9 : "indexes"
        ],
        highlight : [ // Most important paragraph, starting with main sentence
            0 : "The two main factors of readability are the printing and linguistic features of the text.",
            1 : "In other words, pages containing simple and clear text get higher positions in the search results."
        ],
        summary : [ // Text summary sentences
            0 : "The two main factors of readability are the printing and linguistic features of the text.",
            1 : "The Flesch Kinkaid Score is the most popular way to measure the readability of English text.",
            2 : "It works on the principle of “the fewer words in the text, and the fewer syllables in them, the easier it is to perceive” and is most often used for checking essays in schools and universities."
        ]
    }
}
                                            
                                        

حصة الخطة

https://api.textgears.com/account/resourcequota

استقبال البيانات عن باقة الخطة الحالية. يمكن استخدام الطريقة لتتبع ما إذا كان عدد الطلبات التي تم إجراؤها داخل الخطة قد تم بالفعل ، أو عدد الطلبات التي لا يزال من الممكن تقديمها في فترة الفوترة

معلمات الطلب

https://api.textgears.com/account/resourcequota?key=DEMO_KEY

                                            
{
    status : true,
    response : {
        api : { // Resource type, "api" if you use TextGears API
            type : "api", // Resource type
            total : 1000000, // Total resource quota size
            used : 123000, // How many requests was made using this quota
            period_start: "2018-10-20T00:00:00+0000", // Quota paid period start (ISO8601 format)
            period_end: "2019-10-20T00:00:00+0000", // End of the quota paid period (ISO8601 format)
        },
    },
}
                                            
                                        

إحصائيات الاستخدام

https://api.textgears.com/account/usage

الحصول على إحصائيات استخدام واجهة برمجة التطبيقات لحسابك مع تصنيف حسب اليوم

معلمات الطلب

https://api.textgears.com/account/usage?key=DEMO_KEY

                                            
{
    status : true,  // false in case of checking error
    response : [
        0 : {
            date : "2020-04-20",
            request_count : 11875
        },
        1 : {
            date : "2020-04-21",
            request_count : 10588
        }
    ]
}
                                            
                                        

إنشاء القواميس وتحريرها

https://api.textgears.com/custom/createdictionary

إذا كنت بحاجة إلى إعداد مرن لفحص النص بحثًا عن أخطاء ، فاستخدم إعداد الاستثناءات المخصصة. سيكون هذا مفيدًا بشكل خاص للشركات التي تعمل مع نصوص مليئة بالكلمات من مفردات خاصة. اجعل الكلمات أو العبارات "صحيحة" حتى يتوقف النظام عن اعتبارها أخطاء. يمكنك أيضًا استخدامه للسماح للنظام بالعثور على الأخطاء وفقًا لقائمة الكلمات المحددة ، ويمكن دمج القواعد المخصصة وتحويلها إلى قواميس. يتيح هذا النهج للوظائف المختلفة لمنتجك استخدام مجموعة مختلفة من القواعد. في الوقت نفسه ، يمكن أن يكون لكل مستخدم لمنتجك مجموعة الاستثناءات الخاصة به

معلمات الطلب

https://api.textgears.com/custom/updatedictionary

https://api.textgears.com/custom/listdictionaries

https://api.textgears.com/custom/deletedictionary

أضف استثناء

https://api.textgears.com/custom/addexception

إذا كنت تتحقق من نصوص بمفردات محددة جدًا تم تمييزها على أنها أخطاء في نظامك ، فيمكنك إضافة كلمات أو عبارات إلى الاستثناءات. بعد ذلك ، لن يتم اعتبارهم أخطاء.

معلمات الطلب

https://api.textgears.com/custom/addexception?text=foobaring&type=2&lang=en-US&key=DEMO_KEY

                                            
{
    status : true,
    response : {
        id: 20, // New exception id
        text: "foobaring",
        type: 1,
        lang: "en-US",
        creation_time: "2024-12-27T06:37:53+0000",
        suggestions: [],
        update_time: null,
        description: null,
    },
}
                                            
                                        

قائمة الاستثناءات

https://api.textgears.com/custom/listexceptions

قائمة كلمات الاستبعاد المضافة سابقا

معلمات الطلب

https://api.textgears.com/custom/addexception?text=foobaring&key=DEMO_KEY

                                            
{
    status : true,
    response : {
        exceptions : [
            {
                id: 20,
                text: "foobaring",
                type: 1,
                lang: "en-US",
                creation_time: "2024-12-27T06:37:53+0000",
                update_time: null,
                description: null,
            },
        ],
    },
}
                                            
                                        

إزالة الاستثناء

https://api.textgears.com/custom/deleteexception

قم بإزالة كلمة الاستثناء للتدقيق. إذا حاولت حذف كلمة تم حذفها مسبقًا ، فلن يحدث خطأ.

معلمات الطلب

https://api.textgears.com/custom/deleteexception?id=20&key=DEMO_KEY

                                            
{
    status : true,
    response : {}
}