Quão difícil é fazer um API?

Resposta curta e concisa: depende.

p>Resposta mais longa:
Se você e eu acabamos de ter um jantar fabuloso em um restaurante muito legal. Tivemos uma ótima garrafa de vinho, e alguns pratos incríveis que incluem alguns dos ingredientes mais orgânicos E locais dos quais até os moradores de Portland teriam ciúmes. O garçom era personalizável e nos fez sentir como estrelas do rock - ele nos trouxe sobremesas grátis! Eu não sou um chef de forma alguma, mas posso dizer uma ótima comida quando a saboreio.>p>Agora - imagine no final da refeição, olho profundamente nos seus olhos com um olhar atento - e digo com uma cara séria:
"Devemos começar um restaurante assim - na verdade será tão fácil, eu peguei uma cópia do cardápio. It's já está no meu bolso. Agora, tudo o que precisamos fazer é imprimir um menu com pratos similares! Acho até que sei qual modelo de palavra eles usaram - parecia familiar"

Hopefully - you'd roll your eyes - e dizer:
"That's crazy - a nossa incrível refeição era sobre o serviço, a grande comida, a habilidade do chef e dos empregados, o ambiente na sala de jantar, os outros clientes à nossa volta e você não't know shit about cooking or running a kitchen!"

O menu é o seu API. Você está perguntando como é difícil fazer um API. Depende de vários factores e da sua abordagem.

Certo, a maioria dos menus são formatados de forma semelhante, e muitos restaurantes têm os mesmos pratos - mas os bons restaurantes sabem quais são os seus ingredientes, que equipamento de cozinha têm e os seus menus são então baseados nessas e noutras variáveis. Cada restaurante gasta um certo esforço criando o seu Menu - afinal, é de certa forma - a alma do seu negócio.

>ul>###li> Eu perguntar-me-ia - o que é que os nossos clientes querem ter no nosso API? Eu quero copiar as funções da API acima? Nós temos alguns "ingredientes secretos" que nossa API deve expor? Temos um conjunto básico de funções que você precisa ter inicialmente em nossa API?<The Difficulty of "Making" an API: Não Muito Difícil. (Talvez). Se você já tem uma plataforma, alguns clientes e desenvolvedores - criar uma API pode ser simples se planejado. Por exemplo, plataformas como o Ruby on Rails tornam muito fácil criar e expor uma API. Em alguns casos, dependendo do projeto - pode simplesmente envolver algumas linhas de código - ou pode já existir uma API privada que seus desenvolvedores usam internamente - e eles só precisam expô-la aos clientes. Outras vezes - é um trabalho doloroso, lento e tedioso que precisa ser iniciado a partir do zero.>li> A API é uma interface, assim como um menu é uma interface para os clientes encomendarem alimentos. Ela mostra o que eles podem pedir, com alguns parâmetros (bife meio mal passado, por favor!) e estabelece expectativas para mais tarde (você'estará pagando por este item no final da sua refeição). Mas um menu extravagante (ou uma API) é inútil se os itens nele contidos não são atraentes para os seus clientes, ou inclui itens de menu que podem fazê-los vomitar (alguns desenvolvedores podem reagir de forma similar às APIs SOAP).

O desenvolvedor que você trabalha com "making your API" está na melhor posição para lhe dizer o quão difícil pode ser para a sua plataforma apresentar suas funções atuais em uma API. Don'não deixe ele copiar a API de outra pessoa'a API de alguém "de estatura similar" - você'acabará com com comedores infelizes, ou seja, desenvolvedores. Eu sugiro que você procure e aprenda com outras APIs, particularmente no seu espaço. Isso o ajudará a entender o quão difícil pode ser implementar no final.

Ligamente relacionado - inicie sua API com o mínimo de recursos, construa-a iterativamente, e tenha uma boa abordagem de versão. Eu defini previamente uma API que era baseada em SOAP e descobri que a maioria dos devs querem algo baseado em ReST em vez disso.

Aqui estão alguns itens que você pode querer dar uma olhada para ter uma idéia melhor das coisas a considerar ao projetar uma API:

1. Quais são os melhores recursos (artigos, livros, exemplos) no design de APIs? Quais são algumas características de uma bela API?
2. Como desenhar uma API para uma aplicação web?
3. Quais são as melhores práticas para desenhar e lançar uma API?
4. Qual é a melhor e mais flexível API de gateway de pagamento para transações entre usuários?