mirror of
https://github.com/YGGverse/web-api.git
synced 2026-03-31 17:45:30 +00:00
103 lines
No EOL
1.2 KiB
Markdown
103 lines
No EOL
1.2 KiB
Markdown
# net-api
|
|
|
|
Network API with native Yggdrasil/IPv6 support
|
|
|
|
## Install
|
|
|
|
```
|
|
git clone https://github.com/YGGverse/net-api.git
|
|
cd net-api
|
|
composer install
|
|
```
|
|
|
|
## Run
|
|
|
|
```
|
|
cd src/public
|
|
php -S localhost:8080
|
|
```
|
|
|
|
## Features
|
|
|
|
### Socket
|
|
|
|
Check socket (also useful for open ports detection)
|
|
|
|
#### Usage
|
|
|
|
##### Attributes
|
|
|
|
* `port` - required
|
|
* `host` - optional, name, IPv4 or IPv6 `REMOTE_ADDR` by default
|
|
|
|
##### Request
|
|
|
|
```
|
|
GET socket.php?port=80&host=yo.index
|
|
```
|
|
|
|
##### Response
|
|
|
|
```
|
|
JSON
|
|
{
|
|
success: bool
|
|
}
|
|
```
|
|
|
|
### Dig
|
|
|
|
Show host records
|
|
|
|
#### Usage
|
|
|
|
##### Attributes
|
|
|
|
* `name` - required host name, IPv4 or IPv6
|
|
* `record` - required if `records` not provided
|
|
* `records` - required if `record` not provided
|
|
|
|
###### Records support
|
|
|
|
* [x] A
|
|
* [x] AAAA
|
|
* [x] SRV
|
|
|
|
##### Request
|
|
|
|
###### Single record
|
|
|
|
```
|
|
GET dig.php?name=yo.index&record=A
|
|
```
|
|
|
|
###### Multiple records
|
|
|
|
```
|
|
GET dig.php?name=yo.index&records[]=A&records[]=AAAA
|
|
```
|
|
|
|
##### Response
|
|
|
|
```
|
|
JSON
|
|
{
|
|
success: bool
|
|
records: array
|
|
}
|
|
```
|
|
|
|
## Online
|
|
|
|
### Yggdrasil
|
|
|
|
* `http://[201:23b4:991a:634d:8359:4521:5576:15b7]/api/net/`
|
|
|
|
### Alfis
|
|
|
|
* `http://api.ygg/net/`
|
|
* `http://api.ygg.at/net/`
|
|
|
|
### Clearnet
|
|
|
|
* `https://yggapi.duckdns.org/net/` |