Aller au contenu

Verifica a chave com um vídeo da conta

POST/api/video-integrations/{provider}/verify

Auth
Jeton requis
Qui peut l’appeler:
owner
admin
Clé d’API:
Clé d’API non acceptée
X-CommunityId
X-CommunityId Envoyez le X-CommunityId de la communauté où l’opération a lieu.
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.

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.

Paramètres

NomEmplacementTypeDescription
providerobligatoirepathbunny | cloudflare

En-têtes

NomTypeDescription
X-CommunityIdfacultatifstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Corps de la requête application/json

NomTypeDescription
videoUrlobligatoirestringmax 2048

Réponses

StatutDescription
200O resultado (a chave, sem o valor).
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
422O link não é um vídeo desse provedor (`videoUrlInvalid`) ou o provedor não conhece o vídeo (`videoNotFound`).
502O provedor não respondeu (`providerUnreachable`).

Exemple 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"}'