API
오디언스로 연락처 가져오기
오디언스 페이지의 CSV 가져오기를 API로 수행합니다. 형식이 올바른 주소는 아직 연락처가 아니면 연락처가 되고, 모두 이 오디언스에 들어가며, 호출당 최대 500행입니다. 더 긴 목록은 여러 번에 나눠 보내세요.
POSTapi.openemail.uk/audiences/{id}/import
본인 키로 워크스페이스에 실제 호출을 실행합니다.
POST /audiences/{id}/import
오디언스 페이지의 CSV 가져오기를 API로 수행합니다. 형식이 올바른 주소는 아직 연락처가 아니면 연락처가 되고, 모두 이 오디언스에 들어가며, 호출당 최대 500행입니다. 더 긴 목록은 여러 번에 나눠 보내세요.
예시
연락처를 만들기 때문에 audiences:write와 contacts:write가 필요합니다. 각 행은 email과 최대 200자의 선택적 name입니다.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/import" -H "$AUTH" -H 'content-type: application/json' -d '{ "contacts": [ { "email": "[email protected]", "name": "Grace Hopper" }, { "email": "[email protected]", "name": "Katherine Johnson" }, { "email": "not-an-address" } ]}'{ "object": "audience_import", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "created": 1, "added": 1, "skipped": 1, "invalid": ["not-an-address"]}created는 새 연락처를, added는 이 오디언스의 새 멤버십을, skipped는 가져오지 않은 행을 셉니다. invalid는 형식이 잘못된 주소를 보낸 그대로 나열합니다. 새 연락처는 manual로 저장되고 기본 오디언스에도 들어갑니다.
이미 연락처인 주소는 다시 쓰이고 절대 중복되지 않으며 이름도 그대로 유지됩니다. 여기의 name은 비어 있는 이름만 채웁니다. 주소록에서 삭제된 주소는 다시 연락처가 되고, 한 호출에 같은 주소가 두 번 있으면 한 번으로 셉니다.
다시 실행해도 안전합니다. 같은 호출을 두 번째로 보내면 아무것도 만들지 않고 아무것도 추가하지 않습니다. 누구에게도 아무것도 보내지 않고, 누구도 무엇에도 구독되지 않습니다.