Neste artigo eu gostaria de falar sobre a abordagem de especificação primeiro (spec-first) para o desenvolvimento de APIs REST.

Embora o desenvolvimento de API REST com código primeiro (code-first) tradicional seja assim:

  • Escrever o código
  • Habilitando-o com REST
  • Documentando-o (como uma API REST)

A especificação primeiro (spec-first) segue os mesmos passo, mas ao contrário. Começamos com uma especificação, também usando-a como documentação, geramos uma aplicação REST padrão a partir dela e, finalmente, escrevemos alguma lógica de negócios.

Isso é vantajoso porque:

  • Você sempre tem uma documentação relevante e útil para desenvolvedores externos ou front-end que desejam usar sua API REST
  • A especificação criada em OAS (Swagger) pode ser importada em uma variedade de ferramentas permitindo edição, geração de cliente, gerenciamento de API, teste de unidade e automação ou simplificação de muitas outras tarefas
  • Arquitetura de API aprimorada. Na abordagem de código primeiro (code-first), a API é desenvolvida método a método então um desenvolvedor pode facilmente perder o controle da arquitetura geral da API, no entanto, com a especificação primeiro (spec-first), o desenvolvedor é forçado a interagir com uma API a partir da posição de um consumidor de API, o que geralmente ajuda no design de uma arquitetura melhor da API.
  • Desenvolvimento mais rápido - como todo código padrão é gerado automaticamente, você não terá que escrevê-lo, tudo o que resta é desenvolver a lógica de negócios.
  • Loops de feedback mais rápidos - os consumidores podem obter uma visão da API imediatamente e podem oferecer sugestões com mais facilidade, simplesmente modificando as especificações
    Vamos desenvolver nossa API em uma abordagem de especificação primeiro!
2 0
0 1.2K
InterSystems Developer Community é uma comunidade de 23,403 desenvolvedores incríveis
Somos um local onde os programadores do InterSystems IRIS aprendem e compartilham, permanecem atualizados, crescem juntos e se divertem!

Em um mundo onde a pandemia da #COVID19 transformou as videoconferências em modelos essenciais, bagunçar projetos ficou ainda mais fácil. Mas eis que alto surge para desafiar essa bagunça. Conheça o No Project Mess by IRIS, neste divertido vídeo produzido por Henrique Gonçalves Diaspara nosso canal da Comunidade de Desenvolvedores em Português. https://lnkd.in/dTrcCUv

https://www.youtube.com/embed/IGB_3uBYV2E
[Isso é um link incorporado, mas você não pode ver conteúdo incorporado diretamente no site, porque recusou os cookies necessários para acessá-lo. Para ver o conteúdo incorporado, você precisa aceitar todos os cookies nas suas Definições de cookies]

2 0
0 102

Concurso Grand Prix da InterSystems: PARABÉNS OS VENCEDORES!
Olá a todos,

O InterSystems Grand Prix Contest acabou. Foi uma competição incrível com um número recorde de aplicativos e desenvolvedores participantes!

Obrigado a todos pela participação! E agora é hora de anunciar os vencedores!

2 0
0 136

Olá Comunidade,

Deem as boas vindas ao segundo Concurso de Criação de Artigo Técnico InterSystems! Escreva um artigo sobre qualquer tópico relacionado a tecnologia InterSystems:

🎄 Concurso de Criação de Artigo Técnico InterSystems: Edição de Natal 🎄

Duração: de 25 de Novembro a 25 de Dezembro de 2021

Prêmios para todos: Todos que publicarem um artigo na Comunidade de Desenvolvedores durante este período ganharão prêmios especiais!

Prêmios Principais: Apple AirPods Max / Oculus Quest 2 (VR Headset) / Amazon Kindle / Apple AirPods Pro / Raspberry Pi

Junte-se ao nosso novo concurso e seu conteúdo será visualizado por mais de 55K leitores mensais! Detalhes abaixo.

2 0
0 66

Olá Comunidade,

Estamos gratos em convidar todos os desenvolvedores para o Webinar de Lançamento do Concurso InterSystems Grand Prix 2022!

Nós compartilharemos os detalhes de nosso mega concurso Grand Prix Contest 2022 e explicar como você pode ganhar até US$22.000 em prêmios! Diferentemente de nossos outros concursos da Comunidade de Desenvolvedores InterSystems, este concurso permite o uso de qualquer funcionalidade de nossa plataforma de dados - IntegratedML, APIs Nativas, multi-modelo, Analytics e Processamento de Linguagem Natural (NLP), Open API e Interoperabilidade, IKO, etc - em seu projeto.

Neste webinar conversaremos sobre os tópicos esperados pelos participantes e mostraremos como desenvolver e implantar as aplicações na plataforma de dados IRIS da InterSystems.

Data & Horário: Segunda-feira, 9 de Maio – 12:00 horário de Brasília.

Palestrantes:
🗣 ​​​@Alex Woodhead, Especialista Técnico InterSystems
🗣 @Jeff Fried, Diretor de Gerenciamento de Produtos
🗣 ​​​@Dean Andrews, Responsável pelas Relações com Desenvolvedores InterSystems
🗣 @Evgeny Shvarov, Gestor do Ecossistema de Desenvolvedores InterSystems

2 0
0 50

No setor financeiro, a InterSystems é responsável por 15% do processamento de todas as ações negociadas no mundo e tem 11 dos 20 maiores bancos globais como clientes, representando mais de 7 milhões de licenças em operação. No País, a empresa que atende Banco do Brasil, Caixa Econômica e Icatu, entre outros, será uma das maiores patrocinadoras do Febraban Tech, onde vai falar sobre interoperabilidade, Smart Data Fabric e tudo o que está fazendo para ajudar o mercado. Quer saber mais?

2 0
0 88

Oi Comunidade!

Bem-vindo à 4ª edição do boletim de Notícias do InterSystems Ideias !

Aqui está o que você pode esperar dele:

  • Apoiar seus colegas de equipe com suas ideias e votos.
  • Os usuários que implementaram ideias e ganharam bônus de tecnologia para um concurso.
  • Versão escura para comunidade de desenvolvedores da InterSystems: sim ou não?
  • Idéias adicionadas recentemente.

Why Actually Working Isn't Enough to Defend Effective Education Ideas – The  74

2 0
0 83
InterSystems Oficial
· Abr. 5, 2023
IAM 3.2 Anuncio de Lançamento

Lançamento do IAM 3.2

O InterSystems API Manager (IAM) versão 3.2.1 agora está disponível para o público geral. Além das correções de bugs e pequenas melhorias, o IAM 3.2 adiciona novos plug-ins que podem ser do interesse dos clientes IRIS.

  • OAS Validation (oas-validation)
    • Valida requisições e respostas HTTP baseadas em OpenAPI 3.0 ou Especificação de API Swagger.
  • SAML (saml)
    • Fornece autenticação e autorização SAML v2.0 entre o provedor do serviço (Kong Gateway) e o provedor de identidade (IdP).
  • XML Threat Protection (xml-threat-protection)
    • Este novo plugin permite reduzir o risco de ataques XML checando a estrutura das cargas XML. Isso valida a complexidade máxima (profundidade da árvore), tamanho máximo de elementos e atributos.
  • AppDynamics (app-dynamics)
    • Integra Kong Gateway com a Plataforma AppDynamics APM.
  • JWE Decrypt (jwe-decrypt)
    • Permite descriptografar um token de entrada (JWE) em uma requisição.

2 0
0 51

Olá Desenvolvedores!

Estamos a 16 dias do início do concurso 🏆 2º Concurso de Artigos Técnicos em Português da InterSystems 🏆 e gostaria de saber o quanto vocês estão antenados aqui na comunidade e se preparando para os artigos que irão produzir.

E aí pessoal, quais assuntos vocês estão esperando encontrar nos artigos ?

Respondam aqui nos comentários! 😉

2 5
0 71
Artigo
· Nov. 10, 2023 9min de leitura
Minha primeira experiência usando o IAM

Experiência e feedback do curso on-line "Hands-On with InterSystems API Manager for Developers"

Com o meu conhecimento básico sobre o contêiner Docker e a API REST, queria tentar usar o InterSystems API Manager pela primeira vez para controlar APIs e microsserviços. Concluí esse curso online usando minha instância IRIS local como host (SO Windows) e o IAM em execução em uma VM Linux (convidado).

2 0
0 153

Olá Comunidade!

Está aberto para os membros da Comunidade de Desenvolvedores o Período de Votação do Concurso de Tutoriais, que vai de 25 de novembro a 01 de dezembro. O artigo com o maior número de curtidas irá receber o prêmio da Comunidade de Desenvolvedores: 🎁 Echo Dot - Alexa Echo Dot 5ª Geração

Aproveite os excelentes tutoriais participantes e ajude a premiar o tutorial que você mais gostar com a sua curtida.

Participe!

2 0
0 31

Os Serviços de Aprendizagem InterSystems publicaram o calendário de treinamentos em classes virtuais de Setembro! Todas as classes ocorrerão de 09:00 às 17:00 US Eastern time ao vivo, conduzida por instrutores em classes virtuais com exercícios e discussões interativas.

2 0
0 91

Olá Comunidade!

Como vocês sabem, neste ano o Global Summit está de volta em formato presencial. Nós realmente queremos ver todos lá!

Como nem todos os membros da Comunidade podem participar (inclusive eu!) pessoalmente, nós decidimos produzir um VÍDEO muito legal com as Saudações de Nossos Membros da Comunidade 🎥
Vamos nos juntar virtualmente neste grande evento que tem participação de pessoas de todo o mundo!🌏

⬆️ Envie neste desafio um VÍDEO curto (de 2 a 3 segundos) de você falando "Olá de seu país 🙌" para nossos Membros da Comunidade. Desta forma, poderemos combinar seu vídeo com outros vídeos de nossos membros e apresentá-lo no Global Summit 2022. Você também pode me enviar um link para um arquivo compartilhado em uma mensagem direta.

Prazo Final: 18 de Junho, Sexta-feira, até o final do dia!

Nos vemos lá!

2 0
0 49
Artigo
· Fev. 9, 2023 4min de leitura
iris-tripleslash - vamos detonar geral

Fala galera, beleza?

iiii lá vamos nós. Ano novo, nova competição, novo projeto, velhos motivos.

Triple Slash na área!

https://giphy.com/embed/9DcCadyT2FwSvoJJjr
[Isso é um link incorporado, mas você não pode ver conteúdo incorporado diretamente no site, porque recusou os cookies necessários para acessá-lo. Para ver o conteúdo incorporado, você precisa aceitar todos os cookies nas suas Definições de cookies]

https://giphy.com/embed/3o6nV6E62JKoPRQLcc
[Isso é um link incorporado, mas você não pode ver conteúdo incorporado diretamente no site, porque recusou os cookies necessários para acessá-lo. Para ver o conteúdo incorporado, você precisa aceitar todos os cookies nas suas Definições de cookies]

https://giphy.com/embed/zdg7ZNmbk9ZD2
[Isso é um link incorporado, mas você não pode ver conteúdo incorporado diretamente no site, porque recusou os cookies necessários para acessá-lo. Para ver o conteúdo incorporado, você precisa aceitar todos os cookies nas suas Definições de cookies]

2 0
0 54

Olá Desenvolvedores!

Aqui estão os bônus tecnológicos para o Concurso Analítico da InterSystems que irão prover pontos extras na votação:

  • InterSystems IRIS BI
  • InterSystems IRIS NLP
  • IntegratedML
  • Uso de dados reais
  • Implantação em Pacote ZPM
  • Uso de contêiner Docker

Vejam os detalhes abaixo:

2 0
0 69

Olá Desenvolvedores,

É um prazer convidá-los, a todos, para o nosso Webinar de lançamento do Concurso InterSystems Grand Prix!

O tópico deste webinar é dedicado ao nosso mega Concurso Grand Prix. Convidamos vocês a utilizarem nossos vários recursos e tecnologias como o IntegratedML, Native API, multi-modelo, analytics and NLP, Open API e Interoperabilidade e IKO.

Neste webinar falaremos sobre os os tópicos esperados dos participantes e mostraremos como desenvolver, construir e implantar suas aplicações na Plataforma de Dados InterSystems IRIS.

Data & Horário: Segunda-feira, 8 de Fevereiro — 12:00 horário de Brasília

Palestrantes:
🗣 @Evgeny Shvarov, Gerente do Ecossistema para Desenvolvedores da InterSystems

E alguns de nossos Gerentes de Produtos ... mantenha-se atento às novidades !

2 0
0 48

O evento Hospitalar Digital Journey está começando, com discussões importantes sobre a Medicina

pós-pandemia e a Transformação Digital na Saúde, entre outros temas que envolvem a comunidade e especialistas.​

Para falar sobre os benefícios da Interoperabilidade, a InterSystems convidou Antonio Valadares, gerente de TI

do Hospital Israelita Albert Einstein.

2 0
0 205