Vyhledávače procházejí weby nepřetržitě, 24 hodin denně 365 dní v roce. Pokud chcete odhalit a vyřešit problémy dříve, než vám způsobí škodu, potřebujete k tomu vhodné nástroje. Proto vám dnes přinášíme ContentKing API.

ContentKing sám efektivně rozhoduje o tom, kdy projít které stránky. Naše nové API jde ale ještě dál - automaticky spustí monitoring stránek, na kterých právě pracujete. Kdykoliv tedy změníte nějakou stránku, výsledek své práce uvidíte vzápětí v aplikaci.

Ano, jde o další přelomovou funkci, která spolu s ostatními zahajuje novou éru SEO auditu.

Integrace ContentKing API

Integrace je poměrně jednoduchá, ale určitě bude snazší pro někoho se zkušenostmi s podobnými procesy. Pokud máte vývojáře, kteří spolupracují na vašem webu, pošlete jim odkaz na článek zákaznické podpory o CMS API - usnadníte jim tak práci. Pokud přesto narazí na potíže, naše zákaznická podpora jim ráda pomůže.

ContentKing API – jak na integraci

Získejte svůj API token

Nejdřív musíte získat API token pro svůj účet v aplikaci ContentKing. Najdete ho zde: Účet -> Profil týmu.

API endpoint

Základní myšlenka je, že pokaždé, když uděláte na webu nějakou změnu přes redakční systém, například přidáte nebo smažete stránky, web by měl automaticky zavolat ContentKing API. Udělá to pomocí požadavku POST na následující endpoint:

POST https://api.contentkingapp.com/v1/check_url

Čtěte dál a zjistěte, co přesně je třeba odeslat.

Hlavičky API požadavků

Odeslaný požadavek musí obsahovat následující hlavičky:

Authorization: token *<place-your-API-token-here>* Content-Type: application/json

Poznámka: je třeba napsat slovo “token”, pak následuje mezera a samotní hodnota API tokenu.

Tělo API požadavku

Tělo požadavku tvoří JSON objekt a v něm kompletní adresa URL, kterou má aplikace zkontrolovat:

{ "url": "https://www.example.com/url-to-check/" }

Poznámka: nezapomeňte v požadavku uvést název domény a protokol (http nebo https).

Návratové kódy API

Po odeslání požadavku vám API vrátí jednu z následujících odpovědí:

Úspěšně zpracováno

200 OK { "status" : "ok" }

Tato odpověď znamená, že požadavek byl úspěšně zpracován a stránka bude okamžitě zkontrolována.

Chybí autorizace

401 Unauthorized { "code": "auth_missing_token", "message": "Authentication token must be passed in Authorization HTTP header.", "errors": [] }

Tato odpověď znamená, že požadavek byl přijat, ale chybí mu autorizační token, a proto nemůže být zpracován. Zkontrolujte, jestli je autorizační hlavička nastavena správně.

Autorizace selhala

401 Unauthorized { "code": "auth_failed", "message": "Authentication token is expired or invalid.", "errors": [] }

Tato odpověď říká, že požadavek nemohl být zpracován, protože odeslaný API token je neplatný nebo prošlý.

Špatná autorizace

422 Unknown Status { "code": "auth_malformed", "message": "Authorization HTTP header must conform to format described in docs.", "errors": [] }

Požadavek byl přijat, ale autorizace má špatný formát. Zkontrolujte to a nastavte správně autorizační hlavičku.

Neplatné URL

400 Bad Request { "code": "invalid_url", "message": "Invalid url format provided.", "errors": [] }

Tato odpověď říká, že jste odeslali URL ve špatném formátu. Ověřte, jestli jste odeslali kompletní URL včetně názvu domény a protokolu.

Neznámý web

400 Bad Request { "code": "unknown_website", "message": "Website isn't registered in CK account.", "errors": [] }

Pokud dostanete tuto odpověď, znamená to, že v účtu, ke kterému API token patří, se daný web nenachází.

Potřebujete s integrací API pomoct?

V případě, že vy nebo vaši vývojáři potřebujete s integrací API pomoct, neváhejte se na nás obrátit. Jsme tu pro vás.

Veronika Martošová
Veronika Martošová

Veronika je produktová manažerka ContentKingu. Vždy si ráda vyslechne naše zákazníky a jejich potřeby, pro které následně ve spolupráci s vývojářským týmem hledá ta nejlepší řešení. Užívá si, že může pracovat na pomezí designu, vývoje, marketingu a obchodu.

Získejte zkušební verzi na 14 dní zdarma

Začněte během 20 vteřin

Vložte platnou doménu, prosím (www.priklad.cz).
  • Platební karta není potřeba
  • Není třeba žádná instalace
  • Bez závazků