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"
}