loyalty php sdk 는 REST-API Bitrix24 애플리케이션 충성도 프로그램 및 Bitrix24 CRM용 보너스 카드 작업을 위한 도구입니다.
작곡가를 통해
$ composer require b24io/loyalty-php-sdk
충성도-php-sdk 버전 | 지원 상태 | 짓다 상태 | REST-API 버전 | PHP 버전 |
---|---|---|---|---|
v4.x | ? 활동적인 | 2 | 8.2 , 8.3 | |
v3.x | ? 버그수정만 | 2 | 7.4 | |
v2 | ? 인생의 끝 ☠️ | 1 | 7.4 | |
v1 | ? 인생의 끝 ☠️ | 1 | 7.4 |
loyalty php sdk PHP 8.2 이상에서 작동하며 ext-json
및 ext-curl
지원이 필요합니다.
SDK는 두 가지 역할로 작동할 수 있습니다.
admin
- 자신의 계정 및 로열티 애플리케이션 인스턴스에 있는 모든 카드로 작업할 수 있습니다.user
- 자신의 카드로만 작업 가능 우리는 많은 계정으로 작업하며 각 계정에는 CLIENT_API_KEY
가 있습니다. 관리자 역할로 작업하려면 ADMIN_API_KEY
사용하여 쿼리에 서명해야 합니다. JS에서 클라이언트 역할을 사용하려면 CLIENT_API_KEY
및 CARD_UUID
사용자 API 키로 사용해야 합니다.
전설
admin
역할로 카드 작업
방법 | 상태 | 설명 |
---|---|---|
list | ✅ | 페이지 탐색으로 카드 목록 가져오기 |
getById | ✅ | uuid로 카드 받기 |
count | ✅️ | 카드 계산 |
delete | uuid로 카드 삭제 | |
add | ✅️ | 새 카드 추가 |
block | ️ | uuid로 카드 차단 |
unblock | ️ | uuid로 카드 차단 해제 |
setLevel | ️ | uuid로 카드 레벨 설정 |
setPercentage | ️ | uuid로 카드 비율 설정 |
user
역할로 카드 사용
방법 | 상태 | 설명 |
---|---|---|
getById | ? | uuid로 카드 받기 |
모든 카드를 내보내야 하는 경우 CardsFetcher
사용할 수 있습니다.
admin
역할로 카드 수준 작업
방법 | 상태 | 설명 |
---|---|---|
list | ? | 카드 레벨 목록 가져오기 |
add | ? | 새로운 카드 레벨 추가 |
delete | ? | 카드 레벨 삭제 |
update | ️ | 카드 레벨 업데이트 |
admin
역할로 트랜잭션 작업을 수행합니다.
거래 서비스에는 메소드가 포함되어 있으며 페이지 매김을 사용한 목록 메소드 작업이 포함되어 있습니다.
방법 | 설명 |
---|---|
list | 페이지 매김이 있는 모든 카드에 대한 거래 목록을 가져옵니다. |
count | 거래 계산 |
getByCardNumber | 현재 카드 번호에 대한 거래 목록 가져오기 |
processAccrualTransactionByCardNumber | 발생 거래 처리 |
processPaymentTransactionByCardNumber | 결제 거래 처리 |
페이지 매김 없이 모든 트랜잭션을 읽으려면 TransactionsFetcher
사용하여 작업할 수 있습니다. 모든 페처 메소드는 생성기를 반환하며 후드 페처에서는 페이지 매김을 사용합니다.
방법 | 설명 |
---|---|
list | 모든 카드에 대한 거래 목록 가져오기 |
listByCardNumber | 현재 카드에 대한 모든 거래를 나열합니다. |
user
역할로 트랜잭션 작업
방법 | 상태 | 설명 |
---|---|---|
getByCardId | ? | 현재 카드에 대한 거래 목록 가져오기 |
admin
역할로 연락처 작업
방법 | 상태 | 설명 |
---|---|---|
list | ✅ | 연락처 목록 가져오기 |
getById | ✅ | 아이디로 연락받다 |
add | ✅ | 새 연락처 추가 |
update | ️ | 연락처 업데이트 |
delete | ️ | 연락처 삭제 |
count | ✅ | 연락처 수 계산 |
startAuthByPhone | ️ | 전화로 인증 시도 시작 |
finishAuth | ️ | 인증 시도 완료 |
user
역할로 연락처 작업
방법 | 상태 | 설명 |
---|---|---|
getById | ? | 아이디로 연락받다 |
startAuthByPhone | ? | 전화로 인증 시도 시작 |
finishAuth | ? | 인증 시도 완료 |
모든 연락처를 내보내야 하는 경우 ContactsFetcher
사용할 수 있습니다.
admin
역할로 회사와 협력
방법 | 상태 | 설명 |
---|---|---|
current | 현재 회사를 구하다 | |
add | ️ | 회사 추가 |
update | ️ | 회사 업데이트 |
delete | ️ | 회사 삭제 |
user
역할로 회사와 협력
방법 | 상태 | 설명 |
---|---|---|
current | ? | 현재 회사를 구하다 |
admin
역할로 애플리케이션 저널 작업
방법 | 상태 | 설명 |
---|---|---|
list | ? | 페이지 탐색을 통해 애플리케이션 저널 항목 목록 가져오기 |
getById | ? | ID별로 지원 일지 항목 가져오기 |
admin
역할로 접점 작업
방법 | 상태 | 설명 |
---|---|---|
list | ? | 페이지 탐색으로 터치 포인트 목록 가져오기 |
getById | ? | ID로 터치포인트 항목 가져오기 |
add | ? | 새로운 터치포인트 추가 |
update | ️ | 터치 포인트 업데이트 |
delete | 터치 포인트 삭제 |
REST-API를 통한 작업을 위한 명령줄 유틸리티
php bin/console
cards:export
포인트 카드를 csv 파일로 내보내기transactions:bulk-transaction
모든 활성 카드에 대한 대량 거래: 발생 또는 지불transactions:load-from-file
csv 파일에서 트랜잭션 처리transactions:export
버그 및 기능 요청은 GitHub에서 추적됩니다.
정적 분석 도구 실행
make phpstan
보안 관련 문제를 발견한 경우 [email protected]로 문의해 주세요.
MIT 라이센스(MIT). 자세한 내용은 라이센스 파일을 참조하십시오.