取用指南
透事API使用方式說明

文件基本說明

介紹

藍星球文字探勘API以REST API的方式提供服務。
在正式開始使用前,您需要先註冊藍星球文字探勘API帳號。完成後,您將可以透過註冊之帳號密碼取得API Token,API將透過該Token進行存取。

一組帳號專用Token,可擁有各API每月2000筆之免費運算額度(額度於每月1日重新計算),每筆資料字數不超過2000字,如字數超過限制,將傳回錯誤訊息,您可選擇重新選擇文本,或由API自動刪除超出文字後,進行運算。
如您有大量取用需求,歡迎洽詢藍星球資訊團隊,來信contact@blueplanet.com.tw,或撥打客服專線02-8978-7198,由專人為您規劃服務。

取得Token

您可以透過開啟命令提示字元介面(Command Line Interface)並輸入以下指令(不包含 $ ),將YOUR_ACCOUNT及YOUR_PASSWORD替換為您註冊透事的帳號和密碼

$ curl -u YOUR_ACCOUNT:YOUR_PASSWORD "https://thoughts.blueplanet.com.tw/api/login"

透過以上的指令您可以取回下方的資訊
1. expired_time: 此token的逾期時間(※每個Token的有效期限為30分鐘,若逾期請重新索取)
2. permission: 您可以存取的API列表
3. token: 您的API存取Token
4. user_name: 您的名字

{
    "expired_time": "2017-12-11 17:38:56",
    "permission": [
        "classification",
        "abstract",
        "extraction",
        "sentiment",
        "recommandation",
        "clustering"
    ],
    "token": YOUR_API_TOKEN,
    "user_name": "藍星球"
}

開始使用透事API

您可以將下方指令中的 YOUR_API_TOKEN 替換成上述步驟中所取得的Token,並送出請求

$ curl -X POST \
            -H "Content-Type: application/json" \
            -H "Accept: application/json" \
            -H "Authorization: Bearer YOUR_API_TOKEN" \
            -d '[{"id": "9527","text":"安倍晉三在國會表示,希望日本央行繼續實施大膽的寬鬆貨幣政策"}]' \
            "https://thoughts.blueplanet.com.tw/api/v1/extraction"
                    

下方為API回傳的結果

[
            {
                'id': '9527',
                'brand': { },
                'person': {'安倍晉三': 1},
                'group': { },
                'keyword': {'日本央行': 1, '寬鬆貨幣政策': 1},
                'location': { },
                'content_type': 'text',
                'process_time': 0.12986,
                'text': '安倍晉三在國會表示,希望日本央行繼續實施大膽的寬鬆貨幣政策'
            }
]