Verifica a chave com um vídeo da conta
POST/api/video-integrations/{provider}/verify
- Auth
- Requiere token
- Quién puede:
- owner
- admin
- X-CommunityId
X-CommunityIdEnvía el X-CommunityId de la comunidad en la que ocurre la operación.
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.
Só owner e admin. A Memberfy assina uma URL do vídeo informado (que precisa ser do mesmo provedor) e pergunta uma vez ao provedor, num endereço montado por ela (nunca o do texto): aceitou → `status: valid`; recusou (401/403) → `status: invalid`, e os vídeos desse provedor passam a mostrar "vídeo indisponível" a quem assiste, com aviso à equipe, até a chave ser trocada. Vídeo que o provedor não conhece → 422 `videoNotFound`; provedor fora do ar → 502; nos dois casos o `status` fica como estava.
Parámetros
| Nombre | Dónde | Tipo | Descripción |
|---|---|---|---|
providerobligatorio | path | bunny | cloudflare |
Headers
| Nombre | Tipo | Descripción |
|---|---|---|
X-CommunityIdopcional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Cuerpo de la solicitud application/json
| Nombre | Tipo | Descripción |
|---|---|---|
videoUrlobligatorio | string | max 2048 |
Respuestas
| Código | Descripción |
|---|---|
200 | O resultado (a chave, sem o valor). |
403 | Autenticado, mas sem permissão para esta operação. |
404 | Recurso não encontrado. |
422 | O link não é um vídeo desse provedor (`videoUrlInvalid`) ou o provedor não conhece o vídeo (`videoNotFound`). |
502 | O provedor não respondeu (`providerUnreachable`). |
Ejemplo con curl
curl -X POST "https://api.memberfy.net/api/video-integrations/<provider>/verify" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{"videoUrl":"string"}'