SPIRAL APIを使ってPHPと連携したお話

  • このエントリーをはてなブックマークに追加

SPIRALとは?

SPIRAL(以下SPIRAL)とはスパイラル株式会社(旧株式会社パイプドビッツ)が提供するサービスで

SPIRAL ver.1は、柔軟なデータベースを中心として、Webアプリ構築に必要なさまざまな機能が備わったプラットフォームです。システム環境構築は不要で、データ入出力、認証、メール配信、API連携などの部品を組み合わせたWebアプリ開発(ローコード開発)が行えます。


といったサービスのようです。

要はデータを一元管理するのでそれを元に会員専用サイトや問い合わせフォームやメール配信を行いますよという感じですね

弊社が手掛けるようなWebサイト上のシステム構築をサーバーを用意することなく行え、しかもデータ管理も行ってくれるので、サーバー担当者を専任できないが情報セキュリティにはしっかり対応したいという場合には選択肢に入るのではないでしょうか

しかも導入実績がすごい
SPIRALⓇ 導入実績


大手企業ばかりですね。

特に会員登録を行いメールマガジンなど一括配信する場合には最適かもしれません

 

スパイラル APIってどういうの?

ただここでSPIRALの説明をしても仕方が無いので、SPIRALの機能であるデータベースをAPIから操作するようにしたいと思います。

スパイラルAPI 概要図
これのメリットとしては以下の点となります
  1. データベースをwebサーバーではなく外部サーバー(SPIRAL)にすることでデータの安全性をSPIRAL基準で確保できる
  2. 登録したデータのメールアドレス宛にメール配信やメールマガジンなど一括送信を行う事ができる
  3. REST形式で行うため一般的なREST APIと同じ要領で行う事が可能
1.に関してはデータベースの使えないサーバー(最近は無いとは思いますが)や情報セキュリティ的にwebサーバーに個人情報を保有できない場合には検討する価値があると思います。

2.はどちらかというと副次的な話になりますが、SPIRALにはメール配信機能があるため、SPIRAL上でメール配信を行えるのが大きいですね。
(一括メール配信を自前で作ろうとすると割と大変で、短時間に大量のメールを送信するとなると、メールサーバーへの負荷やエラーメールの処理を行う必要があり、サーバー側で連携を取るなどの処理を行わないと、キャリアブロックが発生してメール遅延発生の原因となるので…)

3.はありがたいですね。これであればJavaScriptからでもPHPや他の言語からも可能です。

ただもちろんデメリットもあり…
  1. データ件数に比例して料金が変わる段階制料金プランである
  2. APIのアクセス数に制限がある
  3. 1度のAPIのアクセスで取得できる最大件数が1,000件である
といったものがあります

1.に関してはテーブルを何個か作っても合計件数で判断されるため、あらかじめサービスの想定件数を考えておく必要があります。

2.は1分あたり何回までという制限がありますが、オプションでその回数を増やすことが可能ですので、こちらもあらかじめ想定回数を決めておきましょう。

3.に関しては固定となり増やすことができないのでプログラム上でフォローする必要があります。

その他にもデータベース同士にリレーションを貼る制限がある(同じ組み合わせは1種類のみ)などがありますので、そこを考慮したテーブル設計が必要となります。

PHPで実装する方法

基本的にサポートサイトにサンプルがあるので、それを見て貰うのが確実ですが、こんな感じで実装しましたという忘備録的な感じでまとめておきます


APIのリクエスト先を取得

スパイラルAPIのリクエスト先を取得するlocator APIに接続します。

 

$api_token は SPIRALの設定画面から取得してください。
ここではハードコピーしてますが、設定ファイルに定数で定義するのがいいのかなと思います。

こんな感じで取得できます。

SELECTについて

ここら辺はめんどくさかったので関数化して都度呼び出ししてます

こんな感じで関数にしてます。使い方としては

こんな感じで それぞれを指定します。
なお、絞り込み条件ですが、複数絞り込みたい場合は以下のようになります。

そうすると$usersの中に表示したい項目が連想配列で入ってくるのであとはPHPで加工してください。

INSERT について

INSERTも関数にしてます。

戻り値は投稿されたIDとなるようにしてます。
使い方は

こんな感じです。登録するデータを$ins_dataに連想配列で入れます。

UPDATEについて

基本的にSELECTとINSERTを足したような感じですね

処理の中で特筆すべきなのが

これですね。
絞り込み条件をつけないと一括更新されてしまい登録データが全部書き換わるので、念のために仕込んでます。
使い方は

簡単ですね、本当にINSERTとSELECTを足したような処理ですね

DELETEについて

ここにも絞り込み条件が無い場合エラーにするようにしています。

使い方は

簡単に消えちゃいますね。
一度消すと二度と復旧できないのは変わらないので、実行するときはかなりの緊張感が出てきますね。

WordPress内で使用できる?

できます!

WordPressはPHPなので、上記の記述も問題なく動きます。

ただ、WordPressのデータベースをSPIRAL DBにすることはできません。
あくまでWordPressの枠組みの中に入れることが可能という位置づけです。

WordPressの管理画面で使いたいなら独自プラグインを作成し、その中でSPIRAL APIを使いましょう。

困ったことは?

基本的な機能については困らないですが、やはりAPIの使用回数制限が厳しくなるときがあります。
特にバッチ処理などで一括で何百件も変更したい場合は、APIの使用制限に引っかかるリスクがあるため、処理をするときにあらかじめその部分を加味した処理を行う必要があります。
(処理件数をカウントして危なそうになったら処理を止めて次の機会に回すなど)

あとはテスト環境というかテスト用テーブルを自分で作る必要があり、そこで使用するデータ件数もカウントされてしまうという事ですね

ですので、一度本番データをテストテーブルに移してというのはやりづらいかなと思ったりします。

とはいえ、登録したデータをSPIRALで活用できるのは大きく、安心のパイプド…スパイラル社による管理となるため、使い方を間違えなければ便利だと思います。

外部参考サイト

スパイラルAPIの使い方
https://support.smp.ne.jp/api-manuals/spiral_api/

 

執筆者:松本[ エンジニア ]

関連記事

プログラミング

SharePoint リストに書式の変更からJSONで記述してCSSを適用する方法

SharePointのモダンUIで、リストの書式設定をJSON形式で入力することにより、カスタムCSSを適用してみましょう。 今回は、このようなリンクリストを作成します。 WEBパーツで似たような形を作れますが、細かいCSSが調整できません。リストのWEBパーツとして複数のページで使用すると、一度の修正で全てのページに修正が適用されます。サイト内で共通で使いたいパーツをこのように使用すると便利です。 目次1 前提条件1.1 使用できるHTMLタグやCSSが限られている2 リス […]

プログラミング

SharePointで作成したサイトを別環境にコピーする方法(サイトテンプレートの使い方)

SharePointのモダンUIで作成したサイトは、サイトテンプレートを生成すると簡単に複製できます。 テスト環境で作成したサイトを本番環境に移行する場合などに使えるかもしれません。 目次1 前提条件1.1 権限の確認2 手順3 1.カスタムスクリプトを許可する4 2.サイトをテンプレートとして保存5 3.新規サイトを作成6 4.テンプレートを適用 前提条件 SharePoint Online モダンUI チームサイト サイトテンプレートがサポートされているのはチームサイトの […]

プログラミング

SharePoint Framework(SPFx)で作ったカスタムアプリをサイトに追加・公開する方法

SharePointのモダンUI向けに作成したSharePoint Framework(以降SPFx)の独自アプリを、SharePoint Onlineに展開するには、パッケージ化してサイトに追加する必要があります。 今回はサイトに適用するまでの方法と手順をまとめました。 目次1 前提条件1.1 権限の確認2 1.パッケージ化3 2.App Catalogからアプリをアップロード、動作を確認3.1 App Catalogにアクセスし、.sppkgファイルをアップロード3.2 […]

株式会社8bit (エイトビット)

東京都目黒区でWebサイト制作、Webシステム開発などを行っております。
コーポレートサイトやWebサービスの企画・提案を得意としており、自社での経験を元にアイデアをカタチにするお手伝いをさせていただいております。

Web制作に関するご相談はお気軽にどうぞ

弊社に制作をご依頼いただく際の費用感をご確認いただける、
見積りシミュレーションをご用意いたしました。