미디어 제공자
/v1/settings/application/media/providers
/v1/settings/application/media/providers 엔드포인트를 사용하여 미디어 링크를 보내기 위한 미디어 제공자 리스트를 컴파일합니다.
제공자 리스트가 있으면 요청별로 사용할 제공자를 선택할 수 있으면서도 동일한 제공자 유형에 대해 서로 다른 미디어 제공자를 보유할 수 있습니다.
이 문서의 내용:
제공자 리스트 업데이트
WhatsApp Business API 클라이언트의 제공자를 구성하려면 /v1/settings/application/media/providers 엔드포인트와 제공자 정보를 사용합니다. 현재로서는 한 번에 하나의 제공자만 설정할 수 있습니다. 또한 아직까지는 기본 인증이나 전달자 토큰 인증을 적용하는 HTTP/HTTPS를 사용한 미디어 메시지를 전송할 때는 이 제공자 개체만 사용할 수 있습니다.
요청
아래의 예시는 기본 인증으로 WWW(예: HTTP/HTTPS 링크) 제공자를 추가하고 전달자 토큰 인증으로 제공자를 추가하는 방법을 보여줍니다. 현재는 이 제공자 형식만 지원됩니다.
POST /v1/settings/application/media/providers
[{
"name": "your-first-provider",
"type": "www",
"config": {
"basic": {
"username": "your-username",
"password": "your-password"
}
}
}
]
POST /v1/settings/application/media/providers
[{
"name": "your-second-provider",
"type": "www",
"config": {
"bearer": "your-bearer-token"
}
}
]
참고: 각 제공자에게 고유한 이름을 지정하세요. 이름을 다시 사용하면 이전 항목이 덮여쓰입니다.
매개변수
| 이름 | 필수 | 설명 |
|---|---|---|
| 예 | 제공자의 이름 |
| 예 | 제공자의 유형 |
| 예 |
|
응답
성공한 요청은 HTTP 상태 코드 200 OK와 null 또는 {} 중 하나를 반환합니다.
실패한 응답에는 오류 메시지가 포함됩니다. 오류에 대한 자세한 내용은 오류 및 상태 코드를 참조하세요.
제공자 리스트 조회
요청
GET /v1/settings/application/media/providers
응답
성공한 응답에는 제공자 리스트가 포함됩니다.
"settings": {
"application": {
"media": {
"providers": [
{
"name": "your-first-provider",
"type": "www",
"config": {
"basic": {
"username": "your-username",
"password": "your-password"
}
}
},
{
"name": "your-second-provider",
"type": "www",
"config": {
"bearer": "your-bearer-token"
}
}
]
}
}
}
실패한 응답에는 오류 메시지가 포함됩니다. 오류에 대한 자세한 내용은 오류 및 상태 코드를 참조하세요.
제공자 리스트 삭제
제공자의 name이 포함된 DELETE API 호출을 /v1/settings/application/media/providers 엔드포인트로 보내면 해당 제공자가 제공자 리스트에서 삭제됩니다.
요청
DELETE /v1/settings/application/media/providers/your-config-name
응답
성공한 요청은 HTTP 상태 코드 200 OK와 null 또는 {} 중 하나를 반환합니다.
실패한 응답에는 오류 메시지가 포함됩니다. 오류에 대한 자세한 내용은 오류 및 상태 코드를 참조하세요.