各種APIの利用について

商用・非商用に関わらず、どなたでもご利用頂けます。
1クライアントあたりのリクエストの上限は設けておりませんが、利用回数が多い場合は、キャッシュをするなどの対処をお願いいたします。
また、一日10万リクエスト以上の利用については事前にご連絡をお願いいたします。ご連絡がない場合、アクセス制限などの方法で、利用を停止させて頂く場合がございます。
本APIは事前の告知なく、仕様変更ならびに公開停止を行う場合がございます。

登録確認API

指定したURLがｉディレクトリに登録されているか確認できるAPIです。
GETリクエストによりAPIから結果を取得できます。
※後に示す例について、可読性を考慮し適宜改行を挿入している部分があります。

簡単な例

http://www.idirectory.jp/apis/site_exists.api?uri=http%3A%2F%2Fwww.idirectory.jp%2F

上記の例のように、http://www.idirectory.jp/apis/site_exists.api にパラメータ"uri"を付与しGETリクエストを行うことで、下記のような結果を取得することができます。

<?xml version="1.0" encoding="utf-8"?>
<link
  id="929"
  name="ｉディレクトリ"
  url="http://www.idirectory.jp/"
  summary="ｉディレクトリでは、サイト登録のお申込み時に関連するページを最大で6つまでお申込み頂けますので、登録したいページと合わせて最大で7ページを一挙にご登録頂けます。"
  created="2009-07-22 13:39:52"
/>

phpを使用しているサービスでの手軽な利用方法

同様にパラメータ"mode=php"を付与しGETリクエストを行うことで、phpのserialize文字列で結果を取得することができます。

http://www.idirectory.jp/apis/site_exists.api?uri=http%3A%2F%2Fwww.idirectory.jp%2F&mode=php

結果は以下のようになります。

a:1:{
  s:4:"Link";a:5:{
    s:2:"id";s:3:"929";
    s:4:"name";s:19:"ｉディレクトリ";
    s:3:"url";s:25:"http://www.idirectory.jp/";
    s:7:"summary";s:218:"ｉディレクトリでは、サイト登録のお申込み時に関連するページを最大で6つまでお申込み頂けますので、登録したいページと合わせて最大で7ページを一挙にご登録頂けます。";
    s:7:"created";s:19:"2009-07-22 13:39:52";
  }
}

各取得項目の説明

ｉディレクトリ

id

登録ごとのユニークなid。http://www.idirectory.jp/links/view/{id}とすることで、登録サイトの詳細ページへのURIとなります。

name

サイト名

url

サイトのURL

summary

サイトの概要

created

登録された日時

注意事項など

本APIで登録確認を行えるURLは、サブページを除くURLとなっています。
この登録情報の場合、http://www.idirectory.jp/ は検索対象となりますが、http://www.idirectory.jp/pages/service などのサブページは検索対象となりません。

埋め込みコードについて

特定のｉコラムの記事をお申し込みサイトや関連サイト、ブログなどにそのまま掲載できる機能です。サイトコンテンツの充実にお役立ていただけます。

ご利用方法

1.　記事上部にある［埋込コード］ボタンをクリックします。
2.　その下に表示されるソースをコピーします。
3.　コピーしたソースをウェブサイトやブログのHTMLに貼り付けます。

クレジットについて

本APIのご利用に際して、クレジット表記は必要ございませんが、本APIを使用しているページには、以下のバナーを任意でご利用頂けます。バナーをご利用の場合は、このページへリンクをお願いいたします。