Jak získat Instagram Token pro zobrazení obrázků z feedu na webu?

Na webech s Drupalem i bez něj jsem používal povedenou knihovnu jquery.instagramFeed, případně její podobu nevyžadující jQuery. Implementace byla snadná pro vývojáře, a ještě jednodušší pro klienta, kterému web stavíte. Jediné, co musel dodat, byl název instagramového účtu.

Bohužel, kvůli změnám na Instagramu je s tím nyní konec. Pro mě to znamená opravy hned několika webů a obtěžování klientů s tím, aby dodali potřebné autorizační tokeny, případně přístupy k jejich účtům na Facebooku a Instagramu, abych mohl vytvořit potřebné.

Používáte Drupal? Já jsem měl oblíbený modul Simple Instagram Feed Block. Byl založen na zmíněné javascriptové knihovně a už nefunguje. Jako rychlou alternativu zkuste modul Instagram Lite. Neobjede se ale bez onoho tokenu.

Jak získat token pro přístup k feedu na Instagramu?

Detailní návod popisuje příručka na webu Facebook for Developers. Vývojář by to měl zvládnout. Ale protože nechci po klientech jejich přístupy k Facebooku a Instagramu, potřebuji, aby si sami zvládli založit apku a autorizovat její přístup ke svému Instagramu. Ten návod je příliš technicky složitý a příliš anglický. Pokusil jsem se jej tedy zjednodušit v češtině:

1. Půjdete na https://developers.facebook.com/, kde se přihlásíte účtem z Facebooku.
2. Kliknete nahoře na My Apps a následně na zelené tlačítko Create App.
3. Jako typ aplikace vyberte poslední možnost "Žádný", jako platformu zadáte Website a vložíte adresu svého webu.

   

4. Po uložení změn vyhledáte boxík Instagram Basic Display a kliknete na tlačítko Set Up.
5. Potvrdíte vytvoření "aplikace" a do trojice políček pro zadání URL vložíte adresu svého webu.
6. Přepnete se do části Roles > Roles, kde v části Instagram Tester přidáte/vyhledáte svůj účet na Instagramu, jehož fotky se mají na webu zobrazovat. Objeví se tam potom informace Pending.
7. Přihlásíte se v novém okně na www.instagram.com, přepnete se panáčkem na úpravu profilu a do části Apps and Websites > Tester Invites a odkliknete, že si schvalujete svoji "appku".
8. Vrátíte se zpět do administrace aplikace na Facebooku a opíšete si její App ID.
9. Nyní v prohlížeči otevřete následující adresu: https://api.instagram.com/oauth/authorize?client_id={app-id}&redirect_uri={redirect-uri} &scope=user_profile,user_media&response_type=code V ní samozřejmě nahradíte {app-id} za opsané číslo vaší aplikace. Výraz {redirect-url} nahradíte za adresu svého webu, měla by asi končit lomítkem.
10. Po odklepnutí v prohlížeči se vám objeví výzva k potvrzení a udělení přístupu na Instagram vaší appce. Po schválení se vám otevře stránka vašeho webu, v jejíž adrese bude ?code=XXXXXXX. Dlouhý kód za ?code= si poznačte, vykopírujte.
11. Jste-li schopni příkazového řádku a máte nástroj curl: Zavolejte následující příkaz, kde samozřejmě nahraďte {app-id} za App ID vaší aplikace na Facebooku, {app-secret} za příslušný údaj, který vám Facebook po kontrolním ověření hesla zobrazí vedle App ID, {redirect-uri} za adresu svého webu a {code} za ten dlouhý řetězec získaný v předchozím kroku:
    curl -X POST \
      https://api.instagram.com/oauth/access_token \
      -F client_id={app-id} \
      -F client_secret={app-secret} \
      -F grant_type=authorization_code \
      -F redirect_uri={redirect-uri} \
      -F code={code}
12. Tím získáte přístupový token a můžete se pustit do načítání fotek ze svého Instagramu. V případě modulu Instagram Lite pro Drupal stačí tento kód zadat do nastavení bloku, ve kterém mají být zobrazeny fotky.
13. Jestliže nemáte nebo neumíte použít příkazový řádek s nástrojem curl, pak zkuste do prohlížeče Chrome doinstalovat bezplatné rozšíření s názvem Talend API Tester. Adresu a příkaz pro URL v něm zadejte podle následujícího obrázku:

    

14. Po odeslání požadavku uvidíte odpověď s návratovým access tokenem pro napojení k Instagramu a identifikací uživatele. Tento token má však omezenou platnost, označuje se jako tzv. short-live token. Instagram/Facebook nabízí i token s delší, byť stále omezenou platností, a to na 60 dnů od vygenerování. Dostanete se k němu následovně:
15. Zavolejte přes curl nebo třeba výše zmíněný Talend API Tester následující adresu:
    curl -i -X GET "https://graph.instagram.com/access_token?grant_type=ig_exchange_token&client_secret={instagram-app-secret}&access_token={short-lived-access-token}"
    V ní samozřejmě nahraďte {instagram-app-secret} za App Secret z Facebooku a {short-lived-access-token} za short-live token získaný v předchozím kroku. Odpovědí dostanete token s dlouhodobou platností, long-live token.
16. Abyste se vyhnuli vypršení platnosti po 60 dnech od vygenerování long-live tokenu, je třeba jej před jeho expirací refreshovat následujícím voláním:
    curl -i -X GET "https://graph.instagram.com/refresh_access_token?grant_type=ig_refresh_token&access_token={long-lived-access-token}"
    Výraz {long-lived-access-token} samozřejmě v adrese nahraďte za skutečný dlouhodobý token, který jste získali v kroku 15. Funguje to ale jen pro veřejné účty na Instagramu, ne pro privátní.

Abych pravdu řekl, s požadavkem ke svým klientům končím u bodu 10 a zbylou část už řeším sám. Málokdo má klienta, který bude někde spouštět curl nebo se jinak dotazovat API.

Jasně, jsou tu možnosti jako zpřístupnění Facebookové appky vývojáři, kterého tam klient přidá jako dalšího administrátora. Jenže to vyžaduje, aby s klientem byli na Facebooku přátelé, což není vždy žádoucí. Navíc já chci, aby to klienti měli kompletně pod svou kontrolou a nebyli závislí na programátorovi.

Pozor. Nezapomeňte, že autorizační kód pro získání Instagram Tokenu má platnost omezenou na hodinu. Pokud po jeho získání v kroku 10 neprovedete zbytek postupu dostatečně rychle, budete muset u autorizační kód požádat znovu.

Škoda, že Facebook toto tak komplikuje a nenalezl za celou dobu přívětivější cestu, jak uživatelům feed z Instagramu zpřístupnit.

Tip: jednodušší možností je vytvoření iframe (pokud vám nevadí) pomocí služby Light widget. Umožňuje naklikat různé nastavení vzhledu a podle mých informací také upozorní na blížící se nutnost refreshe tokenu každé tři měsíce.