API डॉक्युमेंटेशन

API की मिळवणे

साइन इन करा, माझे खाते उघडा आणि API टॅब उघडा. तुमची की तिथे दिसेल, सोबत Regenerate बटण असेल. की पुन्हा तयार केल्यास जुनी की लगेच बंद होते, म्हणून बटण दाबण्यापूर्वी जिथे ती वापरत आहात तिथे बदल करण्याची तयारी ठेवा.

त्या टॅबमध्ये दुसरी, स्वतंत्र फक्त-अपलोड की देखील आहे - ती केव्हा वापरायची यासाठी खालील टीप आणि फोरम प्लगइन पाहा.

ऑथेंटिकेशन

तुमची की हेडर म्हणून पाठवा - हा पर्याय श्रेयस्कर आहे, कारण क्वेरी स्ट्रिंग अॅक्सेस लॉग, प्रॉक्सी लॉग आणि 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 की लागते; तुमच्या खात्यावर तसा अपलोड नसल्यास 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 की लागते; तुमच्या खात्यावर तसा अपलोड नसल्यास 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} येथे स्लायडर असलेले पेज, जे कोणत्याही वेबसाइटवर एम्बेडही करता येते. फक्त-अपलोड की देखील चालते. 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 कीला स्वतंत्र प्रति-मिनिट आणि प्रति-दिवस मर्यादा आहेत, तसेच एकच IP अनेक की फिरवू नये म्हणून प्रति-IP दैनिक कमाल मर्यादा आहे. अपलोड, यादी आणि हटवणे यांची मर्यादा एकच आहे.

या मर्यादा बदलू शकतात. प्रत्येक प्रतिसादात मानक रेट-लिमिट हेडर असतात:

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

मर्यादा ओलांडल्यावर 429 येते, सोबत Retry-After हेडर किती सेकंद थांबायचे ते सांगतो.

त्रुटी

एंडपॉइंट किंवा कारण काहीही असो, प्रत्येक त्रुटी प्रतिसादाची रचना सारखीच असते:

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

क्लायंट लायब्ररी

वरील एंडपॉइंट गुंडाळणारे अधिकृत SDK, जे टाइप केलेले निकाल देतात आणि कच्चे 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} टॅग केलेले टपल परत देते - इतर सर्व SDK मधील या API च्या त्रुटी हाताळणीचे थेट समतुल्य - तसेच एरर देणारे bang प्रकारही. सोर्स GitHub वर, डॉक्स HexDocs वर.

{:yourimageshare, "~> 1.1"}

MCP सर्व्हर

AI कोडिंग एजंटसाठी (Claude Code, Cursor आणि इतर MCP-सुसंगत टूल्स) - बग रिपोर्ट, PR वर्णन किंवा सपोर्ट थ्रेडमध्ये स्क्रीनशॉट base64 ब्लॉब किंवा मॅन्युअल अपलोडऐवजी खऱ्या URL म्हणून पेस्ट करा. Claude Desktop आणि इतर कोणत्याही MCP क्लायंटसोबत तसेच चालते.

होस्टेड, काही इन्स्टॉल करायचे नाही: रिमोट MCP सर्व्हर म्हणून जोडा (Claude मध्ये: Settings › Connectors › Add custom connector; तसेच ChatGPT, Cursor, VS Code आणि सर्व्हर URL घेणारे इतर क्लायंट) आणि URL मध्ये तुमची API की द्या:

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

हेडर सेट करू देणारे क्लायंट त्याऐवजी https://yourimageshare.com/mcp आणि Authorization: Bearer YOUR_API_KEY वापरू शकतात. तुमची की असलेला URL पासवर्डसारखा काम करतो: तो खाजगी ठेवा, आणि लीक झाल्यास माझे खाते मधून नवीन की मिळवा. होस्टेड सर्व्हरवर upload_image सार्वजनिक लिंक (200MB पर्यंत) किंवा इनलाइन base64 सामग्री (15MB पर्यंत) घेतो. की नसतानाही https://yourimageshare.com/mcp वेबसाइटप्रमाणे अनामिकपणे अपलोड करतो: फक्त unlisted किंवा private, कमी मर्यादा, आणि अपलोड त्याने परत दिलेल्या delete_url ने हटवला जातो. इतर टूल्सना की लागते.

लोकल: npx ने थेट चालवा, इन्स्टॉल पायरी नाही (ते तुमच्या डिस्कवरील फाइलही वाचू शकते):

npx yourimageshare-mcp

टूल्स: upload_image (लोकल फाइल, इनलाइन सामग्री किंवा लिंक, 200MB पर्यंत, पर्यायी visibility, शीर्षक आणि ऑटो-डिलीटसह), list_uploads, get_upload, update_upload आणि delete_upload.

तसेच अधिकृत MCP Registry मध्ये (io.github.yourimageshare/yourimageshare म्हणून) आणि Smithery व Glama वर सूचीबद्ध, तुमचा MCP क्लायंट त्यापैकी एकातून इन्स्टॉल करत असल्यास.

MCP नवीन आहे? Claude आणि ChatGPT या API शी MCP द्वारे जोडण्याच्या संपूर्ण मार्गदर्शनासाठी MCP सह Claude आणि ChatGPT कसे जोडायचे पाहा.

कोड उदाहरणे

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 की जोडा आणि त्यानंतर प्रत्येक प्रकाशनातून लगेच शेअर करण्यायोग्य लिंक मिळते. डेस्कटॉप 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 तुमच्या खऱ्या कीने बदला. ते तुमचे इमेज/फाइल डेस्टिनेशन म्हणून सेट करा आणि कॅप्चर आपोआप अपलोड होतात.

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"

फोरम प्लगइन

तुमच्या फोरमच्या पोस्ट एडिटरशेजारी खरे "Upload Image" बटण जोडा. प्रत्येक प्लगइन वर दिलेल्याच /api एंडपॉइंटद्वारे अपलोड करतो आणि कर्सरच्या जागी BBCode घालतो - वेगळा टॅब नाही, मॅन्युअल कॉपी-पेस्ट नाही.

फोरम अपलोड डीफॉल्टनुसार private असतात: इमेज पोस्टमध्ये चालते, पण YourImageShare तिला स्वतःचे पेज देत नाही (कमेंट, रिअॅक्शन किंवा जाहिराती नाहीत). लिंक असलेल्या कोणालाही पेज हवे असल्यास प्रत्येक प्लगइनमध्ये unlisted वर बदलण्याची सेटिंग आहे.

phpBB

खरा phpBB 3.2/3.3 एक्स्टेन्शन. ext/ मध्ये अनझिप करा, Customise > Manage extensions मध्ये सुरू करा, मग एक्स्टेन्शनच्या टेम्पलेट इव्हेंट फाइलमधील YOUR_UPLOAD_ONLY_KEY तुमच्या खऱ्या फक्त-अपलोड कीने बदला.

phpBB साठी डाउनलोड करा

SMF (Simple Machines Forum)

खरे SMF पॅकेज - Admin > Package Manager मधून इन्स्टॉल करा, मग Sources/yis_forumupload.php मधील YOUR_UPLOAD_ONLY_KEY तुमच्या खऱ्या फक्त-अपलोड कीने बदला.

SMF साठी डाउनलोड करा

MyBB

खरा MyBB 1.8 प्लगइन. inc/plugins/ मध्ये कॉपी करा, Configuration > Plugins मध्ये सक्रिय करा, मग प्लगइन फाइलमधील YOUR_UPLOAD_ONLY_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 करा.

कोणत्याही वेबसाइटसाठी अपलोड बटण

कोणत्याही साइटवर - कमेंट फॉर्म, सपोर्ट पेज, आमच्याकडे प्लगइन नसलेला फोरम, स्टॅटिक साइट - तुमच्या अभ्यागतांना "Upload" बटण द्या. दोन ओळी पेस्ट करा; खाते आणि सर्व्हर कोडची गरज नाही.

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

दोन्ही अॅट्रिब्यूट पर्यायी आहेत: त्यांशिवाय बटण Copy बटणासह लिंक दाखवते. अपलोड बॉक्स त्या लिंकभोवती तयार होतो.

• अपलोड थेट तुमच्या पेजवर होतात: बटणावर क्लिक करा, त्यावर फाइल ड्रॉप करा किंवा स्क्रीनशॉट पेस्ट करा - एकाच वेळी अनेक फाइल, प्रोग्रेस बार आणि थंबनेलसह
• data-target मध्ये नाव दिलेल्या फील्डमध्ये (कोणताही textarea, input किंवा एडिट करता येणारा बॉक्स) थेट पेस्ट किंवा ड्रॉप केलेल्या इमेजही अपलोड होतात, आणि लिंक त्या फील्डमध्ये जोडल्या जातात; टार्गेट नसल्यास त्या बटणाखाली Copy बटणासह दिसतात
• data-format: url (थेट फाइल लिंक, डीफॉल्ट), page, bbcode, html किंवा markdown; data-label बटणाचा मजकूर बदलते
• data-key (पर्यायी): तुमची फक्त-अपलोड की (माझे खाते > API). मग अपलोड तुमच्या स्वतःच्या मर्यादांसह तुमच्या खात्यात जातात. की नसल्यास अपलोड अनामिक व 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") जोडा.

की नसल्यास अपलोड अनामिक व unlisted असतात, दैनिक मर्यादेसह. तुमच्या खात्यात अपलोड करण्यासाठी तुमच्या फक्त-अपलोड कीसह (माझे खाते > 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
• किंवा प्लगइन डाउनलोड करून लोकल प्लगइन म्हणून इम्पोर्ट करा (आधी अनझिप करा)
• सेटिंग्ज: फक्त-अपलोड की (पर्यायी - रिकामी = अनामिक, unlisted अपलोड), visibility, आणि थेट इमेज लिंक (Markdown साठी) परत द्यायची की पेज लिंक
• मोठ्या इमेज नंतर WebP मध्ये ऑप्टिमाइझ झाल्या तरी ती परत दिलेली लिंक चालत राहते

PicGo प्लगइन डाउनलोड करा

Telegram बॉट

Telegram सोडल्याशिवाय फोटो, व्हिडिओ किंवा GIF ची लिंक मिळवा. ती @YourImageShare_bot ला पाठवा आणि लिंक लगेच परत येते - खाते आणि API की नको. बॉट वर दिलेल्याच /api एंडपॉइंटद्वारे अपलोड करतो.

• फोटो, व्हिडिओ, GIF किंवा इमेज अथवा व्हिडिओ फाइल पाठवा; 10 पर्यंतचा अल्बम एकाच उत्तरात परत येतो
• ग्रुपमध्ये फोटो किंवा व्हिडिओला /link असे उत्तर द्या आणि बॉट सर्वांसाठी त्याची लिंक पोस्ट करतो
• /autodelete तुमचे पुढील अपलोड 1 तास, 1 दिवस, 1 आठवडा किंवा 30 दिवसांनी स्वतः हटवते
• प्रत्येक निकालात Delete बटण असते जे फक्त फाइल अपलोड करणाऱ्या व्यक्तीसाठी चालते
• लिंक unlisted आहेत: लिंक असलेल्या लोकांनाच फाइल दिसते
• साइट तुमच्या Telegram भाषेत उपलब्ध असल्यास बॉट त्याच भाषेत उत्तर देतो

Telegram मध्ये @YourImageShare_bot उघडा

Discord बॉट

Discord मधील कोणतीही इमेज, GIF किंवा व्हिडिओ कायमच्या लिंकमध्ये बदला. Discord च्या स्वतःच्या अटॅचमेंट लिंक काही काळानंतर चालत नाहीत; YourImageShare लिंक चालतात. खाते आणि API की नको. बॉट वर दिलेल्याच /api एंडपॉइंटद्वारे अपलोड करतो.

• फाइलसह /upload: 1, 7 किंवा 30 दिवसांनी पर्यायी ऑटो-डिलीट, आणि लिंक फक्त तुम्हालाच दाखवण्यासाठी only_me
• मेसेजवर राइट-क्लिक करा → Apps → Rehost on YourImageShare, त्यातील 6 पर्यंत इमेज किंवा व्हिडिओ एकाच उत्तरात पुन्हा होस्ट करण्यासाठी
• सर्व्हरवर जोडा, किंवा कोणत्याही चॅट वा DM मध्ये वापरण्यासाठी तुमच्या स्वतःच्या खात्यात जोडा
• प्रत्येक निकालात Delete बटण असते जे फक्त फाइल अपलोड करणाऱ्या व्यक्तीसाठी चालते
• लिंक unlisted आहेत: लिंक असलेल्या लोकांनाच फाइल दिसते

YourImageShare Discord मध्ये जोडा

Playwright & Cypress साठी GitHub Action

पुल रिक्वेस्टमध्ये end-to-end टेस्ट अयशस्वी झाल्यास, आर्टिफॅक्ट zip डाउनलोड न करता कारण पाहा. ही action अयशस्वी स्क्रीनशॉट आणि व्हिज्युअल डिफ अपलोड करते आणि पुल रिक्वेस्टच्या एका कमेंटमध्ये इमेज म्हणून दाखवते, जी प्रत्येक रन नंतर अद्ययावत होते.

• Playwright आणि Cypress दोन्हीसोबत चालते, आणि प्रोजेक्ट कोणते वापरतो ते स्वतःच ओळखते
• अयशस्वी व्हिज्युअल तुलना Expected, Actual आणि Diff म्हणून दिसतात, आधी/नंतर स्लायडरच्या लिंकसह (Playwright चे toHaveScreenshot; Cypress साठी cypress-image-diff-js आणि cypress-visual-regression प्लगइन)
• टेस्ट दुरुस्त झाल्यावर कमेंट "all tests passed" मध्ये बदलते; तोच रिपोर्ट जॉब सारांशातही जातो
• स्क्रीनशॉट private आहेत (फक्त इमेज फाइल, पेज नाही) आणि डीफॉल्टनुसार 30 दिवसांनी हटवले जातात
• तुमची फक्त-अपलोड की रेपॉझिटरी सीक्रेट 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 कीसह जातात, त्यामुळे की अभ्यागतांच्या ब्राउझरपर्यंत कधीच पोहोचत नाही
  • फाइल तुमच्या फोरमच्या डिस्कवर नव्हे, YourImageShare वर होस्ट होतात, तुम्ही निवडलेल्या डीफॉल्ट visibility सह (private, unlisted किंवा public)
  • FlatBB च्या स्वतःच्या अपलोडरसोबत चालते, वेगळ्या फाइल आकार मर्यादेसह

  GitHub वर सोर्स · FlatBB Marketplace पेज

ब्लॉगवरून