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 ID `X-NCP-APIGW-API-KEY-ID:{Client ID}`
X-NCP-APIGW-API-KEY	アプリケーションを登録する時に発行されたClient Secret `X-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(内部サーバエラー)	お客様問い合わせまでお問い合わせください。

この記事は役に立ちましたか?

What's Next

nShortURL 예제

概要
リクエスト
レスポンス
例示
エラーコード

タグ

nShortURL