It's Gif not Jif!

API Documentation

You can upload files programmatically to "It's GIF not JIF!" using a simple POST request.

Endpoint

POST https://box.itsgifnotjif.space/upload

Request Body

The file should be sent as a multipart/form-data with the field name file.

• Field Name: file
• Content Type: multipart/form-data
• File Size Limit: 100 MB

Response

Upon successful upload, the API will return a JSON object containing the status and the filename.

{
    "status": "success",
    "filename": "your_uploaded_file_name.png"
}

Example Usage (Bash Script)

Here's a bash script that demonstrates how to upload a screenshot using Flameshot, jq, and xclip.

#!/bin/bash -e

# This script requires Flameshot, jq and xclip

url="https://box.itsgifnotjif.space/upload"

temp_file=$(mktemp /tmp/screenshot_XXXXXX.png)

# Take screenshot and save to temporary file
flameshot gui -r > "$temp_file"

# Check if the file is a PNG image
if [[ $(file --mime-type -b "$temp_file") != "image/png" ]]; then
    notify-send "Error: Captured file is not a PNG image." -a "Flameshot"
    rm "$temp_file"
    exit 1
fi

# Upload the image and capture the response
# Add -H "$auth" if authentication is needed
response=$(curl -s -X POST -F "file=@\"$temp_file\"" "$url")

# Check if curl command was successful
if [[ $? -ne 0 ]]; then
    notify-send "Error: Failed to connect to upload server." -a "Flameshot"
    rm "$temp_file"
    exit 1
fi

# Parse JSON response
filename=$(echo "$response" | jq -r ".filename")

# Construct the uploaded URL
uploaded_url="https://box.itsgifnotjif.space/uploads/$filename"
echo "$uploaded_url"

# Copy URL to clipboard
echo "$uploaded_url" | xclip -sel c

# Send notification with success message and image thumbnail
notify-send "Image URL copied to clipboard" -a "Flameshot" -i "$temp_file"

# Clean up temporary file
rm "$temp_file"