Troca o endpoint de um aparelho (service worker, sem login)
POST/api/push/subscriptions/renew
- Auth
- Public
- Clé d’API:
- Clé d’API non acceptée
Les descriptions des endpoints viennent directement de la spécification de l’API et sont en portugais pour l’instant. L’interface autour est traduite.
Para o `pushsubscriptionchange` do service worker, que não tem token: troca o endpoint e as chaves de uma inscrição existente, provada pelo endpoint antigo e pelo `auth` antigo dela. Qualquer outra coisa (endpoint desconhecido, removido ou `auth` errado) dá o mesmo 404. O endpoint novo precisa ser de um serviço de push de navegador (Google, Mozilla, Apple, Microsoft). Não usa `X-CommunityId`. Limite de 30 trocas por hora por IP (429).
Corps de la requête application/json
| Nom | Type | Description |
|---|---|---|
oldEndpointobligatoire | string | |
oldAuthobligatoire | string | |
endpointobligatoire | string | |
keysobligatoire | object | |
keys.p256dhfacultatif | string | |
keys.authfacultatif | string | |
vapidKeyIdfacultatif | string |
Réponses
| Statut | Description |
|---|---|
200 | Inscrição atualizada. |
400 | Requisição inválida — falha de validação. |
404 | Recurso não encontrado. |
409 | Conflito com o estado atual do recurso. |
429 | Mais de 30 trocas por hora a partir do mesmo IP. O cabeçalho `Retry-After` diz em quantos segundos tentar de novo. |
500 | Erro interno do servidor. |
Exemple curl
curl -X POST "https://api.memberfy.net/api/push/subscriptions/renew" \
-H "Content-Type: application/json" \
-d '{"oldEndpoint":"string","oldAuth":"string","endpoint":"string","keys":{}}'