API

APIを作ってもパラメータを忘れてしまうので・・・

ランダム文字列生成：ランダム文字列生成

処理概要

指定の長さ、個数のランダム文字列を生成

エンドポイント

GET：/api/random

パラメータ

パラメータ 意味
o任意アウト形式：デフォjson
json | text
l任意文字列数
c任意生成数

サンプル

 % curl https://mtool.work/api/random?l=5&c=5
 ["ysLeJ","uYGjg","Tlaeb","eqold","fsWJY"]

戻り

1つの場合はアウト形式指定に関係なくtext形式
 DhlcnGAw

2つ以上の場合
json指定時
 [
   "2rFfdgqp",
   "94TzN7gl"
 ]

text指定時
   2rFfdgqp,94TzN7gl

環境変数確認：環境変数確認

処理概要

IPアドレスのみ返す

エンドポイント

GET：/api/ip

パラメータ

なし

サンプル

 % curl https://mtool.work/api/ip
 1.2.3.4

戻り

 IPアドレス

CIDRアドレス計算：CIDRアドレス計算

処理概要

IPとサブネットマスクを指定することで諸々返す

エンドポイント

GET：/api/netmask

パラメータ

パラメータ 意味
i必須IPアドレス
m必須マスク

サンプル

 % curl "https://mtool.work/api/netmask?i=192.168.1.1&m=255.255.255.0"
 {
   "ip_bit" : "24",
   "ip_network_wildcard" : "0.0.0.255",
   "mask" : "255.255.255.0",
   "ip_network_first_ip" : "192.168.1.0",
   "network_host_count" : 254,
   "ip" : "192.168.1.1",
   "ip_hosts_last_ip" : "192.168.1.254",
   "ip_cidr" : "192.168.1.0/24",
   "status" : 0,
   "ip_network_last_ip" : "192.168.1.255",
   "range_count" : 256,
   "ip_hosts_first_ip" : "192.168.1.1"
 }

戻り：成功時

 {
   "status":0
   "ip":"192.168.1.1",
   "mask":"255.255.255.0",
   "network_host_count":254,
   "ip_cidr":"192.168.1.0\/24",
   "ip_bit":"24",
   "ip_network_wildcard":"0.0.0.255",
   "ip_network_first_ip":"192.168.1.0",
   "ip_network_last_ip":"192.168.1.255",
   "ip_hosts_first_ip":"192.168.1.1",
   "ip_hosts_last_ip":"192.168.1.254",
   "range_count":256
 }

戻り：エラー時

 {
   "status":1,
   "msg":"mask\u304c\u6b63\u3057\u304f\u3042\u308a\u307e\u305b\u3093\u3002"
 }

Youtube→MP3：Youtube→MP3

処理概要

音声、動画のダウンロード

エンドポイント

GET：/api/mp[3|4]
パラメータ意味
mp3音声
mp4動画

パラメータ

パラメータ 意味
u必須URL
t任意タイトル
1：入れる
0：入れない
q任意クオリティー：デフォ0(最高)
0-9
k必須アクセスキー

サンプル

 $ curl https://mtool.work/api/mp3?u=[URL]&k=XXXXX
 {
   "status":0,
   "url":" https:\/\/mtool.work\/[download link]"
 }

戻り：成功時

 $ curl https://mtool.work/api/mp3?u=[URL]&k=XXXXX
 {
   "status":0,
   "url":" https:\/\/mtool.work\/[download link]"
 }

戻り：エラー時

 $ curl https://mtool.work/api/mp3?u=[URL]&k=XXXXX
 {
   "status":2
 }

短縮URL確認：短縮URL確認

処理概要

短縮URLをバラして飛び先を返す

エンドポイント

GET：/api/urlcheck

パラメータ

パラメータ 意味
u必須短縮URL

サンプル

 $ curl https://mtool.work/api/urlcheck?u=https://bit.ly/37DV0Z3
 {
   "url":"https:\/\/mtool.work\/",
   "status":0
 }

戻り：成功時

 $ curl https://mtool.work/api/urlcheck?u=https://bit.ly/37DV0Z3
 {
   "url":"https:\/\/mtool.work\/",
   "status":0
 }

戻り：エラー時

 $ curl https://mtool.work/api/urlcheck?u=https://bit.ly/37DV0Z3
 {
   "status":2,
   "url":"\u77ed\u7e2eURL\u3092\u6b63\u3057\u304f\u5165\u529b\u3057\u3066\u304f\u3060\u3055\u3044\u306d\u2026"
 }