Transferir como PDF, PPTX
![{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Pessoa",
"type": "object",
"properties": {
"id": { "type": "number", "title": "Identifier" },
"name": { "type": "string", "minLength": 3, "title":
"Person name" },
"city": {
"title": "City",
"type": "object",
"description": "Where person lives",
"properties": {
"name": { "type": "string", "title": "Name"},
"state": { "type": "string", "title": "State",
"enum": ["RJ", "SP", "GO"]}
}
},
"age": { "type": "number" }
},
"required": ["name", "city"]
}](https://image.slidesharecdn.com/previa-json-schema-170220141635/75/JSON-Schema-Valide-e-navegue-entre-suas-APIS-19-2048.jpg)
![EXEMPLO
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Pessoa",
"type": "object",
...
"links": [
{
"rel": "photos",
"href": “http://my-photo-service/by-person/{id}“
}
]
}](https://image.slidesharecdn.com/previa-json-schema-170220141635/75/JSON-Schema-Valide-e-navegue-entre-suas-APIS-25-2048.jpg)
![TEXT
EXEMPLO (MANUTENABILIDADE)
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Pessoa",
"type": "object",
...
"links": [
{
"rel": "photos",
"href": “http://my-photo-v2/photos/{id}“
},
{
"rel": "delete",
"href": "/api/person/{id}",
"method": "DELETE"
}
]
}](https://image.slidesharecdn.com/previa-json-schema-170220141635/75/JSON-Schema-Valide-e-navegue-entre-suas-APIS-26-2048.jpg)
Carregado porWilson Júnior
JSON Schema: Valide e navegue entre suas APIS
O documento discute a arquitetura de microsserviços e como JSON Schema e JSON Hyper-Schema podem ser usados para documentar APIs e validar dados. Isso ajuda a navegar entre serviços e manter a compatibilidade quando há alterações.
JSON Schema: Valide e navegue entre suas APIS
- 1. JSON SCHEMA VALIDE ENAVEGUE ENTRE SUAS APIS
- 2. WILSON JÚNIOR ENGENHEIRO DESOFTWARE NA GLOBO.COM HÁ QUASE 3 ANOS, MANTÉM PARTE DOS SERVIÇOS DE PUBLICAÇÃO DE CONTEÚDO, APAIXONADO POR MAIS DE UMA DÉCADA POR SOFTWARE E PESSOAS.
- 3.
- 4. O JEITO DEARQUITETAR SOFTWARE MUDOU …
- 5.
- 6.
- 7. CARACTERÍSTICAS DE UMMONOLITO ▸ Codebase grande ▸ Toda regra de negocio ▸ Muitas pessoas mantendo ▸ Uma stack legada ▸ Alto culto de mudança
- 8. CASE GLOBO-CORE ATGLOBO.COM ▸ 40+ pessoas ▸ git merge hell ▸ Difícil fazer deploy
- 9. PARA RESOLVER ESSEPROBLEMA OS NOVOS MAGOS JOVENS CRIARAM UMA NOVA SOLUÇÃO …
- 10.
- 11. VANTAGENS DE UTILIZARMICRO SERVIÇOS ▸ Única responsabilidade ▸ Pequenos times ▸ Rápido de escrever ▸ Stack independente ▸ Banco de dados isolado
- 12. EXEMPLO GLOBO.COM AUTENTICAÇÃO APIDE CONTEÚDOS API DE VÍDEOS API SEMÂNTICA CLIENTE RENDERIZADOR DE CONTEÚDO ADMIN SPA
- 13. COMO OS SERVIÇOSSE INTERAGEM ▸ HTTP - Restful ▸ JSON ▸ N Clients
- 14.
- 15. CONSEQUÊNCIA DE VÁRIASAPIS ▸ Muitos contratos para manter ▸ Muita documentação ▸ Validação ▸ Descobrir os endereços ▸ Lidar com breaking changes ▸ Difícil navegação
- 16.
- 17. VANTAGENS ▸ Descreve oformato dos dados ▸ limpa para leitura de máquinas e humanos ▸ Completa estrutura de validação
- 18. EXEMPLO { "id": 1000501, "name": "WilsonJúnior", "city": { "name": "Rio de Janeiro", "state": "RJ" }, "age": 24 }
- 19. { "$schema": "http://json-schema.org/draft-04/schema#", "title": "Pessoa", "type":"object", "properties": { "id": { "type": "number", "title": "Identifier" }, "name": { "type": "string", "minLength": 3, "title": "Person name" }, "city": { "title": "City", "type": "object", "description": "Where person lives", "properties": { "name": { "type": "string", "title": "Name"}, "state": { "type": "string", "title": "State", "enum": ["RJ", "SP", "GO"]} } }, "age": { "type": "number" } }, "required": ["name", "city"] }
- 20.
- 21. JÁ PODEMOS VALIDAR, OQUE MAIS FALTA …
- 22.
- 23.
- 24. ▸ Descreve asua API ▸ Descreve links ▸ Descreve formulários
- 25. EXEMPLO { "$schema": "http://json-schema.org/draft-04/schema#", "title": "Pessoa", "type":"object", ... "links": [ { "rel": "photos", "href": “http://my-photo-service/by-person/{id}“ } ] }
- 26. TEXT EXEMPLO (MANUTENABILIDADE) { "$schema": "http://json-schema.org/draft-04/schema#", "title":"Pessoa", "type": "object", ... "links": [ { "rel": "photos", "href": “http://my-photo-v2/photos/{id}“ }, { "rel": "delete", "href": "/api/person/{id}", "method": "DELETE" } ] }
- 27. COMO EU AMARROUM SCHEMA A UM RECURSO DENTRO DE UMA API RESTFUL
- 28. curl -i http://myapi.com/people/1000501 HTTP/1.1200 OK Content-Type: application/json; charset=utf-8; profile=“http://myapi.com/schemas/people” {“id”: “xpto”, …}
- 29.
- 30. VALIDAÇÕES ▸ Python: github.com/Julian/jsonschema ▸GO: github.com/xeipuuv/gojsonschema ▸ Ruby: github.com/ruby-json-schema/json-schema ▸ Javascript: geraintluff.github.io/tv4/ ▸ Mais em: json-schema.org/implementations.html
- 31. TEXT PLUCT github.com/globocom/pluct import pluct # Loada resource item = pluct.resource('http://myapi.com/people/1000501') photos = item.rel('photos', params={'q': 'Roupa bonita'})
- 32. TECNOLOGIAS ALTERNATIVAS/RELACIONADAS ▸ GRPC ▸JSON-LD ▸ GraphQL
- 33.
- 34. VENHA TRABALHAR COMA GENTE talentos.globo.com
- 35. OBRIGADO ▸ Github: wpjunior ▸Outras redes sociais: about.me/ wpjunior