Download the PHP package amane/blog-sdk without Composer
On this page you can find all versions of the php package amane/blog-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package blog-sdk
AMANE Blog Distribution — PHP SDK
公式 PHP SDK for the AMANE Blog Distribution API.
AMANE が AI で自動生成した SEO 記事を、顧客の corporate サイトや blog サイトに pull して公開できます。
必要要件
- PHP 7.3 以上 (= 7.3 / 7.4 / 8.0 / 8.1 / 8.2 / 8.3 / 8.4 で動作)
- Composer
- Guzzle 7.x (= 自動でインストールされます)
インストール
使い方
クライアント初期化
baseUrl について:
https://service.amane.appでもhttps://service.amane.app/api/v1でもどちらでも動きます。SDK 内部で/api/v1/プレフィックスを自動付与するため、 末尾スラッシュの有無も気にする必要はありません。
配信可能な記事一覧を取得
記事詳細を取得 (= 呼ぶと delivered ステータスに自動遷移)
公開報告 (= 顧客サイトで公開した時に呼ぶ)
公開先 URL の更新 (= 公開後に URL が変わった場合)
非公開化 (= 取り下げ)
効果計測結果取得 (= 公開後 14 日以降)
キーワード管理
トピック提案
使用量取得
エラーハンドリング
API トークンの発行
- AMANE 管理画面 (https://service.amane.app) にログイン
- Site 詳細 → 「📝 ブログ配信」タブ
- 「🔑 API トークン管理」→ 新規発行 (= 表示は 1 度だけ、コピーしておく)
トークンの形式: amb_ プレフィックス + 48 桁の hex
.env 設定の注意点
.env を Windows エディタで編集すると CRLF (\r\n) で保存される場合があり、
AMANE_API_TOKEN の値に \r が混入して Authorization ヘッダが壊れ、nginx が 400 を返すことがあります。
対策:
.envを保存する前にエディタの改行コードを LF に設定- アプリケーション側で
trim($_ENV['AMANE_API_TOKEN'])を入れて防御
開発・テスト
テストは PHPUnit で 3 つのスイート (Unit / Integration / E2E) に分かれています。
Docker で実行 (= ローカルに PHP 不要・推奨)
pcov と composer を同梱したテスト用イメージを docker-compose.yml / docker/Dockerfile で用意しています。
vendor/ はホストにマウントされるため composer install は基本 1 回でよく、
カバレッジ HTML は build/coverage/index.html に出力されます。
ローカルに PHP がある場合
各スイートの内容:
- Unit: 純粋ロジック (
normalizeBaseUrl/ 認証ヘッダ構築) ・例外・リソースの遅延生成 - Integration:
HttpClientの各 verb とエラーマッピング、各 Resource のメソッドを Guzzle モック越しに検証 - E2E:
AmaneClientから Guzzle まで貫通する一連の操作 (記事取得 → 公開報告 → 更新 → 取り下げ 等)
GitHub Actions (.github/workflows/ci.yml) で、main への push /
pull request 時に PHP 7.3〜8.4 のマトリクスで全スイートを実行し、カバレッジ 90% 以上を強制します。
E2E の実 API スモークテスト:
AMANE_E2E_BASE_URLとAMANE_E2E_TOKENを環境変数に 設定すると、実 API への読み取り専用スモークテストも実行されます (未設定時はスキップ)。
関連リンク
変更履歴
v0.1.2 (2026-06-25)
- fix:
HttpClient::normalizeBaseUrl()を追加。baseUrl に/api/v1プレフィックスが無くても SDK 内部で自動付与するように改善。これまでhttps://service.amane.appを渡すと SaaS の SPA index.html を 200 で受けて空レスポンスになる事故が起きていたため。後方互換あり (= 既に/api/v1を含めて渡しているコードはそのまま動く) - docs: README のサンプルを PHP 7.3 互換構文に統一。実在しないメソッド名 (
fetch/publication()->report()等) を正しいメソッド名に修正
v0.1.1 (2026-06-23)
- feat: PHP 7.3 互換性を追加 (旧 8.1 要求から拡大)
v0.1.0 (2026-06-22)
- feat: initial release
ライセンス
MIT License — see LICENSE
Copyright (c) 2026 Transonic Software Corporation
