Zum Inhalt springen

Verifica a chave com um vídeo da conta

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

Auth
Token erforderlich
Wer darf:
owner
admin
X-CommunityId
X-CommunityId Sende die X-CommunityId der Community, in der die Operation stattfindet.
Die Beschreibungen der Endpoints stammen aus der API-Spezifikation und sind vorerst auf Portugiesisch. Die Oberfläche drumherum ist übersetzt.

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.

Parameter

NameOrtTypBeschreibung
providerPflichtpathbunny | cloudflare

Header

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

Request-Body application/json

NameTypBeschreibung
videoUrlPflichtstringmax 2048

Antworten

StatusBeschreibung
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`).

curl-Beispiel

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