Remover sub-key
curl --request DELETE \
--url https://api.malga.io/v1/auth/{id} \
--header 'X-Api-Key: <api-key>' \
--header 'X-Client-Id: <api-key>'const options = {
method: 'DELETE',
headers: {'X-Client-Id': '<api-key>', 'X-Api-Key': '<api-key>'}
};
fetch('https://api.malga.io/v1/auth/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.malga.io/v1/auth/{id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("X-Client-Id", "<api-key>")
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"error": {
"type": "api_error",
"code": 123,
"declinedCode": "<string>",
"key": "<string>",
"businessCode": "<string>",
"message": "<string>",
"details": "<array>"
}
}Sub-keys
Remover sub-key
Remova uma sub-key antes do fim da validade para fazer uma rotação manual ou bloquear uma sub-key exposta.
DELETE
/
v1
/
auth
/
{id}
Remover sub-key
curl --request DELETE \
--url https://api.malga.io/v1/auth/{id} \
--header 'X-Api-Key: <api-key>' \
--header 'X-Client-Id: <api-key>'const options = {
method: 'DELETE',
headers: {'X-Client-Id': '<api-key>', 'X-Api-Key': '<api-key>'}
};
fetch('https://api.malga.io/v1/auth/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.malga.io/v1/auth/{id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("X-Client-Id", "<api-key>")
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"error": {
"type": "api_error",
"code": 123,
"declinedCode": "<string>",
"key": "<string>",
"businessCode": "<string>",
"message": "<string>",
"details": "<array>"
}
}Toda sub-key expira sozinha quando termina o tempo definido no campo
A resposta de sucesso é
Veja também Gestão de chaves.
expires, na criação. Você também pode remover uma sub-key antes desse prazo, por exemplo para:
- fazer uma rotação manual: crie uma sub-key nova, atualize a aplicação e remova a anterior;
- bloquear uma sub-key que foi exposta ou que uma aplicação não usa mais;
- invalidar uma sub-key criada com
expiresigual a0, que não expira sozinha.
403. As outras sub-keys e a chave secreta da sua conta continuam funcionando.
Pré-requisitos
- O
publicKeyda sub-key, retornado na criação. Ele é oidda rota. - A chave secreta da sua conta, ou outra chave com o escopo
*ouauth. Faça a chamada no seu servidor.
Exemplo de remoção
curl --location --request DELETE 'https://api.malga.io/v1/auth/YOUR_PUBLIC_KEY' \
--header 'X-Client-Id: YOUR_CLIENT_ID' \
--header 'X-Api-Key: YOUR_API_KEY'
200, sem corpo.
Rotação manual
1
Crie uma sub-key nova
Chame
POST /v1/auth com os mesmos escopos da sub-key atual.2
Atualize a aplicação
Troque a sub-key antiga pela nova na aplicação e confirme que as chamadas funcionam.
3
Remova a sub-key antiga
Chame
DELETE /v1/auth/{id} com o publicKey da sub-key antiga.Erros comuns
| HTTP code | Quando acontece | O que fazer |
|---|---|---|
403 | A chave usada na chamada não existe, não pertence ao X-Client-Id ou não tem o escopo * ou auth | Faça a chamada com a chave secreta da sua conta |
Was this page helpful?