Histórico da Página
...
Índice | ||
---|---|---|
|
Introdução
...
API é um conjunto de rotinas e padrões de programação para acesso a um aplicativo de software ou plataforma baseado na Web. A sigla API refere-se ao termo em inglês "Application Programming Interface" que significa em tradução para o português "Interface de Programação de Aplicativos".
Uma API é criada quando uma empresa de software tem a intenção de que outros criadores de software desenvolvam produtos associados ao seu serviço. Existem vários deles que disponibilizam seus códigos e instruções para serem usados em outros sites da maneira mais conveniente para seus usuários.
...
Os sistemas operacionais também possuem suas APIs com as mesmas funções descritas acima. Por exemplo, o Windows possui APIs como a Telephony API, Win16 API e Win32 API. Quando um usuário executa um programa que envolva algum processo do sistema operacional, é bem provável que o Windows faça uma conexão entre o software e alguma de suas APIs.
Objetivo
...
O objetivo desse documento é apresentar os principais métodos e endpoints da API de Usuários, necessários para ver as informações, incluir, excluir ou editar um usuário no RM.
1 - Padrões
...
Na API de Usuário é utilizado dois padrões:
- Guia de API Totvs
- SCIM
1.1 - Guia de API Totvs
...
Este guia define os padrões que devem ser adotados durante a implementação de novas APIs publicas ou privadas na plataforma TOTVS incluindo:
...
Mais em "Guia de implementacao das APIs TOTVS"
1.2 - SCIM
...
O SCIM (System for Cross-domain Identity Management ou Sistema de Gerenciamento de Identidade de Domínio Cruzado) é um padrão aberto para automatizar a troca de informações de identidade do usuário entre domínios de identidade e aplicações.
2 - Métodos
...
Na API de Usuários estão expostos os métodos:
- GET
- POST
- PUT
- DELETE
Especificações
Especificações | Título | Comentário |
---|---|---|
RFC 7231, sessão 4: Request methods | Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content | Especifica os métodos GET, HEAD, POST, PUT, DELETE, CONNECT, OPTIONS, TRACE. |
RFC 5789, sessão 2: Patch method | PATCH Method for HTTP | Especifica o método PATCH. |
2.1 - GET
...
O Método GET solicita a representação de um recurso específico. Requisições utilizando o Método GET devem retornar apenas dados.HEAD O Método HEAD solicita uma resposta de forma idêntica ao método GET, porém sem conter o recurso "body"(corpo).
2.2 - POST
...
O Método POST é utilizado para submeter uma entidade a um recurso específico, às vezes causando uma mudança no estado do recurso ou solicitando alterações ao servidor.
2.3 - PUT
...
O Método PUT substitui todas as atuais representações de seu recurso alvo pela carga de dados da requisição.
2.4 - DELETE
...
O Método DELETE remove um recurso específico.
...