Tilgjengelige domener

Returnerer listen over korte domener som er tilgjengelige for kontoen din. Verdiene fra denne listen er det som hører hjemme i parameteren url_type når du forkorter en lenke.

API-URL

URL som brukes til å sende HTTP-forespørslene:

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

Merk

Hvis forespørselen ikke kommer frem, gjentar du den på reserveserveren backup1.bulkgate.com.

Støttede HTTP-metoder

POST - application/json

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

Merk

API-et har en kvote på 20 forespørsler per minutt.

Parametertabell

PARAMETERNAVN	VERDI	OBLIGATORISK	STANDARDVERDI
application_id	Application ID	Ja	-
application_token	Applikasjonens autentiseringstoken	Ja	-
variant	Formen på svaret - `list`, `key_value` eller `label_value`, se Former for svaret	Nei	`list`

Former for svaret

Alle tre variantene inneholder de samme domenene og skiller seg bare i struktur - velg den som skjemaet ditt kan bruke direkte.

VERDI	FORMEN PÅ `data`
`list`	En matrise med strenger.
`key_value`	Et objekt der både nøkkelen og verdien er domenet.
`label_value`	En matrise med objekter av typen `{"label": …, "value": …}`.

Merk

Listen er ikke den samme for alle kontoer. Den inneholder også dine egne domener hvis du har noen, og de kommer først - det første domenet i listen er også det som shorten bruker når du utelater url_type.

Eksempel på forespørsel

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

Svar

Ved suksess:

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

Den samme listen i varianten key_value:

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

Og i varianten label_value:

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

Ved feil:

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

Der:

type og error (beskrivelse av feilen) finner du i tabellen over feiltyper
code er HTTP-feilkoden
detail er tilleggsinformasjon om feilen

Feiltyper i Shortener API

I tillegg til de generelle typene returnerer dette endepunktet sine egne:

TYPE	NÅR DET SKJER
`the_per_minute_quota_has_been_exceeded`	Kvoten på 20 forespørsler per minutt er brukt opp.

Var denne siden nyttig?

Spør AI Kopiert