[B! api] nntsuguのブックマーク

nntsugu id:nntsugu

apiに関するnntsuguのブックマーク (19)

https://fintechjapan.org/resources/Documents/%E5%88%86%E7%A7%91%E4%BC%9A%E8%B3%87%E6%96%99/API%E3%82%BB%E3%82%AD%E3%83%A5%E3%83%AA%E3%83%86%E3%82%A3%E5%88%86%E7%A7%91%E4%BC%9A/%E7%AC%AC14%E5%9B%9E_API_%E3%82%BB%E3%82%AD%E3%83%A5%E3%83%AA%E3%83%86%E3%82%A3
nntsugu 2018/08/25
APIセキュリティ分科会

あとで読む

api

FinTech
リンク
Zalando RESTful API とイベントスキーマのガイドライン
License: CC-BY-SA 3.0 © Zalando SE 2020 & CC-BY-SA 3.0 © kawasima 2020 Zalandoのソフトウェアアーキテクチャは、疎結合なマイクロサービスを中心としており、それらはJSONペイロードをもつRESTful API群によって、機能が提供されています。小さなエンジニアのチームは、自分たちでAWSアカウントにこれらのマイクロサービスをデプロイしたり運用したりしています。私たちのAPIは、その多くが私たちのシステムが何をするのかを完全に表現しており、それゆえに貴重なビジネス資産となっています。 Zalandoがとあるオンラインショップから価値あるファッションプラットフォームへと変貌をとげるために、私たちは新しいオープンプラットフォーム戦略の展開をはじめました。なので、高品質で長持ちするAPIの設計は、私たちにとっ
nntsugu 2018/07/09
programming

api

教材
リンク
API 設計ガイド | Cloud APIs | Google Cloud
フィードバックを送信 API 設計ガイドコレクションでコンテンツを整理必要に応じて、コンテンツの保存と分類を行います。変更履歴はじめにこれは、ネットワーク API の一般的な設計ガイドです。2014 年以来 Google 内部で使用され、Cloud API やその他の Google API を設計するときに Google が従うガイドです。この設計ガイドは、外部のデベロッパーへの情報提供と、互いの連携作業の効率化のためにここで共有されています。 Cloud Endpoints のデベロッパーには、このガイドは、gRPC API を設計するときに特に役立つことがあり、そのような場合にはこれらの設計原則を使用することを強くおすすめします。ただし、このガイドの使用は必須ではありません。Cloud Endpoints と gRPC はガイドに従わなくても使用できます。このガイドは、gR
nntsugu 2018/04/09
API設計ガイド

あとで読む

google

API

教材
リンク
すごーい！APIドキュメントを更新するだけでAPIが自動テストできちゃう！たのしー！ - 資料一覧 - connpass
終了 2017/05/08（月） 20:00〜すごーい！APIドキュメントを更新するだけでAPIが自動テストできちゃう！たのしー！テストケースになったAPIドキュメントが繰り広げる大冒険ビズリーチ_D3 東京都渋谷区渋谷2-15-1 渋谷クロスタワー 12F
nntsugu 2017/05/25
あとで読む

testing

api

document
リンク
Facebook API アップデートと付き合う話 | feedforce Engineers' blog
最近買ったボードゲームはスカイアイランドとテレストレーションとストーンエイジです、こんにちは。フィードフォースボドゲ部の kano-e です。仕事では Facebook のドキュメントをいっぱい読んでいる今日この頃、Rails エンジニアです。さて、先日 7/13 (日本時間だと 7/14 ですね) に Facebook API v2.7 がリリースされました。弊社のソーシャル PLUS や Feedmatic では Facebook API を利用していますので、さっそく影響範囲の確認や対応リリースが行われました。 (ソーシャル PLUS の対応リリースは 7/14 中でした) Facebook API は三ヶ月を目安にバージョンアップが行われます。ですので、Facebook API を利用している場合、定期的にその対応が必要になります。この記事では、 Facebook A
nntsugu 2016/12/29
API

facebook
リンク
The Confluence Cloud REST API
REST APICQLForgeConnect modulesConnect JavaScript APIApp properties API GraphQL API Switch to classic viewREST API v2AboutAuthentication and authorizationUsing the REST APIAttachmentAncestorsBlog PostChildrenClassification LevelCommentContentContent PropertiesCustom ContentDatabaseData PoliciesLabelLikeOperationPageSmart LinkSpaceSpace PermissionsSpace PropertiesTaskUserVersionWhiteboardRate this pa
nntsugu 2016/11/09
Confluence

API
リンク
RESTful API の設計のキホン
2016/10/12 社内勉強会で使ったスライドを社外向けに一部加筆訂正したもの
nntsugu 2016/10/21
api

教材
リンク
Azure ドキュメント記事
nntsugu 2016/03/02
リファレンス

あとで読む

Azure

api

cli

Reference
リンク
Web API設計指針を考えた｜デロイトトーマツウェブサービス株式会社（DWS）公式ブログ
小文字のみを使用する。単語をつなげる必要がある場合はダッシュを利用する。単数形よりも複数形をつかう。なお、実装がRailsの場合でテーブルの複数形が誤っている場合には、URLは正しい複数形としてRails側を修正する。︵APIに実装を反映させるべきではない。︶スペルミスをしない。 URLの階層は浅く保ち、複雑さはクエリパラメーターに押しこむ。クエリパラメータ名は配列で複数渡すものについては複数形、一つだけ渡すものについては単数形とする。ページングにはper_page、pageというパラメータ名を使用する。と書いてきたが、ただし、RESTには必ずしもこだわらず、あくまで利用側の利便性を重要視した設計とする。1つの作業を完結するために複数回のアクセスを必要とするようなAPIの設計はChatty APIと呼ばれる。これはネットワークのトラフィックを増加させ、クライアントの処理の手間
nntsugu 2016/02/08
あとで読む

api

programming
リンク
API Design: A Documentation-first Approach - DZone
What exactly makes a “good” API? That is a question a lot of developers ask when designing their first API. While there are hundreds of resources online, all with differing opinions about what defines “good,” the majority of them share some similar themes. Logical endpoint naming conventions, clear error messaging, accessibility, and predictability are all crucial pieces in any well-designed API.
nntsugu 2015/10/21
api
リンク
Service Management REST API Reference
The Service Management API provides programmatic access to much of the functionality available through the Management Portal. The Service Management API is a REST API. All API operations are performed over SSL and mutually authenticated using X.509 v3 certificates. Microsoft Azure Subscription A Microsoft Azure subscription is a unique user account in Azure. All resources available via the Service
nntsugu 2015/08/18
いつもURLを見失うページ

Azure

api

Reference
リンク
Microsoft Azure REST API 使い方まとめ – cloud.config Tech Blog
日山(@hiiyan0402)です。 Microsoft Azure サービス管理 REST API の使い方についてまとめました。 Microsoft Azure REST API とは Microsoft Azure 管理ポータルサイトにて行っている操作を、自前のプログラムにてさせることが可能になります。 Microsoft Azureには管理ポータルサイト以外でも、クラウドサービスや仮想マシンなどのリソースに対して操作ができるように、”サービス管理 REST API”という REST API が公開されています。(リファレンスはこちら) REST API は、例えば、管理ポータルで行う作業を自動化したいとき、などに使用することができます。定期的に仮想マシン10台を起動/停止する必要がある場合、人力で決められた時間に仮想マシン10台に同じ操作をする、というのはちょっと面倒くさいし、ヒ
nntsugu 2015/08/04
あとで読む

Azure

API
リンク
Microsoft 課金サービス
We are sorry, the resource you requested cannot be reached. The resource you are looking for is currently unavailable. Help
nntsugu 2015/01/26
IaaSのダッシュボード。SystemCenterの機能をAzureから利用しやすくしたもの。であってるかな？

Azure

OperationalInsights
リンク
APIドキュメントを書くのが楽になるツールまとめ - Qiita
さいきんREST APIのドキュメントを書いていて、wiki使うのだるいし他に良い方法ないかな〜と調べてた時に見つけたツール群をまとめてみます。追記: こちらも便利そうなので参考にどうぞ。 REST APIドキュメント作成ツールはapiary.ioが決定版かもしれない - Qiita swagger Swagger: A simple, open standard for describing REST APIs with JSON | Reverb for Developers デモ: Swagger UI ソースコード中にAPIの概要を書いておくと、それを元にドキュメントを自動生成してくれる。wikiやmarkdownで書くのと決定的な違いは、↓のようにドキュメント上のformからAPIコールを試すことができる点。様々な言語のWAFに対応したライブラリも開発されてる。 Home ·
nntsugu 2014/11/05
api

document
リンク
GitHub - interagent/http-api-design: HTTP API design guide extracted from work on the Heroku Platform API
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert
nntsugu 2014/09/03
API Design Guide

api

design
リンク
HerokuのAPIデザイン
Herokuが自ら実践しているAPIデザインガイドをGithubに公開した． “HTTP API Design Guide” このガイドは些細なデザイン上の議論を避けて，ビジネスロジックに集中すること目的としている．Heroku特有なものではなく，一般にも十分適用できる知見となっている．最近は，モバイル向けにAPIをつくることも多いため，勉強もかねて抄訳した．なお内容は，HTTP+JSONのAPIについて基本的な知識があることが前提となっている．適切なステータスコードを返すそれぞれのレスポンスは適切なHTTPステータスコード返すこと．例えば，“成功"を示すステータスコードは以下に従う． 200: GETやDELETE，PATCHリクエストが成功し，同時に処理が完了した場合 201: POSTリクエストが成功し，同時に処理が完了した場合 202: POSTやDELETE，PATCHリク
nntsugu 2014/09/03
API Design Guide

api

design
リンク
RailsでAPIをつくるときのエラー処理 - Qiita
例外を利用して実装すると便利な場合が多いこの投稿では、HTTP経由でJSONを返すようなWeb APIをRailsを利用して実装するとき、エラーレスポンスを返す場合の処理をどう実装するとやりやすいのか、というニッチな話題に触れる。APIでエラーを返したいとき、即ち400以上のステータスコードと共にレスポンスを返したいような場合、どう実装するのが良いか。もしリクエストの処理中にエラーが検出された場合、それ以降の処理を行わずに直ちに中断してエラーレスポンスを返したいという場合が多いため、例外を利用して実装すると便利な場合が多い。例外を利用しない方が良い場合もある1つのリクエストに複数の問題が含まれている場合、先に見つけた問題だけを報告するようなエラーレスポンスを返すのか、それとも問題を抱えながらも進めるところまで処理を進めて報告可能な情報を全て含むようなエラーレスポンスを返すのか、という
nntsugu 2014/09/01
勘所の話

programming

API

rails

教材
リンク
YappoLogs: 2014年に向けた JSON API の実装の方向性と X-JSON-Status 改め X-API-Status header のご提案
2014年に向けた JSON API の実装の方向性と X-JSON-Status 改め X-API-Status header のご提案追記 2014/11/20 14:00:00 わりと JSON やら XML やら各種フォーマットで API を運用している環境がある場合に JSON API の時だけ X-JSON-Status にすると XML とかの時と整合性取れないし、 X-XML-Status みたいのを量産するのは困る的なレビューを頂いたので X-JSON-Status をやめて X-API-Status にしました。へたに JSON に限定するから REST とか JSON-RPC とかいわれるんや！ X-API-Status にしたら全部解決したし MessagePack な API でも使い回せるって songmu さん言ってた！ XML とかからどうやって引っこ抜
nntsugu 2013/11/19
programming

api
リンク
Zoho CRM V5 APIs
Use Zoho CRM's V5 APIs to create custom solutions to your requirements and integrate third-party applications seamlessly with Zoho CRM.
nntsugu 2013/11/14
api

webservice
リンク
1