署名付きURLを利用したファイルアップロードWeb API設計の勘所 | フューチャー技術ブログ

2024/07/05 202 users 勘所 フューチャー技術ブログ AWS ユーザ 方式

はじめに現代のWebアプリケーションにおいて、ユーザが写真や動画などのファイルをアップロードする機能は、しばしば求められます。 本記事では、ファイルアップロードを実現するための一手段として、「署名付きURL」を利用した方式を取り上げ、その設計について詳しく解説します。 今回は、Amazon Web Services（AWS）... 続きを読む

機械学習モデルのA/BテストをしやすくするGo言語のAPI設計 - エムスリーテックブログ

2023/12/11 19 users エムスリーテックブログ Go言語 Bテスト 機械学習モデル

こちらはエムスリー Advent Calendar 2023 11日目の記事です。 DALL-Eでサムネ作るの楽勝だぜとなりそうでならない Overview A/Bテストをしまくっている、機械学習エンジニアの農見(@rookzeno)です。皆さんA/Bテストをしてますでしょうか。エムスリーでは色々な施策の効果を見るために沢山のA/Bテストをしています。その... 続きを読む

OpenAPI (Swagger) まとめ - Qiita

2022/11/09 71 users Swagger OpenApi NEST Rails API

はじめに 自分は実務でReact×TypeScriptを利用したフロント周りとNode.js(Nest)やRailsを用いたバックエンド(API)の開発をしています。 本記事では、OpenAPIを用いたAPI設計の書き方及び、Swaggerの説明と使い方についてまとめていきます。 この記事の対象者 プログラミング初心者から中級者 APIの基礎を理解している人 ... 続きを読む

REST API設計のパターンと原則｜Sachiko Kijima｜note

2022/10/25 246 users REST Note 原則 パターン

APIの設計って意外と移り変わりがあるんです。例えばAPIのバージョンの指定方法がヘッダーを使う方法からURLを使う方法にだんだん統合されてきました。 したがって本やスライドなど、その時点のベストプラクティスを読むよりは、生きているベストプラクティスを読んだ方が良いと思います。 ここではいくつか参考になるリ... 続きを読む

API設計が楽でコア業務に集中できるように。GraphQLで開発がどう変わったか？タクシーアプリGOの中の人に聞きました【技術選定の裏側：GraphQL編 vol.1】

2022/03/02 33 users GraphQL GraphQL編 技術選定 開発 裏側

事前スキルチェックで効率のいい転職活動を。IT/WEBエンジニアのスマートな転職活動ならFindy 続きを読む

Netflixにおける実用的なAPI設計: gRPCとFieldMask | pyspa

2021/10/17 447 users grpc pyspa Netflix

Netflix Tech BlogのgRPC APIに関する以下の２つの記事に感銘を受けたので、ここにその概要を日本語で記します。 (めんどくさかったので)翻訳の許可は取ってませんが、再構成してますし元のJavaではなくPythonで書き直していますので、容赦して下さい… Practical API Design at Netflix, Part 1: Using Protobuf FieldMa... 続きを読む

現地で学んだ自動化、セキュリティ、API設計のアイデアと実践～ドイツのPHPカンファレンスレポート 2日目 - ぐるなびをちょっと良くするエンジニアブログ

2016/12/21 48 users アイデア セキュリティ ドイツ 現地 エンジニアブログ

2016 - 12 - 21 現地で学んだ自動化、セキュリティ、API設計のアイデアと実践～ドイツのPHPカンファレンスレポート 2日目 【執筆者】宮原良介 list Tweet list Tweet こんにちは！ぐるなびエンジニアの宮原です。 2016年10月末に、ドイツ・ミュンヘンで開催されたInternational PHP Conferenceに行ってきました。 1日目の様子は こちら 。... 続きを読む

使いやすい API 設計 - Tech Inside Drecom

2016/12/05 10 users API Tech Inside Drecom 設計 開発 意味

これはドリコム Advent Calendar 2016の5日目です。本記事ではUnity向けゲーム開発基盤で開発しているAssetBundleダウンロードシステムの紹介、そのAPIとAPI設計の話、そしてAPI設計が開発を助ける意味でも重要に感じた話をします。これは ドリコム Advent Calendar 2016 5日目です。 自己紹介 こんにちは。 クライアントアーキテクト部の広井です。 ... 続きを読む

マイクロサービスのための綺麗なAPI設計 by Go Takagi | Wantedly Engineer Blog

2016/08/17 663 users Wantedly Engineer Blog

1. マイクロサービス化をすすめるにあたり、 やりとりは全てAPIで行う 2. APIのRequestは一括で Gateway(Kong) が受けとり、Gatewayが内部のAPIに渡す 3. 内部のAPIであっても外部に公開できるようなクオリティのAPIを作成し、サービスを構成する 今回は、この方針を推し進めるにあたり、現在多くの媒体で 主流なRESTfulなJSONのAPIをどう設計していくか... 続きを読む

5分で絶対に分かるAPI設計の考え方とポイント (6/6) - ＠IT

2015/11/18 23 users ポイント 考え方 5分

基本的に、どちらのケースを使ってもJSONのフォーマットとしては問題ないのですが、そのAPIの仕様の中でキャメルケースかスネークケースで統一することをお勧めします。 エラー時 エラーコードには、以下があります。正しく使い分けて、ユーザーのデバッグを簡単にしてあげましょう。 200系：正常系 300系：リダイレクト系 400系：ユーザーの入力がおかしい場合 500系：サーバー内にて何かエラーが起きて... 続きを読む

5分で絶対に分かるAPI設計の考え方とポイント (1/6) - ＠IT

2015/11/17 592 users HTTPリクエスト API アプリケーション オマケ 自社

API設計を学ぶべき背景と前提知識、外部APIと内部API、エンドポイント、レスポンスデータの設計やHTTPリクエストを送る際のポイントについて解説する。おまけでAPIドキュメント作成ツール4選も。 【0分】API設計を学ぶべき背景と前提知識 APIの公開が増えている 最近、自社で保有するデータや、システム、アプリケーション、Webサービスの機能を「API（Application Programm... 続きを読む

Android - クライアントアプリの為のREST API設計 - Qiita

2015/02/13 94 users クライアントアプリ Qiita Retrofit REST

エンジニアがアプリ担当とAPI担当で分かれているチームで、API担当のエンジニアがアプリ開発経験が無かったりすると、アプリ担当のエンジニアはどんなAPIがクライアントアプリにとって使いやすいのか、上手く伝えるのに苦労する事がありますよね?本記事はそんな場面でAPI担当のエンジニアに読んでもらう事を想定しています。 APIと型 アプリ側はRESTクライアントにRetrofitやRestkit等、既に... 続きを読む

Source: 学生のときにエンジニアという職業について考えていたことを今振り返って

2014/09/07 47 users Source TDD エンジニア 職業 予習

2014年9月7日日曜日 学生のときにエンジニアという職業について考えていたことを今振り返って 学生エンジニアと話す機会が増えました。 先週、学生エンジニア向けインターンTreasureの講師を担当したのです。私はサーバサイドエンジニアリングの領域が担当で、Web API設計やPHPによるAPIサーバの実装、TDDなどについて講義しました。学生は20名ほどおり、みんな熱心に予習をしてきており、その... 続きを読む

API設計のポイント - ワザノバ | wazanova

2014/07/09 98 users wazanova ワザノバ SOA RESTful API

Living Socialが7回に渡りSOA (Service-oriented architecture) についてのブログを書いてますが、今回はAPI設計についてのエントリーです。 「APIはRESTful」と言うだけでなく、社内でガイドラインがオーソライズされるように調整すること。設計にあたっての選択肢及び自由度をしっかり考慮すること。そして一番大事なのは、決めた原則とおりにブレなくインプリ... 続きを読む

C言語における暗黙の型変換とAPI設計 - もなもなもなかのページ

2014/03/19 75 users 暗黙 型変換 なか C言語 ページ

#include <stdio.h> #include <stdlib.h> int main(void) { int a = 65535; char b; b = a; printf("%d %d\n", a, b); return EXIT_SUCCESS; } 「a に 65535 を代入し，b に a の値を代入しているのだから，b も 65535 になるはず．」 などとLL言語(Java... 続きを読む

API設計に関する10のワーストプラクティス｜gihyo.jp … 技術評論社

2013/02/27 39 users ワーストプラクティス gihyo.jp 技術評論社

続きを読む

API設計に関する10のワーストプラクティス « A-Listers

2013/01/11 131 users ワーストプラクティス A-Listers プラクティス 昨今

過半数の開発者が平均で3つ以上のAPIのインテグレーションを実装していると言われている昨今、「使い辛い設計のAPI」を実装するのは開発者にとっては頭の痛い問題ではないでしょうか？ Programable Web上に投稿されたAPIのワーストプラクティスに関する記事が国内外の開発者の目に止まったようです。この記事によると悪いAPIに見られるプラクティスは下記のようなものだそうです。 貧弱なエラーハン... 続きを読む

Shibu's Diary: Pythonはなぜ？str.join(seq)なのか？

2012/09/30 90 users Python Shibu's Diary iterable

PythonのAPI設計の中で、たまに思い出したように話題が出てくるのが、配列に入った文字列を結合するメソッド。Pythonではstr.join(iterable)です。他の言語(僕がよく知っているRubyとJavaScript)はArray.join(String)となっています。どちらでもありえる話ですが、個人的にはPythonの方が自然だな、と感じていました。ですが、他の言語の方がいいという... 続きを読む