RESTful API設計におけるトランザクション - Qiita
概要 RESTful APIでリソースのロックが長期間になりそうなときRDBMSのACIDなトランザクションを複数組み合わせてロック期間を短くしつつトランザクション処理っぽくする方法。 RDBMSの１つのトランザクションだけで処理するのは難しい 例として、商品を購入し外部のクレジットカード決済APIで決済する処理を考えてみる。 テーブルはorders(id), order_details(id, order_id, product_id), products(id, price, stock), payments(id, order_id, card, amount)があるとして、/ordersに商品IDの配列とクレジットカード情報をPOSTすればその商品を購入できるとしよう。
Swagger-PHP v3.x
Generate interactive OpenAPI documentation for your RESTful API using doctrine annotations. Get Started → OpenAPI specification Compatible with the OpenAPI Specification version 3. formerly known as Swagger. Use @Annotations Write the documentation inside the php source files which helps to keep the documentation in sync.
API Documentation & Design Tools for Teams | Swagger
NEWAPI Documentation Portal API Development for Everyone Simplify API development for users, teams, and enterprises with the Swagger open source and professional toolset. Find out how Swagger can help you design and document your APIs at scale. Explore Swagger Tools SmartBear Named a Visionary by Gartner® in the 2023 Magic Quadrant™ for API Management Learn More
GitHub - slatedocs/slate: Beautiful static documentation for your API
Clean, intuitive design — With Slate, the description of your API is on the left side of your documentation, and all the code examples are on the right side. Inspired by Stripe's and PayPal's API docs. Slate is responsive, so it looks great on tablets, phones, and even in print. Everything on a single page — Gone are the days when your users had to search through a million pages to find what they
分かりやすいドキュメントを。APIドキュメントジェネレータまとめ | NTT Communications Developer Portal
APIはシステム用の機能になります。分かりやすいビジュアル化された画面がある訳ではありませんので、使い方のドキュメントが必須です。 今回はAPIドキュメントを生成するためのライブラリを紹介します。 Swagger | The World's Most Popular Framework for APIs. SwaggerはRESTfulなAPIドキュメント生成に対応したツールとなっています。ドキュメントはYAMLを使って記述します。また、Web上でテスト実行できる仕組みが便利です。 RAML - RESTful API modeling language RAMLとはRESTful API Modeling Languageの略で、YAMLフォーマットを使ってRESTfulなAPIドキュメントを作成します。専用のエディタもあり、プレビューで確認しながらドキュメントが書けます。 apiDoc
海外でWebサービスを展開するときに知っておきたい税金のこと - Qiita
この記事は2016年時点の調査内容を記載したもので、既に制度が変更されています。 変更の詳細はこちらをご参照ください。 European Commission公式 : The VAT e-commerce package and the MOSS / What changes on 1 January 2019? 解説記事: EU VAT threshold on digital goods changes in January 2019 グッドパッチでサーバーサイドエンジニアをしている、やっはーです。 今日はProttで実装した、Webサービスでの海外課税に対して、１エンジニアとしてどう越境していったかという話です。 「グッドパッチなのにデザインの話じゃないんかーい」というツッコミが聞こえてきますが、「ハートを揺さぶるデザインで世界を前進させる！」をビジョンに掲げているグッドパッチなので
HTTPステータスコードを適切に選ぶためのフローチャート : 難しく考えるのをやめよう | POSTD
HTTPステータスコードを返すというのはとても単純なことです。ページがレンダリングできた？よし、それなら 200 を返しましょう。ページが存在しない？それなら 404 です。他のページにユーザをリダイレクトしたい？ 302 、あるいは 301 かもしれません。 I like to imagine that HTTP status codes are like CB 10 codes. "Breaker breaker, this is White Chocolate Thunder. We've got a 200 OK here." — Aaron Patterson (@tenderlove) 2015, 10月 7 訳：HTTPのステータスコードのことは、市民ラジオの10コードみたいなものだと考えるのが好きです。「ブレーカー、ブレーカー、こちらホワイト・チョコレート・サンダー。200
オンライン決済サービスの比較（2016年9月） - Qiita
BtoBサービスを開発するにあたって、オンライン決済機能を実装する必要があり、どのような決済サービスがあるのか調べてみました。間違いがあったら教えて頂けると助かります。 比較対象のサービス 自社Webサービスに簡単にクレジットカード決済機能を組み込むことのできるサービスを比較対象として取り上げます。 問い合せしないと価格を教えないサービスは除外しています。 SPIKE Stripe Yahoo!ウォレットFastPay PayPal PAY.JP Komoju Omise 比較の軸 料金（初期費用・決済手数料・その他維持費等） 対応しているカードの種類 継続課金対応（毎月決まった金額を課金するような決済方法に対応しているか） API（APIによる取引が可能か） 比較表 (略称) Visa: V, Master Card: M, JCB: J, AMEX: A, Diners: D, Dis
HTTP APIの詳細なエラー情報をレスポンスに持たせるための仕様
今日では HTTP(s) で API が公開されることは当たり前の時代ですが、エラーをアプリケーションにどう伝えるかは、個々の API の設計に依存していました。特に、HTTP ステータスコードは有限であり、元々持っている意味があるので、自由に使うことはできません。API はそのドメインごとにもっと複雑で細かなエラー情報があるはずで、それらはレスポンスボディに載せてアプリケーションに伝えることになりますが、その書式に規定は今までありませんでした。 HTTP API にて、アプリケーションにエラー情報を伝達するための（レスポンスボディに載せられる）標準的な形式が、RFC7807 Problem Details for HTTP APIs で定められています。適用例としては、以下のようになります。 HTTP/1.1 403 Forbidden Content-Type: application
Go で API サーバーを開発してきて1年が過ぎました | カメリオ開発者ブログ
白ヤギの開発者の森本です。 白ヤギでは Go 言語でニュース記事のキュレーションをする カメリオ API というサービスを開発しています。約1年2ヶ月前、Go を使って開発し始めたときに当時調べた内容を整理して以下の記事を書きました。 Go言語で API サーバーを開発する 1年以上に渡り開発を継続してきて変わったこと、変わってないことなどをざっくばらんにまとめてみます。たまたま過去の記事のはてブコメントを見返していて 以下のコメント を見つけました。 最近 golang 導入事例増えて来たけど、導入後一年くらいのメンテナンスフェーズな事例について聞いてみたい。継続的デリバリーみたいなの。まだ早いのかな？ まだまだメンテナンスフェーズにはなっていなくて現在も活発に開発中ですが、継続的デリバリーについて白ヤギでは特別なことをしてなく、ansible を使ってデプロイしているのみです。Go 1
jqコマンドが実は高性能すぎてビビッた話
GWが始まりましたが、鎌倉のGWは観光客多すぎて逆に住民はげんなりして外に出なくなる感じです。とはいえ路地まで観光客が攻め込んでくることは少ないので、路地を散歩する分には天気がよくていい感じですね。ちなみに人力車のおにーさんはそういう味のある路地を知り尽くしているので人力車で移動するのはそこそこオススメです(ぼくは乗ったことないけど「こんなところも通るんだ!」ってところで見かけたりします)。 さて、jqというコマンドをご存じでしょうか。 jq jq is a lightweight and flexible command-line JSON processor. と書いてあるとおり、コマンドラインでJSONを扱うことができるコマンドです。で、今まさに仕事で巨大JSONと戦うことが多く、このコマンドが大活躍です。 とはいえ、ぼくの使い方としては「巨大JSONをキレイに整形して表示する」とい
Markdown で記述した API ドキュメントからお手軽にドキュメントサーバーとモックサーバーを生成する - Gulp で作る Web フロントエンド開発環境 #7 | PSYENCE:MEDIA
Markdown で記述した API ドキュメントからお手軽にドキュメントサーバーとモックサーバーを生成する - Gulp で作る Web フロントエンド開発環境 #7 wakamsha 2015.08.31 941 15687462236 2018年2月23日更新 : サンプルコードを ECMASCript 2015+ で書き直し、npm-scriptsでの例を加筆しました。 SPA 開発によるサーバーサイドとフロントエンドの完全分業化 Single Page Application ( 以下、SPA ) は従来のサーバーサイドレンダリングを基とした Web アプリケーションと異なり、iOS アプリや Android アプリと同じように Web API を通じてサーバーにリクエストを送り、JSON 形式などで返ってきたデータをもとにダイナミックにレンダリングすることで Web ページ全体
APIを探そう。国内外のインデックスサービスまとめ | NTT Communications Developer Portal
APIとAPIを組み合わせてマッシュアップサービスを作ろうと思った場合、まず自分が欲しいデータを提供しているAPIを探す必要があります。今回はそんなAPIのディレクトリを提供しているサービスをまとめて紹介します。 PublicAPIs 執筆時点で5,330のAPIから検索ができるAPIインデックスサービスになっています。名前やAPI名などを入れることで、新しいAPIの登録申請もできるようになっています。 PublicAPIs | Directory of public APIs for web and mobile API For That 検索、ソーシャル、ファイナンスなど約20のカテゴリに分かれて登録されています。約300種類くらいのAPIが登録されています。 API For That | An API Directory Zapier IFTTTのビジネス版と言った雰囲気のサービスに
2014 年も終わりなので Google Analytics API を使ってアクセス数の多いページを取得してみた - しばやん雑記
ちょっと前に緑色のフリーコンテンツ氏が、以下のようなツイートをしていたのを思い出しました。 はてなブログ、年間アクセスランキング出す機能とかさくっとつけてくれないかな— 俺、だるやなぎになります。 (@daruyanagi) 2014, 12月 25 もう営業日終わっただろうし、無いんだったら作ればいいのよ！という感じ。Google Analytics API を使えば出来るんじゃないの？と思ったので、適当なキーワードで検索すると既に先人がちらほらと。 Google Analytics API v3をPHPから利用する方法 | karakaram-blog ほぼそのまんまで使える！と思ったので、C# に落とし込みました。 var certificate = new X509Certificate2(Convert.FromBase64String(ServiceAccountCertifi
Extensible Web の夜明けと開発者が得た可能性の話 - Block Rockin’ Codes
Web based on Standards Web は誰のものでもありません。 だれかプロダクトオーナーがいてその人が意思決定するとか、そういうのとは真逆の成り立ちをしています。 標準的な仕様を決めて、その仕様に則って Web の世界は成り立っている。 政府が作るサイトも、 Twitter も、学生が作ったブログも、全部同じルールで作られている。だから繋がる。 これって結構凄いことだと、自分は思っています。 Standarization このルールの決め方にもルールがあって、ちょっと敷居は高いかもしれないけど、誰でも自由に参加して、自由に意見を述べることができる場があります。 標準化団体ってやつですね。 なんか一部の人たちが勝手にやっているように思えるかもしれないけど、それは選挙に行かない人の理論と同じです。 あなたが仕様について意見を持ってて、それが妥当であるならば、その発言は仕様を根
Wikipedia APIで遊んでみた - Cherenkovの暗中模索にっき
APIドキュメント http://en.wikipedia.org/w/api.php http://www.mediawiki.org/wiki/API/ja 使い方 http://ja.wikipedia.org/w/api.php?action=query&list=random&rnnamespace=0&rnlimit=10 にアクセスすればXML。 http://ja.wikipedia.org/w/api.php?action=query&list=random&rnnamespace=0&rnlimit=10&format=jsonfm formatにjsonfmを指定すれば読みやすいpretty JSONで表示してくれる。デバッグ時によい。 http://ja.wikipedia.org/w/api.php?action=query&list=random&rnnames
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
マイクロにしすぎた結果がこれだよ！
TechCrunch | Startup and Technology News
Coding a Dynamic IMDb Webapp using My Movie API [Article] | Treehouse Blog
Does IMDB provide an API?
