API dokumentáció

REST API képfeltöltéshez a saját oldaladról. Az API kulcsot bejelentkezés után az API kulcsok oldalon generálhatod. Alap URL: https://www.kepfelho.hu/api/v1

POST /upload

Kép feltöltése. Multipart form-data, max 32 MB. Hitelesítés: Authorization: Bearer KF-xxxx (felhasználói kulcs) vagy KFA-xxxx (album kulcs — ekkor a kép automatikusan az albumba kerül).

Paraméter	Típus	Leírás
`image`	file	A képfájl (kötelező)
`visibility`	string	`public` vagy `private` (alap: public)
`nsfw`	boolean	Felnőtt tartalom jelölése (alap: false)
`album_id`	string	Cél album azonosítója (opcionális, csak KF- kulccsal)

curl -X POST https://www.kepfelho.hu/api/v1/upload \
  -H "Authorization: Bearer KF-xxxx" \
  -F "image=@fotom.jpg" \
  -F "visibility=private" \
  -F "nsfw=false"

GET /images/:id

Kép metaadatainak lekérése (név, méret, láthatóság, linkek).

{
  "id": "aK3x9Q",
  "url": "https://www.kepfelho.hu/i/aK3x9Q.jpg",
  "visibility": "public",
  "nsfw": false,
  "bbcode": "[img]https://www.kepfelho.hu/i/aK3x9Q.jpg[/img]"
}

DELETE /images/:id

Saját kép törlése. Csak a fiókodhoz tartozó képekre működik — vendég feltöltés API-val sem törölhető.

Korlátok

60 kérés / perc kulcsonként. Hibáknál standard HTTP státuszkódok: 401 érvénytelen kulcs, 413 túl nagy fájl, 429 túl sok kérés.