[B! API] nharukiのブックマーク

Slack Appの作り方を丁寧に残す【BotとEvent APIの設定編】

とある事情でSlack Appを久しぶりに作ろうとしたら、APIやトークンの仕様が変わっていて混乱したため、自分のための備忘録を兼ねて工程を残すことにしました。最終的に作るAppの実装は別記事の内容になりますが、今回はその前段階として、主にSlack Appに関する設定をSlackのサイト上で行う流れについて残しておきます。この部分はAppの内容にあまり依存しないため、少しでも多くの方に役立てば幸いです。 ※スクリーンショット多いので重かったらごめんなさい Botの作成（主にメッセージ送信などを行う）と、Event APIの設定（トリガーとなるメッセージ受信などを行う）の2つに分けて説明します。 1. Botの作成 1.1 Appの作成ブラウザでSlackワークスペースにサインインした状態で、自分が作成したSlack Appを見ることができるページ（https://api.slack.

nharuki 2023/04/27

Slack
API

リンク

ここがつらい！ Slack API - Qiita

半分ネタ記事です。あんまり真面目に書きません。項目数が多いので，気力でなんとか書きます。分類は諦めます。他にもある！っていうのがあったらコメント欄で教えて下さい。気が向いたら追記します。公式の TypeScript 型定義がもはや型定義を諦めている辛い度: ★★★★★ 辛い中でもこれはかなり上位に来るやつ。こちらに OpenAPI 形式で仕様が定義されていて， https://github.com/slack api/node-slack-sdk/tree/main/packages/web-api/types ここに仕様に基づいて TypeScript の型定義ファイルが吐かれるようになっています。Git 管理されていないので，実際のリリースを見てみましょう。 https://unpkg.com/@slack/web-api@6.7.2/dist/response/Reacti

nharuki 2022/06/20

言語化しづらかった点の8割がた言語化されてた。そうそう！！そういうとこやぞ！！！！とヘドバン並みに頷いてる ●Slack ●API

リンク

APIとかABIとかシステムコールとか - 覚書

はじめに本記事はLinux環境における次のようなことをざっくり理解するための記事です。 Application ProgrammingInterface(API)って何? Application Binary Interface(ABI)って何?システムコールとAPIとABIの関係って？それぞれ何がどう違うの?この手の情報はググればwikipediaやらにいろいろ情報が載ってるんですが、初心者が理解するには細かいことまで書かれすぎていて、かつ、それぞれの関係がわかりにくいです。なので、用語を逐一解説するのではなく、ありがちな質問のQAという形をとりました。人によって用語の意味の揺らぎがあったりするんですが、私の解釈ということで。あからさまに間違っていたら指摘していただけると嬉しいです。これを書こうと思ったきっかけは、以前こんなtweetを見かけたことです。それから﹁そういえば最

nharuki 2021/03/18

API

リンク

[FastAPI] Python製のASGI Web フレームワーク FastAPIに入門する - Qiita

PythonのWeb frameworkで、Flaskのようなマイクロフレームワークにあたります。パフォーマンスの高さ、書きやすさ、本番運用を強く意識した設計、モダンな機能などが強みです。 FastAPIはStarletteの肩に乗る形で書かれており、非同期処理が扱いやすいです。特に、以下の様な特徴があります。 ASGI websocketのサポート GraphQLのサポートバックグラウンドプロセスが扱いやすい python type hintによる自動ドキュメント生成 (Swagger UI) pydanticをベースとしたdata validation 率直に言って、responderに非常に似ています。(でた時期も近いですし、responderもStarletteがベースなので) ですが、下の2つはFastAPIの方がよっぽど使いやすく設計されています。以下の観点から総合的に

nharuki 2020/09/29

API
Python

リンク

FastAPI で独自に定義した API エラーも仕様書に自動反映したかった話 - JX通信社エンジニアブログ

こんにちは、サーバーサイドエンジニアの @kimihiro_n です。最近は FastAPI という Python の Web フレームワークが社内で密かなブームとなっています。今回はその FastAPI を使ったエラー定義まわりの話をしたいと思います。 FastAPI とは FastAPI の概要については先日ちょうど社内勉強会用に資料を作ったのでこちらを見てもらえるのが早いです。ざっくり言えばシンプルなインターフェースとドキュメント(OpenAPI)の自動生成が強力なフレームワークになります。 OpenAPI でドキュメント管理今回注目したいのはドキュメントの自動生成のほうです。開発チームでもドキュメントとAPIの実際の仕様が一致しない問題が時々発生していて、どうドキュメントを管理していくかが課題となっています。 KPTで振り返った結果、﹁人がドキュメントを書くからメンテが大

nharuki 2020/09/29

API
Python

リンク

RFC 7807: Problem Details for HTTP APIs

Internet Engineering Task Force (IETF) M. Nottingham Request for Comments: 7807 Akamai Category: Standards Track E. Wilde ISSN: 2070-1721 March 2016 Probl em Details for HTTP APIs Abstract This document defines a "probl em detail" as a way to carry machine- readable details of errors in a HTTP response to avoid the need to define new error response formats for HTTP APIs. Status of This Memo This is

nharuki 2020/09/29

WebAPI(via HTTP/s)レスポンス上でのエラー詳細記述について規定したRFC

API

リンク

本当に使ってよかったOpenAPI (Swagger) ツール | フューチャー技術ブログ

サードパーティ製のツール本家からは上述のツールが提供されていますが、サードバーティ製の様々なツールが世の中には存在します。エコシステムが成熟しているのもSwaggerを利用するメリットの一つですね。 https://openapi.tools/ 冒頭のとおり、このサードパーティ製のツールの中で実際に利用して良かったツールを3つご紹介したいと思います。Stoplight Studiohttps://stoplight.io/studio/ 1つ目のツールは﹁Stoplight Studio﹂というAPI仕様を記載するためのGUIエディタとなります。今までSwagger Editorを利用してYAMLを書いていたそこのみなさん、YAML筋力はもう必要ありません。 Design APIs 10x faster の謳い文句どおり、Stoplight Studioを使えばGUIで直感的に、高速

nharuki 2020/09/28

便利そう！

API

リンク

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の設計は、私たちにとっ

nharuki 2018/06/21

リンク

Postman | API Development Environment

nharuki 2017/11/02

リンク

Satyr.io

nharuki 2017/09/13

大きさ・解像度・フォーマットなど指定してダミーの画像を取得できるWebサービス

リンク

翻訳: WebAPI 設計のベストプラクティス - Qiita

これは Enchant の開発者である Vinay Sahni さんが書いた記事﹁Best Practices for Designing a Pragmatic RESTful API﹂1を、ご本人の許可を得て翻訳したものです。 RESTful な WebAPI を設計しようとすると、細かなところで長考したり議論したりすると思います。また、他の API に倣ってやってはみたものの、本当にそれでいいのか、どうしてそうしているのか分からない、何てことも少なくはないと思います。この記事では、そのようなハマリどころについて Vinay さんなりの答えを提示し、簡潔かつ明快に解説してくれています。今後 WebAPI を設計される方は、是非参考にしてみてください。なお、誤訳がありましたら編集リクエストを頂けると幸いです。まえがきアプリケーションの開発が進むにつれて、その WebAPI を公

nharuki 2017/01/17

あとでガッツリ読む

リンク

REST APIとは？ - API設計のポイント

最近は様々なサービスでWebAPIが提供されています。普段の開発をする中でもシステム連携などでAPIを作る機会が出てくるのではないでしょうか。 WebAPIの中でもREST APIなんてものもよく聞くのかなぁと思います。REST APIの設計は色々と奥が深く、なかなかおもしろい技術です。今回はそんなREST APIを設計する上でのポイントをご紹介していきます。この記事では実装よりも設計思想的な部分を書いています。次回以降にもう少し実装に近いレベル記事を書いきます！ REST APIとはRESTの原則に沿った形で設計されたAPIを指します。じゃあ、RESTってなんぞや？となると思いますが、参考サイトにはこんなことが書かれています。﹁セッションなどの状態管理を行わない︵やり取りされる情報はそれ自体で完結して解釈することができる︶﹂︵Webシステムでは、HTTP自体にはセッション管理の機構

nharuki 2017/01/11

RESTful
API

リンク

TensorFlowを使った為替(FX)のトレードシステムを作るチュートリアル～システムのセットアップからトレードまで～ - Qiita

TensorFlowを使った為替(FX)のトレードシステムを作るチュートリアル～システムのセットアップからトレードまで～機械学習システムトレードTensorFlowjiji 機械学習ライブラリ「TensorFlow」と、オープンソースのシステムトレードフレームワーク「Jiji」を組み合わせて、機械学習を使った為替(FX)のトレードシステムを作るチュートリアルです。システムのセットアップからはじめて、機械学習モデルの作成、トレーニング、それを使って実際にトレードを行うところまで、具体例を交えて解説します。システム構成次のようなシステムを作ります。 Jijiのバックテスト機能を使ってトレードデータを収集。これをTensorFlowに入力してモデルをトレーニングします。予測する内容については後述。訓練したモデルを使って予測結果を返すREST APIを作り、トレード時にJijiから呼び

nharuki 2016/09/28

リンク

RESTful APIの記述標準化を目指す「Open API Initiative」をマイクロソフト、Google、IBMらが立ち上げ。Swaggerをベースに

RESTful APIの記述標準化を目指す﹁Open APIInitiative﹂をマイクロソフト、Google、IBMらが立ち上げ。Swaggerをベースに10年以上前、XMLの登場に続いてXMLベースのAPIを記述する標準フォーマット﹁WSDL﹂が提唱されました。 WSDLにはAPIの仕様がマシンリーダブルな形で記述されており、APIを呼び出すためのプロトコルやデータフォーマットをあらかじめ知ることができます。WSDLを利用することで、APIをコールするためのコードを自動生成することが可能でした。しかしXMLベースのAPIは期待されたほど普及せず、現在ではよりシンプルなRESTful APIが事実上の標準となっています。そしてRESTful APIのためのWSDLとも言うべき、RESTful APIのインターフェイスを記述するための標準フォーマットを推進する団体﹁Open AP