API دستاویزات

API key حاصل کرنا

سائن اِن کریں، میرا اکاؤنٹ میں جائیں اور API ٹیب کھولیں۔ آپ کی API key وہیں نظر آئے گی، ساتھ Regenerate بٹن بھی ہے۔ key دوبارہ بنانے سے پرانی key فوراً ختم ہو جاتی ہے، اس لیے بٹن دبانے سے پہلے جہاں جہاں وہ استعمال ہو رہی ہے وہاں اسے اپ ڈیٹ کر لیں۔

اسی ٹیب میں ایک دوسری، الگ صرف اپ لوڈ والی key بھی ہے - اسے کب استعمال کرنا ہے، اس کے لیے نیچے دی گئی ٹپ اور فورم پلگ اِنز دیکھیں۔

تصدیق

اپنی key ہیڈر کے طور پر بھیجیں - یہی بہتر طریقہ ہے، کیونکہ کوئری اسٹرنگز اکثر ایکسیس لاگز، پراکسی لاگز اور Referer ہیڈرز میں پہنچ جاتی ہیں:

X-API-Key: YOUR_API_KEY

?key= کوئری پیرامیٹر بھی کام کرتا ہے، جو پرانے انٹیگریشنز اور فوری curl کمانڈز کے لیے رکھا گیا ہے۔ اگر دونوں موجود ہوں تو ہیڈر کو ترجیح ملتی ہے۔

?key=YOUR_API_KEY

اینڈ پوائنٹس

اپ لوڈ، فہرست اور حذف ایک ہی تصدیق اور ریٹ لمٹنگ استعمال کرتے ہیں؛ بڑی فائلیں پہلے حصوں میں بھیجی جا سکتی ہیں۔

POST /api - فائل اپ لوڈ کریں

تصدیق شدہ اکاؤنٹ کے لیے ایک فائل اپ لوڈ کرتا ہے۔

قبول کی جانے والی اقسام: JPG, PNG, GIF, WEBP, AVIF, BMP, TIFF, HEIC یا HEIF تصاویر؛ MP4, WEBM, AVI, MOV, MKV, MPEG, WMV, FLV یا 3GP ویڈیو (درست فہرست وقت کے ساتھ بڑھ سکتی ہے)۔ HEIC/HEIF اور TIFF کو WebP کے طور پر محفوظ کیا جاتا ہے، MP4/WebM کے علاوہ ویڈیو MP4 میں تبدیل ہوتی ہے، اور بڑی JPEG/PNG تصاویر اپ لوڈ کے کچھ دیر بعد WebP میں بدل دی جاتی ہیں جب اس سے ان کا سائز نمایاں طور پر کم ہو۔ زیادہ سے زیادہ سائز: 200MB؛ بہت بڑی یا ناقابلِ مطالعہ فائلیں 422 کے ساتھ مسترد ہو جاتی ہیں۔

جواب - 200 OK:

{
  "type": "success",
  "msg": "success",
  "data": {
    "id": "aB3xY9qRz1",
    "type": "image",
    "path": "https://i.yourimageshare.com/aB3xY9qRz1.png",
    "src": "https://yourimageshare.com/ib/aB3xY9qRz1.png",
    "direct": "https://yourimageshare.com/ib/aB3xY9qRz1",
    "thumb": "https://i.yourimageshare.com/thumb-aB3xY9qRz1.webp",
    "width": 1920,
    "height": 1080,
    "size": 482113,
    "locked": false,
    "visibility": "unlisted",
    "title": null,
    "description": null,
    "expires_at": null,
    "duplicate": false,
    "delete_url": "https://yourimageshare.com/delete#iV3x...k9"
  }
}

POST /api/chunk - بڑی فائلیں

ایک ریکویسٹ میں زیادہ سے زیادہ 100MB جا سکتے ہیں۔ بڑی فائلوں ( 200MB تک) کے لیے، یا سست کنکشن پر ہر ریکویسٹ چھوٹی رکھنے کے لیے، فائل کو زیادہ سے زیادہ 5MB کے حصوں میں بھیجیں، پھر POST /api سے مکمل کریں:

1. ایک اپ لوڈ آئی ڈی چنیں: 32 بے ترتیب ہیکس حروف۔
2. ہر حصے کے لیے POST /api/chunk (multipart/form-data) کریں جس میں upload_id، index (0 سے شروع)، total (حصوں کی تعداد) اور chunk میں بائٹس ہوں۔ جواب {"type": "success", "chunk_size": 5242880} ہوگا۔
3. uploads کی جگہ upload_id اور filename کے ساتھ POST /api کریں، اور دیگر اپ لوڈ فیلڈز بھی شامل کر سکتے ہیں۔ جواب عام اپ لوڈ والا ہی ہوگا۔

نامکمل اپ لوڈ کے حصے 2 گھنٹے بعد حذف ہو جاتے ہیں۔ اپ لوڈ ریٹ لمٹس میں صرف آخری POST /api شمار ہوتا ہے۔

GET /api/{id} اور PATCH /api/{id} - ایک اپ لوڈ

GET آپ کا ایک اپ لوڈ انہی فیلڈز کے ساتھ واپس کرتا ہے جو نیچے فہرست میں ہیں۔ PATCH اس کی visibility، title یا description تبدیل کرتا ہے (فارم فیلڈز یا JSON؛ خالی عنوان یا تفصیل اسے صاف کر دیتی ہے) اور اپ ڈیٹ شدہ اپ لوڈ واپس دیتا ہے۔ دونوں کے لیے مکمل API key درکار ہے؛ آپ کے اکاؤنٹ پر ایسا اپ لوڈ نہ ہو تو 404۔

curl -X PATCH https://yourimageshare.com/api/aB3xY9qRz1 \
  -H "X-API-Key: YOUR_API_KEY" -d visibility=public -d title="Sunset"

POST /api/{id}/replace - فائل تبدیل کریں

آپ کے ایک اپ لوڈ کے پیچھے فائل بدل دیتا ہے اور اس کی آئی ڈی، صفحہ اور تمام لنکس برقرار رکھتا ہے۔ کوئی بھی اجازت یافتہ قسم چلتی ہے، حتیٰ کہ مختلف قسم بھی (تصویر ویڈیو بن سکتی ہے)۔ نئی فائل uploads کے طور پر بھیجیں (یا POST /api/chunk سے حصوں میں بھیجی گئی فائل کا upload_id)؛ keep_original اپ لوڈ کی طرح کام کرتا ہے۔ نئی فائل کی وہی جانچ اور تبدیلیاں ہوتی ہیں جو نئے اپ لوڈ کی، اور پچھلا ورژن ہٹا دیا جاتا ہے۔ مکمل API key درکار ہے؛ آپ کے اکاؤنٹ پر ایسا اپ لوڈ نہ ہو تو 404، اگر وہ پاس ورڈ سے محفوظ یا ویو لمٹ والا ہو تو 409۔

curl -X POST https://yourimageshare.com/api/aB3xY9qRz1/replace \
  -H "X-API-Key: YOUR_API_KEY" -F uploads=@new-version.png

GET /api - اپنے اپ لوڈز کی فہرست

تصدیق شدہ اکاؤنٹ کے اپ لوڈز کی صفحہ بندی والی فہرست دیتا ہے (کسی بھی ذریعے سے - API، ویب سائٹ یا ایڈیٹر)، نئے سب سے پہلے، ہر صفحے پر 50۔

جواب - 200 OK:

{
  "type": "success",
  "data": [
    {
      "id": "aB3xY9qRz1",
      "type": "image",
      "title": null,
      "path": "https://i.yourimageshare.com/aB3xY9qRz1.webp",
      "src": "https://yourimageshare.com/ib/aB3xY9qRz1.webp",
      "direct": "https://yourimageshare.com/ib/aB3xY9qRz1",
      "thumb": "https://i.yourimageshare.com/thumb-aB3xY9qRz1.webp",
      "width": 1920,
      "height": 1080,
      "size": 482113,
      "locked": false,
      "visibility": "unlisted",
      "description": null,
      "expires_at": null,
      "created_at": "2026-07-23T15:43:28+01:00"
    }
  ],
  "meta": { "current_page": 1, "last_page": 1, "total": 1 }
}

یہاں فیلڈز کے معنی وہی ہیں جو اوپر اپ لوڈ کے جواب میں ہیں (پاس ورڈ سے محفوظ اپ لوڈ کے لیے path اور thumb مختصر مدت کے دستخط شدہ لنکس ہوتے ہیں)۔ کسی ایک اپ لوڈ کو اس کی id سے دیکھنے کے لیے GET /api/{id} استعمال کریں۔

DELETE /api/{id} - اپ لوڈ حذف کریں

تصدیق شدہ اکاؤنٹ کا ایک اپ لوڈ مستقل طور پر حذف کرتا ہے۔ اسے API سے واپس نہیں کیا جا سکتا۔ {id} وہ قدر ہے جو اپ لوڈ یا فہرست کے اینڈ پوائنٹس id کے طور پر واپس کرتے ہیں۔

جواب - 200 OK:

{ "type": "success", "msg": "Deleted." }

اگر آپ کے اکاؤنٹ پر اس آئی ڈی کا کوئی اپ لوڈ نہ ہو (یا تو وہ کبھی آپ کا تھا ہی نہیں، یا پہلے ہی حذف ہو چکا ہے) تو 404۔

POST /api/compare - پہلے/بعد کا سلائیڈر

آپ کی اپنی دو تصاویر کے اپ لوڈز کا پہلے/بعد کا موازنہ بناتا ہے: /c/{id} پر سلائیڈر والا صفحہ جو کسی بھی ویب سائٹ میں ایمبیڈ بھی ہو سکتا ہے۔ صرف اپ لوڈ والی key بھی چلتی ہے۔ before اور after (اپ لوڈ آئی ڈیز، لازمی) بھیجیں، اور چاہیں تو title، label_before اور label_after (ڈیفالٹ "Before" اور "After")۔

جواب - 201 Created:

{
  "type": "success",
  "id": "P7uAYy04VA",
  "url": "https://yourimageshare.com/c/P7uAYy04VA",
  "embed_url": "https://yourimageshare.com/embed/c/P7uAYy04VA",
  "embed": { "script": "<blockquote class=\"YISEmbed\" ...", "iframe": "<iframe ..." }
}

اگر کوئی آئی ڈی آپ کی تصویر کا اپ لوڈ نہ ہو تو 422 (ویڈیوز اور پاس ورڈ سے محفوظ تصاویر استعمال نہیں ہو سکتیں)۔

ریٹ لمٹس

ہر API key کے اپنے الگ فی منٹ اور فی دن کوٹے ہیں، ساتھ ایک سخت فی IP روزانہ حد بھی ہے تاکہ ایک IP سے کئی keys بدل بدل کر استعمال نہ ہو سکیں۔ اپ لوڈز، فہرستیں اور حذف ایک ہی حدیں شیئر کرتے ہیں۔

یہ حدیں بدل سکتی ہیں۔ ہر جواب میں معیاری ریٹ لمٹ ہیڈرز شامل ہوتے ہیں:

X-RateLimit-Limit: 20
X-RateLimit-Remaining: 14

حد پار ہونے پر 429 واپس آتا ہے، اور Retry-After ہیڈر بتاتا ہے کہ کتنے سیکنڈ انتظار کرنا ہے۔

غلطیاں

ہر غلطی کا جواب ایک ہی شکل رکھتا ہے، چاہے اینڈ پوائنٹ یا وجہ کوئی بھی ہو:

{ "type": "error", "errors": "A human-readable description of what went wrong." }

کلائنٹ لائبریریاں

سرکاری SDKs جو اوپر کے اینڈ پوائنٹس کو ٹائپ شدہ نتائج کے ساتھ لپیٹتے ہیں اور خام HTTP سنبھالنے کی بجائے API کی غلطیوں پر ایرر دیتے ہیں۔

JavaScript / TypeScript

کوئی ڈیپینڈنسی نہیں، Node.js اور براؤزرز میں چلتی ہے۔ JSR پر بھی @yourimageshare/yourimageshare کے نام سے دستیاب - npx jsr add @yourimageshare/yourimageshare - وہی سورس، براہِ راست TypeScript میں شائع۔

npm install yourimageshare

Python

ایک ڈیپینڈنسی (requests)، Python 3.8+۔

pip install yourimageshare

PHP

Composer کی کوئی ڈیپینڈنسی نہیں (PHP کی اپنی curl ایکسٹینشن استعمال کرتی ہے)، PHP 7.4+۔ سورس GitHub پر۔

composer require yourimageshare/yourimageshare-php

Go

کوئی ڈیپینڈنسی نہیں (صرف اسٹینڈرڈ لائبریری)، Go 1.18+۔ مکمل حوالہ جاتی دستاویزات کے لیے pkg.go.dev دیکھیں۔

go get github.com/yourimageshare/yourimageshare/go

Rust

دو ڈیپینڈنسیز (بلاکنگ HTTP کے لیے ureq - کوئی async رن ٹائم شامل نہیں - اور serde)، Rust 1.70+۔ سورس GitHub پر۔

cargo add yourimageshare

Ruby

کوئی gem ڈیپینڈنسی نہیں (stdlib کا Net::HTTP + json)، Ruby 2.7+۔ سورس GitHub پر۔

gem install yourimageshare

.NET

ایک ڈیپینڈنسی (Microsoft کی اپنی System.Text.Json)، netstandard2.0 کو ہدف بناتی ہے اس لیے .NET Framework اور جدید .NET دونوں سے چلتی ہے۔ سورس GitHub پر۔ اس لائیو API کے خلاف بنائی اور جانچی گئی؛ NuGet پر جلد شائع ہوگی۔

dotnet add package YourImageShare

Dart / Flutter

ایک ڈیپینڈنسی (http، Dart ٹیم کا اپنا پیکیج)، Dart 2.17+۔ سورس GitHub پر۔ اس لائیو API کے خلاف بنائی اور جانچی گئی؛ pub.dev پر جلد شائع ہوگی۔

dart pub add yourimageshare

Elixir

ایک ڈیپینڈنسی (Req)، Elixir 1.14+۔ یہ {:ok, result}| {:error, reason} ٹیگ شدہ ٹپلز واپس کرتی ہے - جو باقی تمام SDKs میں اس API کی ایرر ہینڈلنگ کے براہِ راست مساوی ہے - اور ساتھ ایسے bang ورژن بھی ہیں جو ایرر اٹھاتے ہیں۔ سورس GitHub پر، دستاویزات HexDocs پر۔

{:yourimageshare, "~> 1.1"}

MCP سرور

AI کوڈنگ ایجنٹس کے لیے (Claude Code، Cursor اور دوسرے MCP-سے مطابقت رکھنے والے ٹولز) - بگ رپورٹ، PR کی تفصیل یا سپورٹ تھریڈ میں اسکرین شاٹ base64 بلاب یا دستی اپ لوڈ کے بغیر اصلی لنک کے طور پر شامل کریں۔ Claude Desktop اور کسی بھی دوسرے MCP کلائنٹ کے ساتھ بھی اسی طرح کام کرتا ہے۔

ہوسٹڈ، کچھ انسٹال کرنے کی ضرورت نہیں: اسے ریموٹ MCP سرور کے طور پر شامل کریں (Claude میں: Settings › Connectors › Add custom connector؛ نیز ChatGPT، Cursor، VS Code اور وہ دوسرے کلائنٹس جو سرور کا URL لیتے ہیں) اور اپنی API key URL میں رکھیں:

https://yourimageshare.com/mcp?key=YOUR_API_KEY

جو کلائنٹس ہیڈرز سیٹ کرنے دیتے ہیں وہ اس کی جگہ https://yourimageshare.com/mcp کے ساتھ Authorization: Bearer YOUR_API_KEY استعمال کر سکتے ہیں۔ آپ کی key والا URL پاس ورڈ کی طرح کام کرتا ہے: اسے نجی رکھیں، اور لیک ہو جائے تو میرا اکاؤنٹ میں نئی key بنائیں۔ ہوسٹڈ سرور پر upload_image عوامی لنک (200MB تک) یا ان لائن base64 مواد (15MB تک) لیتا ہے۔ key کے بغیر بھی https://yourimageshare.com/mcp ویب سائٹ کی طرح گمنام اپ لوڈ کرتا ہے: صرف unlisted یا private، کم حدیں، اور اپ لوڈ اس delete_url سے حذف ہوتا ہے جو وہ واپس دیتا ہے۔ باقی ٹولز کے لیے key ضروری ہے۔

مقامی: اسے npx سے براہِ راست چلائیں، انسٹال کا کوئی مرحلہ نہیں (یہ آپ کی ڈسک سے فائلیں بھی پڑھ سکتا ہے):

npx yourimageshare-mcp

ٹولز: upload_image (مقامی فائل، ان لائن مواد یا لنک، 200MB تک، اختیاری مرئیت، عنوان اور خودکار حذف کے ساتھ)، list_uploads، get_upload، update_upload اور delete_upload۔

سرکاری MCP Registry میں بھی (io.github.yourimageshare/yourimageshare کے نام سے) اور Smithery اور Glama پر درج، اگر آپ کا MCP کلائنٹ ان میں سے کسی سے انسٹال کرتا ہے۔

MCP آپ کے لیے نیا ہے؟ مکمل سیٹ اپ کے لیے MCP کے ذریعے Claude اور ChatGPT کو اس API سے جوڑنے کا طریقہ دیکھیں۔

کوڈ کی مثالیں

curl

# Upload a file
curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "uploads=@/path/to/photo.jpg"

# Upload from a link (files up to 200MB; one direct upload request stops at 100MB -
# bigger files go in pieces, see Large Files above)
curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "url=https://example.com/video.mp4"

# Upload a file that auto-deletes after 1 hour
curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "uploads=@/path/to/photo.jpg" \
  -F "expires_in=3600"

# List uploads
curl "https://yourimageshare.com/api" -H "X-API-Key: YOUR_API_KEY"

# Upload a file without a page of its own (file only) and give it a title
curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "uploads=@/path/to/photo.jpg" \
  -F "visibility=private" \
  -F "title=Sunset"

# Look up one upload, then make it public
curl "https://yourimageshare.com/api/aB3xY9qRz1" -H "X-API-Key: YOUR_API_KEY"
curl -X PATCH "https://yourimageshare.com/api/aB3xY9qRz1" \
  -H "X-API-Key: YOUR_API_KEY" -d "visibility=public"

# Delete an upload
curl -X DELETE "https://yourimageshare.com/api/aB3xY9qRz1" -H "X-API-Key: YOUR_API_KEY"

JavaScript (fetch)

const API_KEY = 'YOUR_API_KEY';
const BASE = 'https://yourimageshare.com/api';

async function uploadFile(file) {
  const form = new FormData();
  form.append('uploads', file);

  const res = await fetch(BASE, {
    method: 'POST',
    headers: { 'X-API-Key': API_KEY },
    body: form,
  });
  const json = await res.json();
  if (json.type !== 'success') throw new Error(json.errors);
  return json.data;
}

async function listUploads(page = 1) {
  const res = await fetch(`${BASE}?page=${page}`, {
    headers: { 'X-API-Key': API_KEY },
  });
  return res.json();
}

async function deleteUpload(id) {
  const res = await fetch(`${BASE}/${id}`, {
    method: 'DELETE',
    headers: { 'X-API-Key': API_KEY },
  });
  return res.json();
}

Python (requests)

import requests

API_KEY = "YOUR_API_KEY"
BASE = "https://yourimageshare.com/api"

HEADERS = {"X-API-Key": API_KEY}

# Upload a file
with open("/path/to/photo.jpg", "rb") as f:
    res = requests.post(BASE, headers=HEADERS, files={"uploads": f})
res.raise_for_status()
upload = res.json()["data"]

# List uploads
res = requests.get(BASE, headers=HEADERS, params={"page": 1})
uploads = res.json()

# Delete an upload
res = requests.delete(f"{BASE}/{upload['id']}", headers=HEADERS)

PHP (curl)

<?php

$apiKey = 'YOUR_API_KEY';
$base = 'https://yourimageshare.com/api';

// Upload a file
$curl = curl_init($base);
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: $apiKey"],
    CURLOPT_POSTFIELDS => ['uploads' => new CURLFile('/path/to/photo.jpg')],
    CURLOPT_RETURNTRANSFER => true,
]);
$upload = json_decode(curl_exec($curl), true)['data'];
curl_close($curl);

// List uploads
$curl = curl_init("$base?page=1");
curl_setopt($curl, CURLOPT_HTTPHEADER, ["X-API-Key: $apiKey"]);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$uploads = json_decode(curl_exec($curl), true);
curl_close($curl);

Go (net/http)

اوپر دیا گیا سرکاری Go SDK یہ سب آپ کے لیے سنبھال لیتا ہے - یہ خام ورژن ان کے لیے ہے جو ڈیپینڈنسی شامل نہیں کرنا چاہتے۔

package main

import (
    "bytes"
    "encoding/json"
    "io"
    "mime/multipart"
    "net/http"
    "os"
)

const apiKey = "YOUR_API_KEY"
const base = "https://yourimageshare.com/api"

func uploadFile(path string) (map[string]any, error) {
    file, err := os.Open(path)
    if err != nil {
        return nil, err
    }
    defer file.Close()

    body := &bytes.Buffer{}
    writer := multipart.NewWriter(body)
    part, _ := writer.CreateFormFile("uploads", path)
    io.Copy(part, file)
    writer.Close()

    req, _ := http.NewRequest("POST", base, body)
    req.Header.Set("Content-Type", writer.FormDataContentType())
    req.Header.Set("X-API-Key", apiKey)

    res, err := http.DefaultClient.Do(req)
    if err != nil {
        return nil, err
    }
    defer res.Body.Close()

    var result map[string]any
    json.NewDecoder(res.Body).Decode(&result)
    return result, nil
}

اسکرین شاٹ ٹولز

ایک براؤزر ایکسٹینشن، اور تیار کنفیگز اور اسکرپٹس جو اسکرین شاٹس سیدھے YourImageShare پر بھیجتے ہیں، دستی اپ لوڈ کے بغیر۔ ہر ایک اوپر دستاویزی /api اینڈ پوائنٹ ہی کے ذریعے اپ لوڈ کرتا ہے۔

براؤزر ایکسٹینشن (Chrome اور Firefox)

Chrome اور Firefox کے لیے YourImageShare Capture ایکسٹینشن اسکرپٹس اور کنفیگ فائلوں کی ضرورت ہی ختم کر دیتی ہے۔ یہ نظر آنے والا حصہ، ڈریگ سے منتخب علاقہ، یا پورا اسکرول ہونے والا صفحہ کیپچر کرتی ہے، پھر ایک بلٹ اِن ایڈیٹر کھولتی ہے جس میں تیر، متن، دھندلا/چھپانا اور دوسرے نشانات ہیں، اور نتیجہ ڈاؤن لوڈ کرتی ہے، کلپ بورڈ پر کاپی کرتی ہے، یا ایک کلک میں سیدھا YourImageShare پر شائع کر دیتی ہے۔ شائع کرنا اوپر دستاویزی ہی /api اینڈ پوائنٹ استعمال کرتا ہے - ایکسٹینشن کی Settings میں اپنی API key ایک بار شامل کریں اور اس کے بعد ہر شائع پر فوراً شیئر کرنے کے قابل لنک مل جاتا ہے۔ ڈیسک ٹاپ Chrome (اور دوسرے Chromium براؤزرز)، ڈیسک ٹاپ Firefox اور Android کے Firefox میں کام کرتی ہے۔

Firefox کے لیے YourImageShare Capture حاصل کریں Chrome کے لیے YourImageShare Capture حاصل کریں

ShareX

نیچے سے کسٹم اپ لوڈر ڈاؤن لوڈ کریں، پھر ShareX میں Destinations > Custom uploader settings > Import > from file پر جائیں، ڈاؤن لوڈ شدہ .sxcu کھولیں، اور Headers فیلڈ میں YOUR_API_KEY کی جگہ اپنی اصل key ڈالیں۔ اسے اپنی تصویر/فائل کی منزل بنا لیں اور کیپچرز خود بخود اپ لوڈ ہوں گے۔

YourImageShare.sxcu ڈاؤن لوڈ کریں

Flameshot (Linux)

ایک چھوٹا شیل اسکرپٹ جو flameshot gui چلاتا ہے، کیپچر اپ لوڈ کرتا ہے اور لنک آپ کے کلپ بورڈ پر کاپی کر دیتا ہے۔ اسے اپنے ڈیسک ٹاپ ماحول میں Flameshot کے ڈیفالٹ شارٹ کٹ کی جگہ کی بورڈ شارٹ کٹ سے جوڑ دیں۔

yis-flameshot-upload.sh ڈاؤن لوڈ کریں

# One-time setup
chmod +x yis-flameshot-upload.sh
export YIS_API_KEY="YOUR_API_KEY"   # or add to ~/.config/yourimageshare/api_key

# Then bind this to a hotkey instead of calling flameshot directly:
/path/to/yis-flameshot-upload.sh

Greenshot (Windows)

Greenshot کی بلٹ اِن External command منزل کے لیے ایک PowerShell اسکرپٹ۔ Windows کے ساتھ آنے والے Windows PowerShell 5.1 سے مطابقت رکھتا ہے، کسی اضافی انسٹال کی ضرورت نہیں۔

yis-greenshot-upload.ps1 ڈاؤن لوڈ کریں

# One-time setup
setx YIS_API_KEY "YOUR_API_KEY"

# In Greenshot: Preferences > Destinations > External command > Settings
#   Command:   powershell.exe
#   Arguments: -ExecutionPolicy Bypass -File "C:\path\to\yis-greenshot-upload.ps1" "%1"

فورم پلگ اِنز

اپنے فورم کے پوسٹ ایڈیٹر کے ساتھ ایک اصلی "تصویر اپ لوڈ کریں" بٹن شامل کریں۔ ہر ایک اوپر دستاویزی ہی /api اینڈ پوائنٹ کے ذریعے اپ لوڈ کرتا ہے اور آپ کے کرسر کی جگہ BBCode ڈال دیتا ہے - الگ ٹیب نہیں، دستی کاپی پیسٹ نہیں۔

فورم اپ لوڈز ڈیفالٹ طور پر private ہوتے ہیں: تصویر پوسٹ میں کام کرتی ہے، لیکن YourImageShare اسے اپنا کوئی صفحہ نہیں دیتا (کوئی کمنٹس، ردِعمل یا اشتہارات نہیں)۔ ہر پلگ اِن میں unlisted پر سوئچ کرنے کی سیٹنگ ہے اگر آپ لنک رکھنے والے ہر شخص کے لیے صفحہ بھی چاہتے ہیں۔

phpBB

ایک اصلی phpBB 3.2/3.3 ایکسٹینشن۔ ext/ میں unzip کریں، Customise > Manage extensions کے تحت فعال کریں، پھر ایکسٹینشن کی ٹیمپلیٹ ایونٹ فائل میں YOUR_UPLOAD_ONLY_KEY کی جگہ اپنی اصل صرف اپ لوڈ والی key ڈالیں۔

phpBB کے لیے ڈاؤن لوڈ کریں

SMF (Simple Machines Forum)

ایک اصلی SMF پیکیج - Admin > Package Manager سے انسٹال کریں، پھر Sources/yis_forumupload.php میں YOUR_UPLOAD_ONLY_KEY کی جگہ اپنی اصل صرف اپ لوڈ والی key ڈالیں۔

SMF کے لیے ڈاؤن لوڈ کریں

MyBB

ایک اصلی MyBB 1.8 پلگ اِن۔ inc/plugins/ میں کاپی کریں، Configuration > Plugins کے تحت فعال کریں، پھر پلگ اِن فائل میں YOUR_UPLOAD_ONLY_KEY کی جگہ اپنی اصل صرف اپ لوڈ والی key ڈالیں۔

MyBB کے لیے ڈاؤن لوڈ کریں

FluxBB، PunBB اور ZetaBoards

ان میں باقاعدہ پلگ اِن سسٹم نہیں ہے، اس لیے یہ ایک چھوٹا اسنیپٹ ہے جو سیدھا آپ کی ٹیمپلیٹ (FluxBB/PunBB) یا Admin CP (ZetaBoards) میں پیسٹ کیا جاتا ہے - ہر ایک کے لیے مکمل کاپی پیسٹ ہدایات:

FluxBB ہدایات PunBB ہدایات ZetaBoards ہدایات

WordPress پلگ اِن

اپنی میڈیا لائبریری کو لوکل ڈسک کی بجائے YourImageShare پر منتقل کریں۔ نئے تصویر/ویڈیو اپ لوڈز خود بخود اوپر دستاویزی ہی /api اینڈ پوائنٹ سے جاتے ہیں، اپ لوڈ کی تصدیق ہوتے ہی مقامی فائل (اور بنائی گئی ہر تھمب نیل سائز) حذف ہو جاتی ہے، اور WordPress کا ہر اٹیچمنٹ URL - بلاک ایڈیٹر، نمایاں تصاویر، گیلریاں، REST API - YourImageShare پر موجود فائل کی طرف جاتا ہے۔ کوئی شارٹ کوڈ نہیں، ورک فلو میں کوئی تبدیلی نہیں۔

• موجودہ میڈیا لائبریری کو پس منظر میں (یا wp yis offload --all سے) بلک میں منتقل کریں، صرف نئے اپ لوڈز نہیں
• پوسٹس میں پہلے سے لگی تصاویر اور ویڈیوز مقامی فائلیں ہٹنے کے بعد بھی کام کرتی رہتی ہیں
• تھمب نیلز اور srcset ہماری 280px تھمب نیل استعمال کرتے ہیں، اس لیے چھوٹی تصویری جگہوں پر پورے سائز کی فائلیں لوڈ نہیں ہوتیں
• 200MB تک کی فائلیں، حصوں میں بھیجی جاتی ہیں تاکہ بڑی ویڈیوز شیئرڈ ہوسٹ پر بوجھ نہ بنیں
• کسی بھی منتقل شدہ فائل کو کسی بھی وقت واپس مقامی اسٹوریج میں بحال کریں
• میڈیا لائبریری کا ایک کالم دکھاتا ہے کہ کیا منتقل ہو چکا ہے اور کیا ابھی مقامی ہے
• منتقل شدہ فائلیں private کے طور پر محفوظ ہوتی ہیں: وہ آپ کی سائٹ پر جہاں بھی استعمال ہوں لوڈ ہوتی ہیں، لیکن YourImageShare پر ان کا اپنا کوئی صفحہ نہیں بنتا

WordPress.org سے حاصل کریں ZIP ڈاؤن لوڈ کریں

WordPress میں: Plugins > Add New، YourImageShare Media Offload تلاش کریں، پھر Install اور Activate کریں۔

کسی بھی ویب سائٹ کے لیے اپ لوڈ بٹن

اپنے وزیٹرز کو کسی بھی سائٹ پر "اپ لوڈ" بٹن دیں - کمنٹ فارم، سپورٹ صفحہ، ایسا فورم جس کے لیے ہمارے پاس پلگ اِن نہیں، یا اسٹیٹک سائٹ۔ بس دو لائنیں پیسٹ کریں؛ اکاؤنٹ اور سرور کوڈ کی ضرورت نہیں۔

<a class="yis-upload" href="https://yourimageshare.com/" data-target="#message" data-format="bbcode">Image and video hosting by YourImageShare</a>
<script src="https://yourimageshare.com/w.js" async></script>

دونوں attributes اختیاری ہیں: ان کے بغیر بٹن لنکس Copy بٹن کے ساتھ دکھاتا ہے۔ اپ لوڈ باکس لنک کے گرد بنتا ہے۔

• اپ لوڈ آپ کے صفحے ہی پر ہوتا ہے: بٹن پر کلک کریں، اس پر فائلیں ڈراپ کریں، یا اس میں اسکرین شاٹ پیسٹ کریں - ایک ساتھ کئی فائلیں، پروگریس بار اور تھمب نیل کے ساتھ
• data-target میں بتائے گئے فیلڈ (کوئی بھی textarea، input یا قابلِ ترمیم باکس) میں سیدھی پیسٹ یا ڈراپ کی گئی تصاویر بھی اپ لوڈ ہوتی ہیں، اور لنکس اسی فیلڈ میں شامل ہو جاتے ہیں؛ ٹارگٹ نہ ہو تو وہ بٹن کے نیچے Copy بٹن کے ساتھ ظاہر ہوتے ہیں
• data-format: url (فائل کا براہِ راست لنک، ڈیفالٹ)، page، bbcode، html یا markdown؛ data-label بٹن کا متن بدلتا ہے
• data-key (اختیاری): آپ کی صرف اپ لوڈ والی key (میرا اکاؤنٹ > API)۔ پھر اپ لوڈز آپ کے اپنے اکاؤنٹ میں آپ کی اپنی حدوں کے تحت جاتے ہیں۔ key کے بغیر اپ لوڈز گمنام اور unlisted ہوتے ہیں، فی وزیٹر اور فی سائٹ روزانہ حد کے ساتھ
• ڈیولپرز اپ لوڈ باکس پر yis:upload ایونٹ سن سکتے ہیں: event.detail.item میں {id, type, page, url, thumb} ہوتا ہے
• بٹن کے ذریعے 95 MB تک کی فائلیں (بڑی ویب سائٹ پر)۔ ہماری ماڈریشن اور شرائط معمول کے مطابق لاگو ہیں؛ ہر وزیٹر کو اپنا حذف کرنے کا لنک ملتا ہے

بٹن اپنے الگ تھلگ باکس میں بنتا ہے، اس لیے آپ کی سائٹ کا CSS اسے خراب نہیں کر سکتا۔ چھوٹا سا "Image and video hosting by YourImageShare" لنک اپ لوڈ باکس کے اندر نظر آتا رہتا ہے۔

iPhone اور iPad شارٹ کٹ

کسی بھی ایپ کی شیئر شیٹ سے اپ لوڈ کریں - Photos، Files، Safari، اسکرین شاٹ - اور لنک اپنے کلپ بورڈ پر پائیں۔ کوئی ایپ انسٹال کرنے کی ضرورت نہیں اور اکاؤنٹ بھی نہیں چاہیے۔

اسے Shortcuts ایپ میں خود بنانے کے لیے (تقریباً دو منٹ):

1. نیا شارٹ کٹ بنائیں، نام "Upload to YourImageShare" رکھیں۔ اس کی تفصیلات میں Show in Share Sheet آن کریں اور تصاویر اور میڈیا قبول کریں۔
2. Get Contents of URL شامل کریں: URL https://yourimageshare.com/api/widget، میتھڈ POST، ریکویسٹ باڈی Form جس میں دو فیلڈز ہوں: uploads (File) = Shortcut Input، اور client (Text) = ios-shortcut۔
3. data کے لیے Get Dictionary Value شامل کریں، پھر src کے لیے ایک اور - یہی براہِ راست لنک ہے۔
4. Copy to Clipboard اور Show Notification ("Link copied") شامل کریں۔

key کے بغیر اپ لوڈز گمنام اور unlisted ہوتے ہیں، روزانہ حد کے ساتھ۔ اپنے اکاؤنٹ میں اپ لوڈ کرنے کے لیے اپنی صرف اپ لوڈ والی key (میرا اکاؤنٹ > API) کے ساتھ X-API-Key ہیڈر شامل کریں۔ اگر آپ حذف کرنے کا لنک رکھنا چاہیں تو جواب میں delete_url بھی ہوتا ہے۔

PicGo اور PicList

PicGo اور PicList Markdown ایڈیٹرز - Typora، VS Code، Obsidian، Joplin - کے لیے پیسٹ یا ڈریگ کی گئی تصاویر اپ لوڈ کرتے ہیں اور لنک آپ کے متن میں ڈال دیتے ہیں۔ ہمارا پلگ اِن YourImageShare کو ان کے امیج ہوسٹس میں سے ایک بنا دیتا ہے۔

• PicGo یا PicList میں: Plugins، yourimageshare تلاش کریں، انسٹال کریں، پھر اپ لوڈر کے طور پر YourImageShare چنیں۔ کمانڈ لائن: picgo install yourimageshare
• یا پلگ اِن ڈاؤن لوڈ کر کے اسے مقامی پلگ اِن کے طور پر امپورٹ کریں (پہلے unzip کریں)
• سیٹنگز: صرف اپ لوڈ والی key (اختیاری - خالی = گمنام، unlisted اپ لوڈز)، visibility، اور یہ کہ براہِ راست تصویری لنک (Markdown کے لیے) واپس کرنا ہے یا صفحے کا لنک
• جو لنک یہ واپس کرتا ہے وہ بڑی تصاویر کے بعد میں WebP میں آپٹمائز ہونے پر بھی کام کرتا رہتا ہے

PicGo پلگ اِن ڈاؤن لوڈ کریں

Telegram بوٹ

Telegram چھوڑے بغیر تصویر، ویڈیو یا GIF کا لنک حاصل کریں۔ اسے @YourImageShare_bot کو بھیجیں اور لنک سیدھا واپس آ جاتا ہے - اکاؤنٹ اور API key کی ضرورت نہیں۔ بوٹ اوپر دستاویزی ہی /api اینڈ پوائنٹ کے ذریعے اپ لوڈ کرتا ہے۔

• تصویر، ویڈیو، GIF یا تصویر یا ویڈیو کی فائل بھیجیں؛ 10 تک کا البم ایک ہی جواب میں واپس آتا ہے
• گروپ میں، تصویر یا ویڈیو کے جواب میں /link لکھیں اور بوٹ اس کا لنک سب کے لیے پوسٹ کر دیتا ہے
• /autodelete آپ کے اگلے اپ لوڈز کو 1 گھنٹے، 1 دن، 1 ہفتے یا 30 دن بعد خود حذف ہونے والا بنا دیتا ہے
• ہر نتیجے میں ایک Delete بٹن ہوتا ہے جو صرف فائل اپ لوڈ کرنے والے کے لیے کام کرتا ہے
• لنکس unlisted ہوتے ہیں: فائل صرف وہی لوگ دیکھ سکتے ہیں جن کے پاس لنک ہو
• جب سائٹ آپ کے Telegram کی زبان میں دستیاب ہو تو بوٹ اسی زبان میں جواب دیتا ہے

Telegram میں @YourImageShare_bot کھولیں

Discord بوٹ

Discord میں کسی بھی تصویر، GIF یا ویڈیو کو مستقل لنک میں بدلیں۔ Discord کے اپنے اٹیچمنٹ لنکس کچھ عرصے بعد کام کرنا چھوڑ دیتے ہیں؛ YourImageShare کے لنکس نہیں چھوڑتے۔ اکاؤنٹ اور API key کی ضرورت نہیں۔ بوٹ اوپر دستاویزی ہی /api اینڈ پوائنٹ کے ذریعے اپ لوڈ کرتا ہے۔

• فائل کے ساتھ /upload: 1، 7 یا 30 دن بعد اختیاری خودکار حذف، اور only_me تاکہ لنک صرف آپ کو دکھے
• کسی میسج پر رائٹ کلک کریں → Apps → Rehost on YourImageShare تاکہ اس میں سے 6 تک تصاویر یا ویڈیوز ایک ہی جواب میں دوبارہ ہوسٹ ہوں
• اسے سرور میں شامل کریں، یا اپنے اکاؤنٹ میں تاکہ کسی بھی چیٹ یا DM میں استعمال ہو
• ہر نتیجے میں ایک Delete بٹن ہوتا ہے جو صرف فائل اپ لوڈ کرنے والے کے لیے کام کرتا ہے
• لنکس unlisted ہوتے ہیں: فائل صرف وہی لوگ دیکھ سکتے ہیں جن کے پاس لنک ہو

YourImageShare کو Discord میں شامل کریں

Playwright اور Cypress کے لیے GitHub Action

جب پل ریکویسٹ میں end-to-end ٹیسٹس ناکام ہوں تو آرٹیفیکٹ zips ڈاؤن لوڈ کیے بغیر وجہ دیکھیں۔ یہ ایکشن ناکامی کے اسکرین شاٹس اور بصری فرق اپ لوڈ کرتا ہے اور انہیں ایک پل ریکویسٹ کمنٹ میں تصاویر کے طور پر دکھاتا ہے، جو ہر رن پر اپ ڈیٹ ہوتا ہے۔

• Playwright اور Cypress دونوں کے ساتھ کام کرتا ہے، اور خود پتا لگا لیتا ہے کہ پروجیکٹ کون سا استعمال کرتا ہے
• ناکام بصری موازنے Expected، Actual اور Diff کے طور پر نظر آتے ہیں، ساتھ پہلے/بعد کے سلائیڈر کا لنک (Playwright کے toHaveScreenshot کے لیے؛ Cypress کے لیے cypress-image-diff-js اور cypress-visual-regression پلگ اِنز)
• ٹیسٹس ٹھیک ہونے پر کمنٹ "all tests passed" میں بدل جاتا ہے؛ وہی رپورٹ جاب سمری میں بھی جاتی ہے
• اسکرین شاٹس private ہوتے ہیں (صرف تصویری فائلیں، کوئی صفحہ نہیں) اور ڈیفالٹ طور پر 30 دن بعد حذف ہو جاتے ہیں
• آپ کی صرف اپ لوڈ والی key کو ریپوزٹری سیکرٹ YOURIMAGESHARE_API_KEY کے طور پر شامل کرنا ضروری ہے؛ یہ آپ کی بلڈ کبھی ناکام نہیں کرتا

- uses: yourimageshare/playwright-pr-screenshots@v1
  if: always()
  with:
    api-key: ${{ secrets.YOURIMAGESHARE_API_KEY }}

GitHub پر سیٹ اپ گائیڈ

کمیونٹی پروجیکٹس

YourImageShare کے کچھ بہترین انٹیگریشنز وہ لوگ بناتے ہیں جو اسے استعمال کرتے ہیں۔ یہ پروجیکٹس کمیونٹی کے ارکان نے اوپر دستاویزی عوامی API سے بنائے ہیں۔ انہیں ان کے مصنفین سنبھالتے ہیں، اس لیے سوالات یا بگ رپورٹس کے لیے پروجیکٹ کے صفحے کے ذریعے مصنف سے رابطہ کریں۔

• YourImageShare Uploads for FlatBB - FlatBB فورم کے لیے ایک پلگ اِن، از madromas (MadWay Inc.)۔
  • FlatBB کے پوسٹ کمپوزر میں اپ لوڈ بٹن شامل کرتا ہے: ایک یا زیادہ تصاویر یا ویڈیوز چنیں اور Markdown کرسر کی جگہ ڈال دیا جاتا ہے
  • ہر اپ لوڈ کو قابلِ کلک تھمب نیل، پورے سائز کی تصویر یا سادہ لنک کے طور پر ڈالتا ہے (ویڈیوز لنک کے طور پر)
  • اپ لوڈز آپ کے فورم کے سرور سے صرف اپ لوڈ والی API key کے ساتھ جاتے ہیں، اس لیے key وزیٹرز کے براؤزرز تک کبھی نہیں پہنچتی
  • فائلیں آپ کے فورم کی ڈسک پر نہیں بلکہ YourImageShare پر ہوسٹ ہوتی ہیں، اور ڈیفالٹ visibility آپ خود چنتے ہیں (private، unlisted یا public)
  • FlatBB کے اپنے اپ لوڈر کے ساتھ ساتھ چلتا ہے، فائل سائز کی الگ حد کے ساتھ

  GitHub پر سورس · FlatBB مارکیٹ پلیس کا صفحہ

بلاگ سے