Dostupné domény

Vráti zoznam krátkych domén dostupných pre váš účet. Hodnoty z tohto zoznamu patria do parametra url_type pri skracovaní odkazu.

API URL

Adresa URL používaná na odosielanie HTTP požiadaviek:

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

Poznámka

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

Podporované HTTP metódy

POST - application/json

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

Poznámka

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

Tabuľka s parametrami

NÁZOV PARAMETRA	HODNOTA	POVINNÝ	PREDVOLENÁ HODNOTA
application_id	Aplikačný identifikátor	Áno	-
application_token	Aplikačný overovací token	Áno	-
variant	Tvar odpovede - `list`, `key_value` alebo `label_value`, pozrite Tvary odpovede	Nie	`list`

Tvary odpovede

Všetky tri varianty nesú tie isté domény, líšia sa len štruktúrou - vyberte si tú, ktorú priamo spracuje váš formulár.

HODNOTA	TVAR `data`
`list`	Pole reťazcov.
`key_value`	Objekt, kde kľúč aj hodnota je doména.
`label_value`	Pole objektov `{"label": …, "value": …}`.

Poznámka

Zoznam nie je pre všetky účty rovnaký. Obsahuje aj vaše vlastné domény, ak nejaké máte, a tie sú na jeho začiatku - prvá doména v zozname je zároveň tá, ktorú shorten použije, keď url_type vynecháte.

Príklad požiadavky

POST /api/1.0/shortener/domains HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "variant": "list" }

Odpoveď

V prípade úspechu:

{ "data": [ "ur7.wf", "ms6.fr", "ur7.yt", "ur7.tf", "ms6.wf", "ms6.tf", "track-message.com" ] }

Ten istý zoznam vo variante key_value:

{ "data": { "ur7.wf": "ur7.wf", "ms6.fr": "ms6.fr" } }

A vo variante label_value:

{ "data": [ {"label": "ur7.wf", "value": "ur7.wf"}, {"label": "ms6.fr", "value": "ms6.fr"} ] }

V prípade chyby:

{ "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 tento endpoint vlastné:

TYP	KEDY NASTANE
`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é