shorturl
- 印刷する
- PDF
shorturl
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。
概要
入力されたURLを me2.do
の形式で短いURLに変換するREST APIです。
リクエスト
- POST FORM方式
curl -i -X POST \
-H "Content-Type: application/x-www-form-urlencoded; charset=UTF-8" \
-H "X-NCP-APIGW-API-KEY-ID: {アプリケーションを登録する時に発行されたclient id 値}" \
-H "X-NCP-APIGW-API-KEY: {アプリケーションを登録する時に発行されたclient secret 値}" \
-d "url={短縮しようとする原本URL}" \
"https://naveropenapi.apigw.ntruss.com/util/v1/shorturl"
- POST JSON方式
curl -i -X POST \
-H "X-NCP-APIGW-API-KEY-ID:{アプリケーションを登録する時に発行されたclient id 値}" \
-H "X-NCP-APIGW-API-KEY:{アプリケーションを登録する時に発行されたclient secret 値}" \
-H "Content-Type:application/json" \
-d '{"url": "{短縮しようとする原本URL}"}' \
'https://naveropenapi.apigw.ntruss.com/util/v1/shorturl'
- GET方式
curl -i -X GET \
-H "X-NCP-APIGW-API-KEY-ID:{アプリケーションを登録する時に発行されたclient id 値}" \
-H "X-NCP-APIGW-API-KEY:{アプリケーションを登録する時に発行されたclient secret 値}" \
'https://naveropenapi.apigw.ntruss.com/util/v1/shorturl?url={短縮しようとする原本URL}'
リクエストパラメータ
GET方式で呼び出す場合、パラメータで送信できます。
リクエスト変数名 | タイプ | 必須 | 基本値 | 説明 |
---|---|---|---|---|
url | string | Y | - | 短縮しようとする原本URL |
リクエストヘッダ
ヘッダ名 | 説明 |
---|---|
X-NCP-APIGW-API-KEY-ID | アプリケーションを登録する時に発行されたClient IDX-NCP-APIGW-API-KEY-ID:{Client ID} |
X-NCP-APIGW-API-KEY | アプリケーションを登録する時に発行されたClient SecretX-NCP-APIGW-API-KEY:{Client Secret} |
リクエストボディ
POST方式で呼び出す場合、FORM、JSON方式で送信できます。
リクエスト変数名 | タイプ | 必須 | 基本値 | 説明 |
---|---|---|---|---|
url | string | Y | - | 短縮しようとする原本URL |
レスポンス
レスポンスボディ
フィールド | タイプ | 説明 |
---|---|---|
hash | string | 短縮URL Hash情報 |
url | string | 短縮されたURL |
orgUrl | string | 原本URL |
例示
リクエスト例示
curl "https://naveropenapi.apigw.ntruss.com/util/v1/shorturl" \
-d "url=http://d2.naver.com/helloworld/4874130" \
-H "Content-Type: application/x-www-form-urlencoded; charset=UTF-8" \
-H "X-NCP-APIGW-API-KEY-ID: {アプリケーションを登録する時に発行されたclient id 値}" \
-H "X-NCP-APIGW-API-KEY: {アプリケーションを登録する時に発行されたclient secret 値}" -v
レスポンス例示
{
"message":"ok",
"result": {
"hash":"GyvykVAu",
"url":"https://me2.do/GyvykVAu",
"orgUrl":"http://d2.naver.com/helloworld/4874130"
}
,"code":"200"
}
API例題
// nShortURL API例題
import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
public class APIExamURL {
public static void main(String[] args) {
String clientId = "YOUR_CLIENT_ID";//アプリケーションclient id値";
String clientSecret = "YOUR_CLIENT_SECRET";//アプリケーションclient secret 値";
try {
String text = "https://developers.naver.com/notice";
String apiURL = "https://naveropenapi.apigw.ntruss.com/util/v1/shorturl";
URL url = new URL(apiURL);
HttpURLConnection con = (HttpURLConnection)url.openConnection();
con.setRequestMethod("POST");
con.setRequestProperty("Content-Type", "application/json");
con.setRequestProperty("X-NCP-APIGW-API-KEY-ID", clientId);
con.setRequestProperty("X-NCP-APIGW-API-KEY", clientSecret);
// post request
JSONObject json = new JSONObject();
json.put("url", text);
String postParams = json.toString();
DataOutputStream wr = new DataOutputStream(con.getOutputStream());
wr.writeBytes(postParams);
wr.flush();
wr.close();
int responseCode = con.getResponseCode();
BufferedReader br;
if(responseCode==200) { // 正常呼び出し
br = new BufferedReader(new InputStreamReader(con.getInputStream()));
} else { // エラー発生
br = new BufferedReader(new InputStreamReader(con.getErrorStream()));
}
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = br.readLine()) != null) {
response.append(inputLine);
}
br.close();
System.out.println(response.toString());
} catch (Exception e) {
System.out.println(e);
}
}
}
// Naver短縮URL Open API例題
<?php
$client_id = "YOUR_CLIENT_ID";
$client_secret = "YOUR_CLIENT_SECRET";
$encText = urlencode("https://developers.naver.com/docs/utils/shortenurl");
$postvars = "url=".$encText;
$url = "https://naveropenapi.apigw.ntruss.com/util/v1/shorturl";
$is_post = true;
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, $is_post);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch,CURLOPT_POSTFIELDS, $postvars);
$headers = array();
$headers[] = "X-NCP-APIGW-API-KEY-ID: ".$client_id;
$headers[] = "X-NCP-APIGW-API-KEY: ".$client_secret;
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$response = curl_exec ($ch);
$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
echo "status_code:".$status_code."<br />";
curl_close ($ch);
if($status_code == 200) {
echo $response;
} else {
echo "Error内容:".$response;
}
?>
// nShortURL API例題
var express = require('express');
var app = express();
var client_id = 'YOUR_CLIENT_ID';
var client_secret = 'YOUR_CLIENT_SECRET';
var query = encodeURI('https://developers.naver.com/docs/utils/shortenurl');
app.post('/url', function(req, res) {
var api_url = 'https://naveropenapi.apigw.ntruss.com/util/v1/shorturl';
var request = require('request');
var options = {
url: api_url,
form: { url: query },
headers: { 'X-NCP-APIGW-API-KEY-ID': client_id, 'X-NCP-APIGW-API-KEY': client_secret },
};
request.get(options, function(error, response, body) {
if (!error && response.statusCode == 200) {
res.writeHead(200, { 'Content-Type': 'text/json;charset=utf-8' });
res.end(body);
} else {
res.status(response.statusCode).end();
console.log('error = ' + response.statusCode);
}
});
});
app.listen(3000, function() {
console.log('http://127.0.0.1:3000/url app listening on port 3000!');
});
# Naver短縮URL Open API例題
import os
import sys
import urllib.request
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"
encText = urllib.parse.quote("https://developers.naver.com/docs/utils/shortenurl")
data = "url=" + encText
url = "https://naveropenapi.apigw.ntruss.com/util/v1/shorturl"
request = urllib.request.Request(url)
request.add_header("X-NCP-APIGW-API-KEY-ID",client_id)
request.add_header("X-NCP-APIGW-API-KEY",client_secret)
response = urllib.request.urlopen(request, data=data.encode("utf-8"))
rescode = response.getcode()
if(rescode==200):
response_body = response.read()
print(response_body.decode('utf-8'))
else:
print("Error Code:" + rescode)
using System;
using System.Net;
using System.Text;
using System.IO;
namespace NaverAPI_Guide
{
public class APIExamURL
{
static void Main(string[] args)
{
string url = "https://naveropenapi.apigw.ntruss.com/util/v1/shorturl";
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
request.Headers.Add("X-NCP-APIGW-API-KEY-ID", "YOUR_CLIENT_ID"); // Client ID
request.Headers.Add("X-NCP-APIGW-API-KEY", "YOUR_CLIENT_SECRET"); // Client Secret
request.Method = "POST";
string query = "https://developers.naver.com/docs/utils/shortenurl"; // 短縮するURL対象
byte[] byteDataParams = Encoding.UTF8.GetBytes("url=" + query);
request.ContentType = "application/x-www-form-urlencoded";
request.ContentLength = byteDataParams.Length;
Stream st = request.GetRequestStream();
st.Write(byteDataParams, 0, byteDataParams.Length);
st.Close();
HttpWebResponse response = (HttpWebResponse)request.GetResponse();
Stream stream = response.GetResponseStream();
StreamReader reader = new StreamReader(stream, Encoding.UTF8);
string text = reader.ReadToEnd();
stream.Close();
response.Close();
reader.Close();
Console.WriteLine(text);
}
}
}
エラーコード
HTTPコード | エラーコード | エラーメッセージ | 対処方案 |
---|---|---|---|
403 | 1403 | Invalid URL(リクエストURLエラー) | |
403 | 2403 | Forbidden URL(APIの使用権限エラー) | |
403 | 3403 | Unavailable URL(存在していないか、安全でないURL) | |
500 | 1500 | Internal server error(内部サーバエラー) | お客様問い合わせまでお問い合わせください。 |
この記事は役に立ちましたか?