Краткое руководство. Проверка орфографии с REST API "Проверка орфографии Bing" и PHP
Предупреждение
30 октября 2020 г. API Поиск Bing перенесены из служб ИИ Azure в Поиск Bing Services. Эта документация приводится только для справки. Обновленную информацию см. в документации по API Поиска Bing. Инструкции по созданию ресурсов Azure для Поиска Bing приведены в статье Создание ресурса для Поиска Bing с помощью Azure Marketplace.
В этом кратком руководстве показано, как отправить первый вызов к REST API "Проверка орфографии Bing". Это простое приложение PHP отправляет запрос к API и возвращает список предлагаемых исправлений.
Хотя это приложение написано на PHP, API представляет собой веб-службу на основе REST, совместимую с большинством языков программирования.
Предварительные требования
Создание ресурса Azure
Чтобы начать работу с API Проверки орфографии Bing, создайте один из следующих ресурсов Azure.
Ресурс проверки орфографии Bing
- доступен на портале Azure до удаления.
- Используйте бесплатную ценовую категорию, чтобы опробовать службу, а затем выполните обновление до платного уровня для рабочей среды.
- API Проверки орфографии Bing также предоставляется на некоторых уровнях ресурса Поиска Bing версии 7.
- доступен на портале Azure до удаления.
- Используйте один ключ и конечную точку для приложений в нескольких службах ИИ Azure.
Получение результатов REST API "Проверка орфографии Bing"
Создайте проект PHP в используемой вами интегрированной среде разработки.
Добавьте указанный ниже код.
Замените значение
subscriptionKey
ключом доступа, допустимым для подписки.Вы можете использовать глобальную конечную точку, указанную в коде ниже, или конечную точку личного поддомена, которая отображается на портале Azure для вашего ресурса.
Запустите программу.
<?php // NOTE: Be sure to uncomment the following line in your php.ini file. // ;extension=php_openssl.dll // These properties are used for optional headers (see below). // define("CLIENT_ID", "<Client ID from Previous Response Goes Here>"); // define("CLIENT_IP", "999.999.999.999"); // define("CLIENT_LOCATION", "+90.0000000000000;long: 00.0000000000000;re:100.000000000000"); $host = 'https://api.cognitive.microsoft.com'; $path = '/bing/v7.0/spellcheck?'; $params = 'mkt=en-us&mode=proof'; $input = "Hollo, wrld!"; $data = array ( 'text' => urlencode ($input) ); // NOTE: Replace this example key with a valid subscription key. $key = 'ENTER KEY HERE'; // The following headers are optional, but it is recommended // that they are treated as required. These headers will assist the service // with returning more accurate results. //'X-Search-Location' => CLIENT_LOCATION //'X-MSEdge-ClientID' => CLIENT_ID //'X-MSEdge-ClientIP' => CLIENT_IP $headers = "Content-type: application/x-www-form-urlencoded\r\n" . "Ocp-Apim-Subscription-Key: $key\r\n"; // NOTE: Use the key 'http' even if you are making an HTTPS request. See: // https://php.net/manual/en/function.stream-context-create.php $options = array ( 'http' => array ( 'header' => $headers, 'method' => 'POST', 'content' => http_build_query ($data) ) ); $context = stream_context_create ($options); $result = file_get_contents ($host . $path . $params, false, $context); if ($result === FALSE) { /* Handle error */ } $json = json_encode(json_decode($result), JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT); echo $json; ?>
Выполнение приложения
Выполните приложение, запустив веб-сервер и перейдите к файлу.
Пример ответа в формате JSON
Успешный ответ возвращается в формате JSON, как показано в примере ниже.
{
"_type": "SpellCheck",
"flaggedTokens": [
{
"offset": 0,
"token": "Hollo",
"type": "UnknownToken",
"suggestions": [
{
"suggestion": "Hello",
"score": 0.9115257530801
},
{
"suggestion": "Hollow",
"score": 0.858039839213461
},
{
"suggestion": "Hallo",
"score": 0.597385084464481
}
]
},
{
"offset": 7,
"token": "wrld",
"type": "UnknownToken",
"suggestions": [
{
"suggestion": "world",
"score": 0.9115257530801
}
]
}
]
}