Daniel Berkompas - Rate Limiting a Phoenix API
Christian, husband, father, and programmer. I write code for the web. In my spare time, I’ve been working on a little Phoenix project that involves a JSON API. Developers frequently neglect rate limiting when they build an API, assuming they are even aware that it is a best practice. It’s true that in many cases rate limiting isn’t worth the effort, but when it comes to authentication, it definite
GitHub - neomerx/json-api: Framework agnostic JSON API (jsonapi.org) implementation
A good API is one of most effective ways to improve the experience for your clients. Standardized approaches for data formats and communication protocols increase productivity and make integration between applications smooth. This framework agnostic package implements JSON API specification version v1.1 and helps focusing on core application functionality rather than on protocol implementation. It
swaggerでAPIドキュメントを書いたらめっちゃはかどった話 - kaz29
Swaggerは、REST APIの仕様とそれに関連するツール群の総称です。REST APIの仕様を定義したJSONファイル(Swagger Spec)を軸に以下のようなツールから構成されています。 Swagger UI - Swagger Spec から動的にAPIドキュメントを生成するツール Swagger Editor - Swagger Specのエディタ Swagger Codegen - Swagger Specからクライアントのコードを生成するツール 最近では、Open API InitiativeがAPIの記述のためにSwaggerを採用して話題になりました。 www.publickey1.jp APIドキュメントのメンテは結構面倒 一般的にAPIの仕様書は、古くはExcel/Wordなどを使ったり、最近ではWikiやMarkdown形式で記述したりなどプロジェクトによって
The Hypertext Application Language
HAL - Hypertext Application Language A lean hypermedia type Author: Mike Kelly <[email protected]> Created: 2011-06-13 Updated: 2013-09-18 (Updated) Summary HAL is a simple format that gives a consistent and easy way to hyperlink between resources in your API. Adopting HAL will make your API explorable, and its documentation easily discoverable from within the API itself. In short, it will make yo
JSON API — A specification for building APIs in JSON
If you’ve ever argued with your team about the way your JSON responses should be formatted, JSON:API can help you stop the bikeshedding and focus on what matters: your application. By following shared conventions, you can increase productivity, take advantage of generalized tooling and best practices. Clients built around JSON:API are able to take advantage of its features around efficiently cachi
RESTful APIの記述標準化を目指す「Open API Initiative」をマイクロソフト、Google、IBMらが立ち上げ。Swaggerをベースに
RESTful APIの記述標準化を目指す「Open API Initiative」をマイクロソフト、Google、IBMらが立ち上げ。Swaggerをベースに 10年以上前、XMLの登場に続いてXMLベースのAPIを記述する標準フォーマット「WSDL」が提唱されました。 WSDLにはAPIの仕様がマシンリーダブルな形で記述されており、APIを呼び出すためのプロトコルやデータフォーマットをあらかじめ知ることができます。WSDLを利用することで、APIをコールするためのコードを自動生成することが可能でした。 しかしXMLベースのAPIは期待されたほど普及せず、現在ではよりシンプルなRESTful APIが事実上の標準となっています。 そしてRESTful APIのためのWSDLとも言うべき、RESTful APIのインターフェイスを記述するための標準フォーマットを推進する団体「Open AP
APIドキュメントを支える技術 - Qiita
最近のウェブ開発では各機能ごとをAPIでつなぎ込む時代になっています。 そのため、各チームが開発をしていく上で、 他のチームにAPIの仕様を伝える方法をきちんとまとめておく必要が出てきています。 そんな中でAPIドキュメントにどのような役割が求められていて どのような選択肢があるか、一旦自分の把握している知識をまとめています。 (ここで書いているAPIは、httpでアクセスしたら、JSON形式でレスポンスを返すウェブサービスのAPIを指しています) APIドキュメントを用意する上で、すぐにぶつかる壁 APIドキュメントを用意する場合に、何も考えずにExcelやwikiにまとめると、早い段階で メンテナンスのコスト の問題にぶつかります。 『APIドキュメントを書く時間がない』 『本当にドキュメント通りの結果が返ってくるか、試してみないとわからない』 『実際に返ってくるAPIとレスポンスが違
Google Sheets API, Turn Google Spreadsheet Into API – Sheetsu
[ACTION REQUIRED] We are moving to SheetDB - Google Sheet REST API We regret to inform you that Sheetsu will be discontinuing its services effective April 1, 2024. As part of this transition, we are excited to announce our collaboration with SheetDB (https://sheetdb.io). We strongly urge all our valued users to migrate their data to SheetDB at their earliest convenience. SheetDB offers a robust an
WebAPIドキュメント作成サービス「Apiary」を使ってWebアプリ開発を高速化しよう | 株式会社LIG(リグ)｜DX支援・システム開発・Web制作
はじめまして。去年の9月にLIGにジョインしましたフロントエンドエンジニアの稲葉です。最近のマイブームは日本酒です。（お酒は弱いです） 去年の11月くらいからずっとAngularJSにどっぷり浸かっていますが、BackboneJSの方が好きです。 今回は、APIのモックサーバを提供するサービス「Apiary」をご紹介したいと思います。実際の案件でRESTfulなアプリケーションを開発する際、とても便利でした！ Apiaryとは http://apiary.io/ 「API Blueprint」と呼ばれるMarkdownを拡張した言語で、APIのインターフェース仕様書を記述すると、その記述をもとにドキュメントの生成とAPIのモックサーバを同時に用意をしてくれるWebサービスです。 モックサーバを準備する まずはとにかく実際に使ってみましょう！ ログイン まずはログインをします。 IDとPas
Google Calendar上の予定の変更を監視する - Qiita
Google Calendar API: Push Notifications 特定のCalendar上に予定が追加されたり、予定に変更（削除も含む）があった際に通知を受け取ることができる機能 Push Notification があります。 https://developers.google.com/google-apps/calendar/v3/push このAPIを使うと、予定に変更があった際にWebhookにて変更があったことを知ることができますが、Webhookにて通知された内容だけでは「何かの予定に対して変更があった」ことしかわからないので、実用には不十分です。このPush Notification（Events: watch）に加えて、Events: listという予定の一覧を取得するAPIを組み合わせます。Events: list APIにはsyncTokenというパラメー
Swiftを使ってモダンなWeb APIクライアントを爆速で開発する - Qiita
iOS Advent Calendarの13日目を担当します@giginetです。 APIクライアントを作りたいなあと言う気概になったので、APIクライアントをライブラリ化するまでの方法をご紹介します。 なお、この記事は執筆時点の最新の環境で検証しています。 Xcode7.2 Swift 2.1.1 Carthage 0.11.0 今回使用するAPI 今回は、APIクライアントが見当たらなかったので、WakaTimeという、エディタからデータを送り、自分のプログラミングについてのデータを集積してくれるサービスのAPIクライアントを作って、自分の1週間のコーディングを管理できるようにしてみました。 完全自動で、自分のプログラミング「作業ログ」を収集して可視化する「WakaTime」が素晴らしい件！ | シェアしたくなる最新のWebサービス・ITニュース情報をチェック！ APPGIGA!!（ア
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
SwaggerHub | API Design & Documentation Tool
api-guidelines/Guidelines.md at master · microsoft/api-guidelines
http://www.fredguest.com/2015/03/06/building-a-stateless-rails-api-with-react-and-twitter-oauth/
GitHub - nilportugues/laravel5-jsonapi: Laravel 5 JSON API Transformer Package
Hypermedia Factors
Building better API Docs with React and Swagger
http://www.mikestowe.com/2014/07/raml-vs-swagger-vs-api-blueprint.php
Review: Vimeo API Update Provides Robust Access to Service's Ecosystem | ProgrammableWeb
Libraries