(Versão em português do post aqui)
Evernote е доста популярна и страхотна компания. Те имат различни продукти, но основният им, който има същото име като компанията, е супер надеждно приложение за водене на бележки. Той има за цел да бъде вашият втори мозък и да ви помогне да организирате личния си живот с неговите мощни функции.
Едно страхотно нещо, което имат, е публичен API, който ви позволява да създавате свои собствени приложения върху тяхната инфраструктура. В този урок ще разгледаме как да започнете с SDK на Evernote за JavaScript с помощта на примерно експресно приложение и azk.
Грабнете идентификационните данни на Sandbox на Evernote
Преди да започнем да разработваме с API на Evernote, първо трябва да регистрираме акаунт в Sandbox. По този начин можем да тестваме всякакви извиквания на API, без да се притесняваме за промяна или изтриване на лична или потребителска информация. Преминете към уебсайта на пясъчника на Evernote и създайте акаунт:
След като се регистрирате, продължете и създайте нов бележник, за да можем да видим това по-късно, когато стартираме нашето примерно приложение.
След това нека вземем нашите API ключове, за да можем да взаимодействаме с SDK. Преминете към документацията на Evernote:
В горния десен ъгъл щракнете върху „Вземете API ключ“. Попълнете формуляра, за да получите вашите ключове, моят изглежда така:
Щракнете върху „Заявка за ключ“ и запазете своя потребителски ключ и потребителска тайна информация.
Инсталирайте azk
azk е инструмент с отворен код, който ви позволява да организирате среди за разработка във вашата собствена машина с помощта на Docker. Това означава, че ще можете да стартирате този пример, дори ако нямате инсталиран възел на вашата машина, и няма да се притеснявате, че ще объркате локалната си среда. Първо, нека инсталираме azk. Ако използвате Mac:
# Install homebrew $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" # Install brew cask $ brew install caskroom/cask/brew-cask # Install VirtualBox $ brew cask install virtualbox # Install azk $ curl -Ls http://azk.io/install.sh | bash # Run azk agent $ azk agent start # After you run the command above, azk is going to ask you to enter the VM IP. When that happens, just press Enter to use the default value.
(За по-подробни инструкции или ако използвате Linux, отидете на тази връзка)
Сега нека вземем примерното приложение на Evernote в GitHub. Можете да го намерите заедно с техния SDK:
# Grab Evernote's JavaScript SDK repository $ git clone https://github.com/heitortsergent/evernote-sdk-js.git # Go to the sample app folder $ cd evernote-sdk-js/sample/express
Помните ли нашите API ключове, които създадохме няколко стъпки назад? Сега е моментът да ги използвате. Вече има примерен конфигурационен файл за тях, така че стартирайте:
$ cp .env.sample .env
Отворете файла .env и актуализирайте променливите „API_CONSUMER_KEY“ и „API_CONSUMER_SECRET“ с вашите собствени ключове.
Сега се върнете към вашия терминал и стартирайте:
$ azk start
Това, което ще се случи сега, е, че azk ще анализира Azkfile.js, ще изтегли необходимите изображения, за да изпълни нашия контейнер (в този случай възел), ще стартира контейнер и ще изпълни нашето приложение вътре в него. Когато приключи, трябва да видите изход, подобен на този:
Отворете URL адреса под Име на хост/url и трябва да видите това:
Щракването върху Щракнете тук ще ви отведе до страницата за оторизация на Evernote, показваща името на приложението, което сте регистрирали, когато сте получили API ключовете. Използвайте идентификационните си данни от акаунта на Evernote Sandbox, щракнете върху Упълномощаване и сега трябва да се върнете в главната страница на приложението, показваща информация за вашите бележници и идентификационни данни за токени. ☺
Това е само началото и сега имате работещо приложение за възел, което може да упълномощи влизане с Evernote и да направи обаждане, за да покаже имената на вашите бележници. Ако искате да се задълбочите, вижте документацията на Evernote или Evernote App Center за идеи за неща, които можете да изградите с него!
Освен това, ако искате да разширите примерното приложение, имайте предвид, че докато правите промени в него, ще трябва да направите:
# If your app is already running $ azk restart # If your app was stopped $ azk start
Можете също така да имате достъп до регистрационните файлове на вашите приложения, като стартирате:
$ azk logs
Приятно хакване! ☺
