微信公众平台消息接口开发(13)多语种互译

简介: 微信公众平台消息接口 微信公众平台API 微信开发模式 多语种翻译 多语言互译 Microsoft Translator 方倍工作室     Paraphrase API   10 out of 11 rated this helpful - Rate this topic   ...

微信公众平台消息接口 微信公众平台API 微信开发模式 多语种翻译 多语言互译 Microsoft Translator 方倍工作室

 

 

Paraphrase API

 

10 out of 11 rated this helpful - Rate this topic

 

The Paraphrase API is an English-to-English machine translation system that rephrases English sentences in English. This API uses the same architecture that the Microsoft Translator API uses for translation. The purpose of the Paraphrase API is to reword or rephrase the content without losing its meaning or idea. The Paraphrase API uses the REST service using GET over HTTP. It uses simple XML and JSON formatting.

Endpoint

The endpoint of the Paraphrase API is either one of the following:

  • http://api.microsofttranslator.com/v3/json/paraphrase
  • http://api.microsofttranslator.com/v3/rest/paraphrase
Parameters
Parameter Description
appId Required. A string containing the access token or application ID.
language Required. A string representing the language code. This parameter supports only ENGLISH with en as the language name.
Category Optional. A string containing the category or domain of the translation. This parameter supports only the default option general.
sentence Required. A sentence that you want to paraphrase. This parameter supports only one sentence as the input. Multiple sentences will fail, and an error code with the message will be displayed.
maxTranslations Optional. The number of paraphrased sentences for the sentence that you specified in the sentence parameter. The API will return as many paraphrased sentences as the number that you specify in the maxTranslations parameter.

Return value

The return value provides as many paraphrased sentences as the number specified in the maxTranslations request parameter.

JSON
ParaphraseResponse
{
     int errorCode;  // A positive number representing an error condition
     string errorMessage; // A descriptive error message 
     string[] paraphrases; // all paraphrases found
}

Error Messages

The following are the most common error messages.

  • ErrorNoParaphrasesFound – “The system did not find any paraphrase for the input sentence.”
  • ErrorInvalidAppid – “The AppId X is invalid.”
  • ErrorInvalidNumberOfSentences – “Only one sentence is supported. The request contains X sentences.”
  • ErrorInvalidCategory – “Category X is invalid.”
  • ErrorInvalidLanguage – “Language X is not supported.”

Example

PHP

has some issues !!!

<?php

class AccessTokenAuthentication {
    /*
     * Get the access token.
     *
     * @param string $grantType    Grant type.
     * @param string $scopeUrl     Application Scope URL.
     * @param string $clientID     Application client ID.
     * @param string $clientSecret Application client ID.
     * @param string $authUrl      Oauth Url.
     *
     * @return string.
     */
    function getTokens($grantType, $scopeUrl, $clientID, $clientSecret, $authUrl){
        try {
            //Initialize the Curl Session.
            $ch = curl_init();
            //Create the request Array.
            $paramArr = array (
                 'grant_type'    => $grantType,
                 'scope'         => $scopeUrl,
                 'client_id'     => $clientID,
                 'client_secret' => $clientSecret
            );
            //Create an Http Query.//
            $paramArr = http_build_query($paramArr);
            //Set the Curl URL.
            curl_setopt($ch, CURLOPT_URL, $authUrl);
            //Set HTTP POST Request.
            curl_setopt($ch, CURLOPT_POST, TRUE);
            //Set data to POST in HTTP "POST" Operation.
            curl_setopt($ch, CURLOPT_POSTFIELDS, $paramArr);
            //CURLOPT_RETURNTRANSFER- TRUE to return the transfer as a string of the return value of curl_exec().
            curl_setopt ($ch, CURLOPT_RETURNTRANSFER, TRUE);
            //CURLOPT_SSL_VERIFYPEER- Set FALSE to stop cURL from verifying the peer's certificate.
            curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
            //Execute the  cURL session.
            $strResponse = curl_exec($ch);
            //Get the Error Code returned by Curl.
            $curlErrno = curl_errno($ch);
            if($curlErrno){
                $curlError = curl_error($ch);
                throw new Exception($curlError);
            }
            //Close the Curl Session.
            curl_close($ch);
            //Decode the returned JSON string.
            $objResponse = json_decode($strResponse);
            if ($objResponse->error){
                throw new Exception($objResponse->error_description);
            }
            return $objResponse->access_token;
        } catch (Exception $e) {
            echo "Exception-".$e->getMessage();
        }
    }
}

/*
 * Class:HTTPTranslator
 *
 * Processing the translator request.
 */
Class HTTPTranslator {
    /*
     * Create and execute the HTTP CURL request.
     *
     * @param string $url        HTTP Url.
     * @param string $authHeader Authorization Header string.
     *
     * @return string.
     *
     */
    function curlRequest($url, $authHeader){
        //Initialize the Curl Session.
        $ch = curl_init();
        //Set the Curl url.
        curl_setopt ($ch, CURLOPT_URL, $url);
        //Set the HTTP HEADER Fields.
        curl_setopt ($ch, CURLOPT_HTTPHEADER, array($authHeader));
        //CURLOPT_RETURNTRANSFER- TRUE to return the transfer as a string of the return value of curl_exec().
        curl_setopt ($ch, CURLOPT_RETURNTRANSFER, TRUE);
        //CURLOPT_SSL_VERIFYPEER- Set FALSE to stop cURL from verifying the peer's certificate.
        curl_setopt ($ch, CURLOPT_SSL_VERIFYPEER, False);
        //Execute the  cURL session.
        $curlResponse = curl_exec($ch);
        //Get the Error Code returned by Curl.
        $curlErrno = curl_errno($ch);
        if ($curlErrno) {
            $curlError = curl_error($ch);
            throw new Exception($curlError);
        }
        //Close a cURL session.
        curl_close($ch);
        return $curlResponse;
    }
}

try {
    //Client ID of the application.
    $clientID       = "clientId";
    //Client Secret key of the application.
    $clientSecret = "ClientSecret";
    //OAuth Url.
    $authUrl      = "https://datamarket.accesscontrol.windows.net/v2/OAuth2-13/";
    //Application Scope Url
    $scopeUrl     = "http://api.microsofttranslator.com";
    //Application grant type
    $grantType    = "client_credentials";

    //Create the AccessTokenAuthentication object.
    $authObj      = new AccessTokenAuthentication();
    //Get the Access token.
    $accessToken  = $authObj->getTokens($grantType, $scopeUrl, $clientID, $clientSecret, $authUrl);
    //Create the authorization Header string.
    $authHeader = "Authorization: Bearer ". $accessToken;

    //Set the params.
    $sentence      = "rephrasing is a hard problem for the computer.";
    $language      = "en-us";
    $category        = "general";
    $maxParaphrase = '6';
    
    $params = "sentence=".urlencode($sentence)."&language=$language&category=$category&maxParaphrases=$maxParaphrase";
    
    //HTTP paraphrase URL.
    $paraphraseUrl = "http://api.microsofttranslator.com/v3/json/paraphrase?$params";
    
    //Create the Translator Object.
    $translatorObj = new HTTPTranslator();
    
    //Call the curlRequest.
    echo $curlResponse = $translatorObj->curlRequest($paraphraseUrl, $authHeader);
    
} catch (Exception $e) {
    echo "Exception: " . $e->getMessage() . PHP_EOL;
}

/*
 * Create and execute the HTTP CURL request.
 *
 * @param string $url        HTTP Url.
 * @param string $authHeader Authorization Header string.
 * @param string $postData   Data to post.
 *
 * @return string.
 *
 */
function curlRequest($url, $authHeader) {
    //Initialize the Curl Session.
    $ch = curl_init();
    //Set the Curl url.
    curl_setopt ($ch, CURLOPT_URL, $url);
    //Set the HTTP HEADER Fields.
    curl_setopt ($ch, CURLOPT_HTTPHEADER, array($authHeader,"Content-Type: text/xml"));
    //CURLOPT_RETURNTRANSFER- TRUE to return the transfer as a string of the return value of curl_exec().
    curl_setopt ($ch, CURLOPT_RETURNTRANSFER, TRUE);
    //CURLOPT_SSL_VERIFYPEER- Set FALSE to stop cURL from verifying the peer's certificate.
    curl_setopt ($ch, CURLOPT_SSL_VERIFYPEER, False);
    //Execute the  cURL session.
    $curlResponse = curl_exec($ch);
    //Get the Error Code returned by Curl.
    $curlErrno = curl_errno($ch);
    if ($curlErrno) {
        $curlError = curl_error($ch);
        throw new Exception($curlError);
    }
    //Close a cURL session.
    curl_close($ch);
    return $curlResponse;
}

 

 

 

 

Translator Language Codes

Microsoft Translator continually adds to the list of supported languages for the Translation and Text to Speech methods.

You can always obtain the current list of available language codes using the GetLanguagesForTranslate() or GetLanguagesForSpeak() methods.

These methods will return a language code. You can translate that language code into a friendly name in any of the supported languages using the GetLanguageNames() method. Below are the friendly names in English - you can retrieve them in any of the listed languages using GetLanguageNames().

 

 

Here is the list (as of January 2012):

 

Language Code

English Name

ar Arabic
bg Bulgarian
ca Catalan
zh-CHS Chinese (Simplified)
zh-CHT Chinese (Traditional)
cs Czech
da Danish
nl Dutch
en English
et Estonian
fa Persian (Farsi)
fi Finnish
fr French
de German
el Greek
ht Haitian Creole
he Hebrew
hi Hindi
hu Hungarian
id Indonesian
it Italian
ja Japanese
ko Korean
lv Latvian
lt Lithuanian
ms Malay
mww Hmong Daw
no Norwegian
pl Polish
pt Portuguese
ro Romanian
ru Russian
sk Slovak
sl Slovenian
es Spanish
sv Swedish
th Thai
tr Turkish
uk Ukrainian
ur Urdu
vi Vietnamese

 

目录
相关文章
|
移动开发 小程序 前端开发
小程序接入微信支付V3接口开发教程
最近做了一个小程序对接微信支付的需求,查看微信支付文档,还是感觉有点凌乱,所以做一个统一整理,供大家参考。
1111 0
小程序接入微信支付V3接口开发教程
|
移动开发 前端开发 测试技术
微信公众号菜单管理接口开发
自定义菜单通过后台管理设置到数据库表,数据配置好后,通过微信接口推送菜单数据到微信平台。
1089 0
微信公众号菜单管理接口开发
|
网络安全 开发工具
微信小程序之使用本地接口开发
  本文主要讲解如何使用本地接口进行开发,很多人都会遇到这个问题,特别是小程序上线后。 一、解决思路   在小程序开发工具设置网络代理,然后再通过Charles设置代理,将https域名转为本地接口进行访问。
2648 0
|
JSON 前端开发 小程序
微信小程序入门05-用户登录注册接口开发
微信小程序入门05-用户登录注册接口开发
|
SpringCloudAlibaba 小程序 前端开发
微信小程序实战 (微信小程序后端Java接口开发demo)
微信小程序实战 (微信小程序后端Java接口开发demo)
514 0
|
JavaScript Java 定位技术
微信开发之JSSDK接口开发(Java)
    前不久做了一个微信公众号项目,有用到JSSDK接口,今晚正好有空,就开始动手整理。如何获得accesstoken和jsapitiket以及生成签名就不细说了,大家看接口文档,有不明白的地方可以给我留言。
1845 0
微信现金红包高级红包接口开发亲测
原文:微信现金红包高级红包接口开发亲测 微信现金红包高级红包接口开发时遇到了不少问题,网上搜索发现 微信现金红包高级红包接口开发注意事项 这篇文章问题总结得很完整,里面给的demo是VS高版本写的,运行过程中还是有些参数问题对于首次调试来说有点难度,还有微信支付现金红包接口 的接口介绍,下面的几个问...
1156 0
|
PHP
微信公众平台消息接口开发-封装weixin.class.php
原文:微信公众平台消息接口开发-封装weixin.class.php 一、封装weixin.class.php 由于微信公众平台的通信使用的是特定格式的XML数据,每次接受和回复都要去做一大堆的数据处理。
894 0