開発API
「あわせて読みたい」では、実験的にあわせて読みたいサイトリストを RSS および JSONP で配信しています。
RSS 配信
RSS については、あわせて読みたいで表示される各サイトのページ下部に
アイコンで表示されています。
- 配信形式
RSS 2.0 (UTF-8) - URL
http://api.awasete.com/showrss.phtml?u=(対象となるブログトップページのURL)
※パラメータのURL は URLエンコードする必要があります。 - サンプルリクエスト
http://api.awasete.com/showrss.phtml?u=http%3A%2F%2Fblog.myrss.jp%2F
- 制約事項
現在特に制限はありませんが、大量のアクセスおよび If-Modified-Since に対応していないリクエストについては制限をかけることがあります。
JSONP 配信
JSONP により あわせて読みたいサイトの一覧を受信することができます。これにより、「あわせて読みたい」を自由な形でご利用いただくことができるようになります。
- 配信形式
JSONP (UTF-8) - フォーマット
awasete_yomitai([
{
title: "(ブログタイトル)",
url: "(ブログURL)",
favicon: "(Favicon URL)",
navigation: "(ナビゲーションつきブログURL)",
more: "(あわせて読みたいへのリンク)"
},...
]);
※最大10件出力されます。 - URL
http://api.awasete.com/showjson.phtml?u=(対象となるブログトップページのURL)
※パラメータのURL は URLエンコードする必要があります。 - サンプルリクエスト
http://api.awasete.com/showjson.phtml?u=http%3A%2F%2Fblog.myrss.jp%2F
- サンプルスクリプト
<script type="text/javascript">
<!--
function awasete_yomitai(v){
for (var i = 0; i < v.length; i++){
var d = v[i];
document.write(d.title + '<br>');
}
}
//-->
</script>
<script type="text/javascript" src="http://api.awasete.com/showjson.phtml?u=http%3A%2F%2Fblog.myrss.jp%2F" charset="utf-8"></script>
※上記サンプルでは、簡略化のためセキュリティ上の問題を考慮していません。 - 制約事項
現在特に制限はありませんが、大量のアクセスおよび If-Modified-Since に対応していないリクエストについては制限をかけることがあります。
また、JSONP の提供は実験的なものであり、サーバー負荷状況により配信が若干遅延することがあります。
body の閉じタグ直前に記述する/遅延呼び出しをかけるなど、ページ全体の表示に影響が無いようご配慮ください。
※APIを利用して「あわせて読みたい」を表示する場合、画像パーツを貼り付ける必要はありませんが、まずトップページからブログを登録する必要があります。ご注意ください。
デザインバリエーション/パーツバリエーション/API利用サービスのご紹介
「あわせて読みたい」の API を利用したブログパーツとしてのバリエーションやサービスなどがあればこちらにてご紹介させていただきます(いただかない場合もありますのでご了承ください…)。
- FC2 公開プラグイン: 「あわせて読みたい」のjavascript版 ブログパーツを公開(申請中)しました。 // Salad Days Rider
- ありがとうございました!
どのようなものでも歓迎いたします。
免責
本APIの利用については、「あわせて読みたい」のご利用規約に従うものとします。
また、本仕様については予告なく変更されることがあります。

