Seja bem-vindo de volta à série Blocos de Construção de uma API! Já falamos sobre os primeiros passos (do ponto de vista de um dev) na exploração da sua API. Começando pelo Onboarding e passando pela Documentação, hoje falaremos sobre uma série de materiais auxiliares, mas de extrema importância para a criação de engajamento e dar um boost na criatividade e inovação gerada pelos devs com a sua API. Tratam-se de materiais educativos!

Esses materiais são um conjunto de conteúdos criados com o objetivo de divulgar todo o poder de sua API e impulsionar novos apps e ideias para o ecossistema da sua API. De modo geral, essa é uma prática mais voltada a área de Marketing, uma vez que busca criar buzz em torno da API, seja usando casos de sucesso, eventos e guias, entre outras estratégias.

Aqui no blog da Sensedia já rolou uma série sobre Como Criar um Ótimo Plano de Marketing para APIs. O post de hoje complementa essa série. Na série, supomos que você conhece (ou precisa aprofundar o seu conhecimento) sobre quem está usando sua API e adequar sua comunicação às diferentes partes interessadas.

Aqui, essa suposição também é válida, mas não é essencial, uma vez que estamos tratando dos Blocos de Construção, e passam a valer mais os formatos e modelos do que a estratégia/plano, em si. Porém, não deixe de conferir a série, seus conhecimentos ficarão bem mais completos. 😉

Quer ter todos os posts, reunidos, arrumados e organizados, para o seu conforto? Então baixe o Ebook de Blocos de Construção! Clique aqui ou na imagem abaixo:

Tudo certo com os artigos passados? Conferiu o Ebook? Então vamos começar!

Estudos de caso

Cases são um dos tipos mais convincentes de material que você pode criar. O Marketing costuma usar esse formato nas etapas finais de venda: aquela em que a pessoa já sabe que tem um problema (relacionado ao que se quer vender), mas ainda não tem certeza que precisa comprar, ou que deve comprar de determinado fornecedor. Ao ver um case, a dor do cliente do case pode se alinhar ao seu prospect e costuma ser tiro e queda.

Portanto, você viu um caso de aplicação que deu muito certo com sua API? Escreva um case, crie uma apresentação, entreviste o dev! Melhor ainda, forneça algum benefício para o dev, como a redução dos limitess de chamadas à sua API. Talvez ele crie apps ainda mais legais, o que significa mais cases para você. Só tome cuidado para não se empolgar, os cases devem ser curtos e objetivos. Você também pode usar sua Galeria de Apps (sobre a qual falaremos em um post futuro) como link para os seus cases =)
Exemplos: Youtube, Moz

Guias e tutoriais

Por natureza, devs costumam ser auto-didatas, fazendo testes e verificando as possibilidades por si mesmos. É claro que alguma ajuda é sempre bem-vinda. Guias podem estar no Codecademy ou em praticamente qualquer site de TI (como no GigaOM), mas é sempre muito interessante ter esse conteúdo educativo acessível a partir da Documentação da API. O formato pode ser qualquer um, desde texto (com exemplos, por favor), passando por vídeos e até formatos interativos.

A profundidade do assunto também pode ser uma preocupação. Normalmente os assuntos mais simples podem ser pulados — se alguém está considerando usar sua API, provavelmente não é um leigo. E se for um leigo, pode começar a brincar nos tutoriais do Codecademy ou na sua Interface web do Explorador da API (que falamos no artigo anterior).
Exemplos: MediaWiki, Stream (vale a pena se cadastrar só para ver o tutorial da API)

Webinars e vídeos

Nem todo mundo gosta de ler ou entende o que está escrito. Como comentei acima, produza conteúdo em formatos diversificados. Aqui na Sensedia, gostamos de fazer Webinars (nosso último foi o de Gerenciamento de APIs) e acabamos produzindo conteúdo relacionado no blog ou em outros canais (como iMasters e ComputerWorld) com o aprendizado dos Webinars. Então, use esse tipo de formato para diversificar a forma como ensina e também como aprende! Outra forma de divulgar seu material educativo é através do Slideshare.
Exemplos: Axosoft, Chatter

Eventos

Desenvolvedores adoram eventos. Você também deve estar bem atento aos eventos específicos da sua área. Mas por que também não participar de eventos de TI ou até criar seus próprios hackathons? Se for palestrar, melhor ainda: grave sua palestra e deixe os slides acessíveis para quem não viu ao vivo.
Exemplo: Facebook

Gostou desse artigo? Confira a parte IV: Comunicação, clicando aqui, ou na imagem abaixo: