Máte na korespondenčním lístku málo místa pro moc slov? Pro naši schránku to není problém!
Clipboard.cz - zkrátka texty
Clipboard.cz - API
Jak získat čistý neformátovaný text?
Přidejte za odkaz parametr ?text, tedy např. http://x0.cz/654?text
Jak použít API?
K použití programového rozhraní (API) potřebujete nejprve získat API klíč. API klíč se skládá ze dvou řetězců, nazývaných Key a Secret. K provedení některých akcí budete potřebovat i tzv. Nonce, což je jednorázový časově omezený unikátní kód, který slouží jako ochrana před vícenásobným odesíláním stejného dotazu.
Přístup k API je možný pomocí běžných HTTP požadavků GET/POST.
Jak získat klíč k API?
Použijte tento formulář:
Jak získat Nonce?
K tomu slouží metoda clipboard.cz/getnonce. Její volání vypadá takto:
HTTP GET http://www.clipboard.cz/getnonce
Volání této metody (=přístup na tuto adresu) vrátí unikátní klíč, který lze použít dalších 60 sekund. Každý takový klíč lze použít jen jednou.
Jak získat zkratku pro text?
K tomu slouží metoda clipboard.cz/get. Její volání vypadá takto:
http://www.clipboard.cz/get?key=APIKEY&nonce=NONCE&obsah=URLENCODED-TEXT&sign=SIGNATURE
Povinné parametry:
- key
- Část Key vašeho API klíče
- nonce
- Jednorázový kód Nonce
- obsah
- Text, který chcete zkrátit. Kódování UTF-8, URL-enkódováno
- sign
- Kontrolní součet tohoto požadavku. Je to SHA1 hash řetězce "SECRET:NONCE:OBSAH" (tedy Secret část API klíče, dvojtečka, Nonce řetězec, dvojtečka a text (před URL-enkódováním)).
Volitelné parametry
- texy
- Pokud přidáte &texy=1, bude text zpracován procesorem Texy!
- url
- URL stránky, odkud pochází citace (kde to má smysl)
Tuto metodu lze volat i pomocí HTTP požadavku POST. Pak může být obsah v těle požadavku POST. Parametry key, nonce a sign musí být i tak součástí URL
Ukázky použití
- Ukázka přístupu z PHP
PHP via fsocks (bez CURL)