|
| 1 | +--- |
| 2 | +template: default |
| 3 | +title: Consumindo uma Action |
| 4 | +tableOfContents: false |
| 5 | +previousText: 'Introdução' |
| 6 | +previousUrl: '/docs/api/apihub' |
| 7 | +nextText: 'Fornecendo Informações' |
| 8 | +nextUrl: '/docs/api/apihub/fornecendo' |
| 9 | +--- |
| 10 | + |
| 11 | +# Consumindo uma Action |
| 12 | + |
| 13 | +Dada uma certa Action, antes de consumí-la, é preciso que seu App Consumidor descubra quais são os Apps Provedores disponíveis para essa Action. Após isso, é preciso que seu app requisite para cada um dos fornecedores as informações da action específica. |
| 14 | + |
| 15 | +Para descobrir os Apps Provedores da Action, basta rodar a seguinte requisição: |
| 16 | + |
| 17 | +## Descobrindo os Apps Fornecedores |
| 18 | + |
| 19 | +### Request |
| 20 | + |
| 21 | +```http |
| 22 | +GET https://api.layers.digital/v1/services/discover/{{action}} |
| 23 | +``` |
| 24 | + |
| 25 | +```headers |
| 26 | +Authorization: Bearer {{token_do_seu_app}} |
| 27 | +community-id: {{id_da_comunidade}} |
| 28 | +``` |
| 29 | + |
| 30 | +### Response |
| 31 | + |
| 32 | +```json |
| 33 | +[ |
| 34 | + { |
| 35 | + "id": "myerp", // ID do App Provedor |
| 36 | + "icon": "https://cdn.layers.digital/admin/uploads/b33178bd-75a3-4c5c-8018-f1b08c174ff2/Frame%203%20(1).png", // Logo do App Provedor |
| 37 | + "displayName": "My ERP", // Nome do App Provedor |
| 38 | + "versions": [ // Lista das versões que o App Provedor consegue responder da action específica |
| 39 | + 1 |
| 40 | + ] |
| 41 | + }, |
| 42 | + { |
| 43 | + "id": "erp-modelo", |
| 44 | + "icon": "https://cdn.layers.digital/admin/uploads/b89bb1d5-d76c-4444-990b-e8e1e699fd82/logo-erpmodelo.png", |
| 45 | + "displayName": "ERP Modelo", |
| 46 | + "versions": [ |
| 47 | + 1 |
| 48 | + ] |
| 49 | + } |
| 50 | +] |
| 51 | +``` |
| 52 | + |
| 53 | +A partir dessa resposta, precisamos, para cada App Fornecedor, requisitar seus dados referentes a action específica. |
| 54 | + |
| 55 | +## Requisitando Informações para um App Fornecedor específico |
| 56 | + |
| 57 | +### Request |
| 58 | + |
| 59 | +```http |
| 60 | +GET https://api.layers.digital/v1/services/call/{{action}}/{{id_app_fornecedor}}?version={{versao_da_action_desejada}} |
| 61 | +``` |
| 62 | + |
| 63 | +```headers |
| 64 | +Authorization: Bearer {{token_do_seu_app}} |
| 65 | +community-id: {{id_da_comunidade}} |
| 66 | +``` |
| 67 | + |
| 68 | +O corpo da mensagem varia de acordo com a action, assim como o payload de resposta. Você pode checar com detalhes nas seções logo abaixo! :) |
0 commit comments