1. TOP
  2. アルバム
  3. アルバムについて

アルバムデータをJSONで配信

有料版のアルバムは、APIを使って写真情報をJSON形式で取得することで、あなたのサイトに自由なレイアウトとデザインで埋め込むことが出来ます。
JSONはPHP、Ruby、Perl、Python、JavaScriptなど、さまざまなプログラム言語で簡単に扱うことが出来ます。

アルバムを生成するには、写真のアドレスにurlプロパティを追加する必要があります。
urlプロパティの値は、写真が掲載されているページのアドレスです。
<img src="https://photo.kinois.net/cdn.jpg?org=https://your.site.com/img/photo.jpg
&url=https://your.site.com/index.html" />

ALBUM ID

ユーザー登録し、決済することにより、ALBUM IDが発行されます。発行されたALBUM IDをAPIのパスに含めることで、対象となる写真のアルバムおよびラベル情報を取得することが出来ます。
以下ではALBUM IDを$album_idと表記します。

写真API

https://photo.kinois.net/api/album/photos/$album_id.json?domain=$domain&label=$label_key domain=$domainが指定されない場合は、アルバム内の全ての写真の一覧を返します。指定された場合はそのドメインに掲載されている写真の一覧を返します。
label=$label_keyが指定されない場合は、アルバム内の全ての写真の一覧を返します。指定された場合はそのラベルが付けられた写真の一覧を返します。

$album_idの取得は有料です。料金欄を御覧ください。

JSON

{"album":
    {"name":"$name",
        "photos":[
            {"src":"$src",
             "url":"$url",
             "created":"$created"},
            {"src":"$src2",
             "url":"$url2",
             "created":"$created2"},
             ...
         ]
     }
}
        

コールバック関数

写真APIにコールバック関数を追加した場合、JSONデータを引数として、コールバック関数を呼び出します。

https://photo.kinois.net/api/album/photos/$album_id.json?domain=$domain&label=$label_key&callback=foo

タグAPI

https://photo.kinois.net/api/album/tags/$album_id.json?domain=$domain

JSON

{"album":
    {"name":$name,
        "tags":[
            {
                "key":"$label_key":
                "label":{"en":$en, "ja":$ja}
            }
        ]
    }
}
        
domain=$domainが指定されない場合は、アルバム内の全ての写真のラベルの一覧を返します。指定された場合はそのドメインに掲載されている写真のラベルの一覧を返します。

コールバック関数

タグAPIにコールバック関数を追加した場合、JSONデータを引数として、コールバック関数を呼び出します。

https://photo.kinois.net/api/album/tags/$album_id.json?callback=foo

サンプルサイト

アルバムAPIおよび写真検索APIを使用したサンプルサイトを用意しましたので、ご参考にしてください。

料金

500円/月

既に写真検索APIを利用されている場合は、追加費用は発生しません。

お支払い方法

クレジットカード決済のみとなります。利用できるクレジットカードは、Visa、Master、Amexです。複数月の利用は定期支払となります。

用意するもの

ドメインは写真のアドレスのものとなります。https://example.com/images/photo.jpgの場合はexample.comとなります。
写真がexample.comとexample2.comにある場合は、両方登録してください。ドメイン数の上限はありません。後から追加、削除することも出来ます。

注意

キノイスフォトでは、暴力的な写真やわいせつな写真はアルバム登録できません。また、アルバム登録するには写真が掲載されているサイトのURLを写真のアドレスに含む必要があります。
サイトが暴力的、またはわいせつと判断される場合、アルバムを作成することは出来ません。
有料版アルバムを作成する前に、必ず無料版アルバムを作成できることを確認してください。

写真とタグが追加されるタイミング

写真はアドレスを書き換えた後、その写真が掲載されているページが表示されたタイミングでアルバムに追加されます。
英語のタグは写真がアルバムに追加されたタイミングで登録されますが、日本語のタグの登録には1日から2日ほどかかります。

ログインまたはサインアップ

有料版アルバムを作成または管理するにはGoogleアカウントでログインします。
アルバムの閲覧にログインは必要ありません。

ログイン