【PKOBO-CS-API】カーセンサーAPI連携　PHP検索付き中古車情報システム（有料製品）

【ご注意】カーセンサーに登録されていることが大前提となります。

カーセンサーのAPIを利用し、カーセンサーに登録されている自社の登録データのみを自社のサイトなどに簡単に表示できます。自前でCMSなどのシステムを導入する必要もなく、またデータはカーセンサー側と連動しているためカーセンサー側を更新するだけで自社サイト上のデータも自動で更新されますので設置後のメンテは一切不要です。コスト、及び更新の手間を省き、また更新の間違い、漏れも防ぐことが出来ます。

さらにレスポンシブ化も行なっていますのでスマホでも最適な形で表示されます。
設置もいたって簡単で数分～10分程度もあれば完了するでしょう。（設置難度を極限まで下げましたのでFTPでのアップを行なったことがあれば誰でも可能だと思います）

主な機能と特徴

1. 設置が非常に容易です。設定ファイルでAPIキー（新規に取得して下さい）、座標、及び店舗名を設定してファイルをアップするだけでOKです。指定した店舗のデータのみがすべて表示されます。また表示部分はhtmlとCSSで構成されてますので、デザイン変更はもちろん、既存ページへの埋め込みも可能です。また不要な機能や項目などは非表示や削除が可能です。
2. レスポンシブ化も行なっていますので、スマホで表示すればスマホ用に最適化されたページで表示されます。ただし、必要最低限のCSSとしておりますので微調整などが必要な場合はご自身で行なって下さい。
   もちろん独自にレスポンシブ化されたり、スマホ用のサイトで表示することも可能です。
3. メーカー（トヨタ、ホンダ、日産など）、または車種（アルファード、クラウンなど）及び年式と車両本体価格で検索が出来ます。また各種並び替えも可能です。メーカー及び車種はデータが1件以上あるもののみが表示され、データ数の順でソートされます。詳細はサンプルデモをご参照下さい。
4. ページング（ページャー）により登録台数が何件あっても最適にページングが行われるため、すべてのデータが漏れなく表示されます。1ページ内の表示数は設定ファイルで設定可能です。
5. PHP5.2以上でのみ動作可能です。
6. その他設定ファイル（config.php）にて様々なオプション設定が可能です。
7. カーセンサーが提供するAPIを利用する関係上、どうしても機能的に制約があります。
   たとえば登録日の取得ができないためNewマークの表示や新着順に並べることが不可能、色または走行距離での検索が出来ない、詳細ページはカーセンサー側にリンクする必要があるなど。このあたりは実際にサンプルデモにてご確認いただければと思います。基本的には問題ないレベルと考えています。
   

サンプルデモ

実際に御社の店舗データの表示を試せますので、まずは問題なくデータを取得、表示ができるか、また登録数などが一致しているかなどお試しいただければと思います。
スマホの場合はレスポンシブ化されたページで表示されます。

サンプルデモ

事前の動作チェック用ファイルのダウンロード

一般的なレンタルサーバーであればまず問題ないと思いますが、事前に設置するサーバーで正常に動作するかどうかを簡易的にチェックできます。（PHPのバージョンチェックも付いています）ただし、これで問題がなくても100％の動作保証は出来ませんのでご了承下さい。

以下のファイルをダウンロードし、解凍の上で「cs-api-check.php」をエディタソフトで開き、APIキーを設定して下さい。（APIキーも同時に取得しておいて下さい。[APIキー取得はこちら]　無料ですし即発行されます。）
その上でサーバーにアップいただき、そのファイルにアクセスして下さい。
サーバー検証結果：OK
と出ればOKです。NGの場合には申し訳ございませんが、そのサーバーでは動作いたしません。

動作検証用ファイル

料金とお支払い方法

【PKOBO-CS-API】カーセンサーAPI連携　PHP検索付き中古車情報システム（有料製品）

プログラムの販売は終了しました

設置方法

ファイルの文字コードはUTF-8です。必ず対応したエディタで開いてください。
メモ帳（UTF-8非対応）は使用禁止です。ファイルが壊れます。エディタソフトは特になんでもかまいませんが、TeraPad（無料）やDreamWeaver等で開いてください。必ずUTF-8のBOM無し（UTF-8N）で保存して下さい（いずれもデフォルトではBOM無しで保存されます）。
BOMについて詳しく知りたい方はこちら
※PHPではスラッシュ2回「//」の後からその行の末尾までがコメント扱いとなります。「#」、「/**/」もです。

1.ファイル構成の確認

ダウンロードしたzipファイルを解凍するとcarlist/フォルダがあります。
赤字のファイルが変更する必要のあるファイルです。その他は基本的には触らずOKですが、自由に改変下さい。

index.php	表示用のメインページです。最低限APIキー、座標、及び店舗名を設定ファイルに設定していれば表示されます。基本的にはこのページをそのままご使用下さい。 html部分は自由に変更いただけますので、既存のサイトデザインを反映することも出来ます。またはまるっとコピペすることで任意のページの任意の箇所に埋め込むことも可能です。 直接埋め込む場合には設置先のページの拡張子が.phpでかつ文字コードはUTF-8である必要があります。iframeで表示してももちろんOKです。 見た目等はCSSで自由に調整して下さい。もちろんDreamWeaverでも編集可能です。 iframeタグ例 <iframe src="carlist/" width="900" height="2000" frameborder="0" scrolling="auto"></iframe>
┗ include/	設定ファイルを含むシステム用のファイル群です。設定ファイル以外は触らないで下さい。
┗ include/config.php	設定ファイルです。こちらでAPIキーの設定を含む初期設定、及び各種オプション設定が可能です。
┗ css/	デフォルトのCSSです。CSSはシステムとは無関係のため自由に変更下さい。
┗ js/	Javascriptファイルです。そっとしておきましょう。
┗ lightbox/	画像拡大表示用のlightboxです。もちろん他のライブラリを導入されてもOKです。

2. APIキーの取得と必須設定、オプション設定を設定する

まずは以下ページにてAPIキーを新規で取得して下さい。もちろん無料ですし、即時発行されます。
https://webservice.recruit.co.jp/index.html
※左上にある「新規登録」から申し込んで下さい。キーは即時にメールで送られてきます。

include/config.phpをエディタソフトで開き、「必須設定」の箇所をコメントの説明を参考に設定してください。
※APIキー、座標、及び店舗名の3つを設定するだけです。
※メモ帳で開くことは禁止です。ファイルが壊れます。

3. FTPでアップ

フォルダごとすべてのファイルをアップ下さい。
これで設置は完了です。
実際にブラウザでアップしたcarlist/にアクセスしてみて下さい。正常に表示されていればOKです。
http:www.あなたのサイトのドメインとパスなど/carlist/

念のため御社のカーセンサー側の登録台数と一致しているかもご確認下さい。

6. ページの調整

設置するページやその他必要に応じてスタイルシート、HTML等で見た目の調整を行ってください。じゆ～です！
ソースコードをご覧いただけば分かるかと思いますが、細かくclassを振っておりますので基本的にはどのようなスタイルも可能です。

充分な検証は行っておりますが、未知の不具合等が無いとも限りませんので、気になる点などがあれば遠慮なくお問い合わせ下さい。また使用感などもいただけますとものすごくありがたいです！

設定できるオプション

APIキー、座標、及び店舗名の3つを設定するだけでとりあえずの設定は完了ですが、必要に応じて以下のオプションが設定可能です。設定ファイル内にもコメントにて説明書きがあります。

識別用のキーワード
カーセンサー側の「説明文」に入れ込んだ識別用のキーワードを指定できます。基本的には設定する必要はありませんが、ここを設定することで取得データが御社のデータのみに絞り込めるためページの表示速度向上が見込めます。表示が遅い場合やもっと早くしたい場合などにご利用下さい。
例　「○○自動車」のようなワードをカーセンサー側の全登録データの「説明文」に記述しておくということです。

検索用の「年式」の下限と上限の設定
デフォルトではそれぞれ30年に設定されています。

本体価格で検索用の下限と上限の設定
デフォルトでは5万円～1000万円となっています。

並び順（デフォルトの並び順）
以下から選択できます。デフォルトは「0」です。
0:ブランド順（メーカー順）
1:価格安い順
2:価格高い順
3:車種名順
4:年式古い順
5:年式新しい順
6:走行距離少ない順

並び順変更の箇所（プルダウン）に表示する並び順
デフォルトでは上記のすべてが設定されています。たとえば「車種名順」が不要であれば削除可です。

並び順をID番号順とする（新着順）
【重要】ID番号が必ずしも実際の新着順とは限らないため、意図したものとならない可能性があります。（カーセンサー側の仕様に依存）これはカーセンサー側の仕様であるため、これ以上どうしようもありませんのでご了承下さい。（日付順でのデータ取得ができないためです）それでも比較的新着順に近い形にはなるとは思います。
実際に試してみて意図したようにならない場合は「0」としてOFFにして下さい

サブ画像の表示（2枚目以降の画像です）のON、OFF（デフォルトはON）
画像を表示するとどうしても表示速度は遅くなる傾向にあります。OFFにすることで表示速度の向上が見込めます。

ページングの設定（1ページあたり何件表示するかを設定可能です）※デフォルトは20件
ページング（ページャー）は全自動で生成されますのでどんなにデータが多くても適切に処理され、すべてのデータが表示されます。あなたは1ページあたりの表示件数を設定するだけです。

よくある質問

準備中です

不具合、バグ等について

十分な検証は行っておりますが、リリース直後は未知の不具合が無いとも限りません。もし不具合などを発見されましたら遠慮なくお問い合わせ下さい。不具合かどうか分からないようなものでも遠慮なくお問い合わせ下さい。
お問い合わせはこちら

運用上の注意点

カーセンサーAPIのサービスは遅くとも24時間以内に最新データに更新する旨の記載があります。実際の更新間隔は不明のためカーセンサー側を更新してもすぐには反映されない可能性がありますのでご了承下さい。

またカーセンサー側に依存しているシステムのため、カーセンサー側がAPIサービスの提供を終了した場合、データの取得を行うことができなくなりますので、結果的にこちらのシステムも使用不能となります。予めこの点はご了承下さい。APIサービスの提供を終了した場合でも返金等には応じ兼ねますのでご了承下さい。（数日などごく短期を除く）

ただある日突然終了ということは基本的にはないと思います。またある程度の猶予はあるでしょうし、事前にAPIサービスの新規登録を受付けないなどの処置を取るでしょうからAPIサービスの新規登録が出来た時点ではしばらくは問題ないと考えてOKだと思います。またこのAPIサービスは10年ほど前に開始されていますので、今後いきなり終了する可能性は低いとも考えています。（その影響が大きいでしょうから）

動作確認済PHPバージョン

PHP4.3.9～PHP8.1

動作確認済レンタルサーバー

• エックスサーバー [PR]
  ※個人的にはここが好きで、もうずっとここです。このサーバーで困ることはまずないでしょう。
• ロリポップ！ [PR]
  ※ただしここはWAF機能がONの場合、CMSプログラムで問題が発生する可能性が高いです。詳細はこちら
  またサーバーがブラックリストに登録されてしまいメール系のプログラムで受信できない大問題も多々確認されています。詳細はこちら 　ただコスパ的には有りだと思います。
• カゴヤのレンタルサーバー [PR]
  ここは高機能、高スペック、良心的な価格でありながら風俗系のサイトがOKという非常に貴重なサーバーです。個人的には風俗系のサイトであればこのサーバー以外の選択肢はないと思ってます。
• さくらのレンタルサーバ [PR]

その他一般的なレンタルサーバーであれば問題なく動作するはずですが、
すべての環境（サーバー）での動作を保証するものではありませんのでご了承下さい。

サポートについて

HTMLやCSSなどをある程度理解されている方を対象としています。
カスタマイズ方法などのサポートは行っておりませんのでご了承ください。
修正方法などに関するサポートは有料にて承ります。

有料サポートはこちら

設置の際の不明点や気になった点、不具合等があれば遠慮なくなんでもご連絡ください。

お問い合わせはこちら

カスタマイズ、設置代行について

カスタマイズ（改造等）方法などのサポートは行っておりません。
カスタマイズや仕様変更、設置代行などは2,000円～の有料にて承ります。
APIを利用している性質上、対応できないカスタマイズもありますが、まずはお気軽にご相談下さい。

ご依頼・お見積もりはこちらです

ご利用規約

・無料版プログラムはフリーウェアです。ただし、著作権は放棄するものではありません。
・プログラムの著作権表示リンク（ページ下部にある当サイトへのリンク）を無断で削除することはできません。
（一律2,000円+消費税の削除依頼をいただいた場合を除く）
・プログラムの再配布、再販売は禁止です。
　※ただしクライアントへの納品などでシステム費用、設置費用として請求されるのは問題ありません。
・プログラムによって何らかの不利益、損害が生じても一切の責任を負いません。
　あらかじめご了承の上ご使用ください。
　もし何らかのトラブルがあった場合には、ご相談いただければ解決策が見つかるかもしれません。
　（クライアントへの原因の説明など）
・プログラムは全ての環境（サーバー）での動作を保証するものではありません。
・改変等は自由ですが、自己責任でお願いします。
・有料版をご購入いただいた場合、初期不良を除き、ご使用後の返金には応じ兼ねます。
・有料版（著作権リンク削除含む）は1サイト（同一ドメイン）内であれば複製の上で複数利用可能です。
　2サイト目以降は都度サイトより購入申込みが必要になります。
　※サブドメインはその性質上、別サイト（別ドメイン）とみなします。 　

　ダウンロードいただいた時点で利用規約に同意したものとみなされます。

更新履歴

PHPメールフォーム（無料版）

• 【MailForm01】メールフォーム　フリー
• 【MultiLangForm01】多言語対応版

PHPメールフォーム（有料版）

• 【MailForm02】アドレス2重チェック付き
• 【MailForm03】CSV保存付き
• 【MailForm04】禁止ワード、禁止IP
• 【MailForm05】ファイル添付機能
• 【MailForm07】送信先振り分け機能付き
• 【MailFormFull】全機能搭載版
• フォームのカスタマイズ
• フォーム作成依頼

新着情報・更新履歴CMS（無料版）

• 【PKOBO-News01】

投票・アンケートシステム（無料版）

• 【PKOBO-vote01】投票・アンケート

テロップCMS（無料版）

• 【Telop01】テロップ・ニュースティッカー

写真ギャラリーCMS（無料版）

• 【Gallery01】写真ギャラリー

営業日カレンダーCMS（無料版）

• 【Calendar01】シンプル版
• 【Calendar02】テキスト入力付き

営業日カレンダーCMS（有料版）

• 【Calendar03】プルダウン・テキスト入力付き

カレンダー予約フォーム（無料版）

• 【CalendarForm01】カレンダー予約フォーム

カレンダー予約フォーム（有料版）

• 【CalendarForm02】カレンダー予約フォーム
  　　CSV保存機能付き

リンク集ページCMS（無料版）

• 【Link01】リンク集ページCMS

アクセスカウンター（無料版）

• テキスト版、画像版

ダウンロードカウンター（無料版）

• ダウンロードカウンター01

その他

• 【PKOBO-CS-API】API連携中古車情報システム

役立つかも？なもの

• 指定URLページのファイルサイズ計測
• パチスロ当たりシミュレーター

豆知識や役立ち事など

• PHPが使えるレンタルサーバー比較
• htaccessでBasic認証
• Yahooジオプラスへの導入について（重要）
• Yahooジオプラスでログイン不具合について
• UTF-8使用時の注意点（BOMあり、なし）
• JSでコピー＆ペースト禁止処理
• サーバーのphp.iniによるアップロードファイルの最大容量の確認と容量制限の変更
• 迷惑メール、スパムメール対策
• フォームの基礎知識
• 送信ボタン連打による多重送信防止
• 迷惑メール扱いされる場合の対策

PHPについて

• PHP基礎の基礎
• PHPマニュアル（外部サイト）
• XAMPP（外部サイト）

各種情報

• よくある質問
• 有料サポート
• カスタマイズ・設置代行・お問い合わせ
• 事業概要
• ご利用規約
• 運営者プロフィール
• プライバシーポリシー
• 特定商取引法に基づく表示
• リンクについて
• Ken'sWEB（外部ブログ）