pb.plz.ac API Documentation

← Back to Home

Basic Information

Base URL: https://pb.plz.ac/

Supported Formats: Text, Images (JPEG, PNG, GIF, WebP, SVG), All file types

Maximum File Size: 10MB

Default Expiration: 24 hours

API Endpoints

POST / - Upload Content

Description: Upload text content or files

Text Upload

curl -X POST --data-binary @- "https://pb.plz.ac/" <<< "Hello World"

File Upload

curl -X POST -F "file=@image.jpg" "https://pb.plz.ac/"
curl -X POST -F "c=@-" "https://pb.plz.ac/" <<< "content"

Response Format Options

# Simple format (URL only)
curl -X POST --data-binary @- "https://pb.plz.ac/?u=1"

# Detailed format (with metadata)
curl -X POST --data-binary @- "https://pb.plz.ac/?v=1"

Response

https://pb.plz.ac/{id}

GET /{id} - Retrieve Content

Description: Retrieve uploaded content by ID

Request Example

curl "https://pb.plz.ac/abc123"

Response

Returns original content with appropriate Content-Type header

PUT /{id} - Update Content

Description: Update existing content

Request Example

curl -X PUT --data-binary @- "https://pb.plz.ac/abc123" <<< "Updated content"

Response

https://pb.plz.ac/abc123 updated.

DELETE /{id} - Delete Content

Description: Delete specified content

Request Example

curl -X DELETE "https://pb.plz.ac/abc123"

Response

https://pb.plz.ac/abc123 deleted.

Status Codes

Status Code Description
200 Success
400 Bad Request (empty file, unsupported format, etc.)
404 Content not found
410 Content expired
413 File too large
500 Server error

Usage Examples

Command Line Usage

# Upload text
echo "Hello World" | curl -X POST --data-binary @- "https://pb.plz.ac/"

# Upload file
curl -X POST --data-binary @file.txt "https://pb.plz.ac/"

# Upload file with form data
curl -X POST -F "file=@image.jpg" "https://pb.plz.ac/"
curl -X POST -F "c=@file.txt" "https://pb.plz.ac/"

# Upload with detailed output
echo "test" | curl -F "c=@-" "https://pb.plz.ac/?v=1"

# Retrieve content
curl "https://pb.plz.ac/abc123"

# Update content
echo "New content" | curl -X PUT --data-binary @- "https://pb.plz.ac/abc123"

# Delete content
curl -X DELETE "https://pb.plz.ac/abc123"

Shell Functions

# Add to ~/.bashrc or ~/.zshrc
pb() {
    curl -X POST --data-binary @- "https://pb.plz.ac/"
}

pbi() {
    curl -X POST -F "file=@$1" "https://pb.plz.ac/"
}

pbget() {
    curl "https://pb.plz.ac/$1"
}

pbdel() {
    curl -X DELETE "https://pb.plz.ac/$1"
}

# Usage examples:
echo "Hello World" | pb
pbi screenshot.png
pbget abc123
pbdel abc123