Zmena skrátených URL

Presmeruje už existujúci skrátený odkaz na inú cieľovú URL. Samotný krátky odkaz zostáva bez zmeny, takže funguje aj v správach, ktoré už sú odoslané.

API URL

Adresa URL, na ktorú sa posielajú požiadavky HTTP:

https://portal.bulkgate.com/api/1.0/shortener/change

Poznámka

Ak sa požiadavka nedostane do cieľa, zopakujte ju na záložnom serveri backup1.bulkgate.com.

Podporované HTTP metódy

POST - application/json

POST /api/1.0/shortener/change HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json

Poznámka

API má nastavenú kvótu 20 požiadaviek za minútu.

Tabuľka s parametrami

NÁZOV PARAMETRA	HODNOTA	POVINNÝ	PREDVOLENÁ HODNOTA
application_id	Identifikátor aplikácie	Áno	-
application_token	Overovací token aplikácie	Áno	-
short_url	Skrátená URL, ktorá sa má zmeniť	Áno	-
target_url	Nová URL	Áno	-

Príklad požiadavky

POST /api/1.0/shortener/change HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "short_url": "ur7.wf/K", "target_url": "www.insymbo.com" }

Odpoveď

V prípade úspechu:

{ "data": { "short_url": "http://ur7.wf/K", "target_url": "http://www.insymbo.com/", "final_url": "www.insymbo.com", "title": "Online assessment tool for employee selection - INSYMBO" } }

Polia odpovede fungujú rovnako ako pri shorten, s jedným rozdielom: final_url tu nesie adresu presne tak, ako ste ju poslali, bez doplnenia schémy.

V prípade chyby:

{ "type": "url_not_found", "code": 400, "error": "Url not found", "detail": null }

{ "type": "the_per_minute_quota_has_been_exceeded", "code": 400, "error": "The per minute quota has been exceeded", "detail": null }

Kde:

type a error (popis chyby) nájdete v tabuľke typov chýb
code je HTTP kód chyby
detail je doplňujúca informácia o chybe

Typy chýb Shortener API

Popri všeobecných typoch vracia Shortener API vlastné:

TYP	KEDY NASTANE
`url_not_found`	`short_url` v účte neexistuje.
`url_is_not_valid`	Novú `target_url` sa nepodarilo rozparsovať.
`domain_is_not_white_listed`	Nová cieľová doména nie je na whiteliste (pri doménach s obmedzením).
`the_per_minute_quota_has_been_exceeded`	Vyčerpaná kvóta 20 požiadaviek za minútu.

Bola táto stránka užitočná?

Opýtať sa AI Skopírované