PHP v2.0을 사용한 Correios API

요구사항

작곡가
PHP >= 8.2

패키지

luannsr12/sdkcorreios

이 API에는 다음 서비스가 포함됩니다.

우체국에서 제공하는 서비스
제품 배송비 계산
주문 추적
추적 코드에 포함된 약어의 의미를 반환합니다.

API 사용 방법

사용 지침은 다음과 같습니다.

 git clone https://github.com/luannsr12/api-correios/
 cd api-correios
 composer install

다운로드 및 설치 후 "config.php" 파일을 편집하고 애플리케이션의 액세스 토큰을 추가하세요. 이 액세스 토큰은 API 요청 헤더에 전달되어야 합니다.

모든 엔드포인트

주문 추적

엔드포인트: /correios/tracking/
방법: POST

파마:

curl --location --request GET '{{base_url}}/correios/tracking' 
--header 'Access-token: SEU_ACCESS_TOKEN' 
--header 'Content-Type: application/json' 
--data '{
  "objects": ["QQ588651634BR"],
  "provider": "Muambator"
}'

몸:

공급자는 선택 사항입니다. 기본적으로 검색 사이트는 Best Tracking입니다. 공급자를 보려면 SDK 설명서(Sdk Correios)를 참조하세요.

 { "객체": ["QQ588651634BR"], "공급자": "Muambator"}

응답:

 {"성공": 참,"결과": [
        {"코드": "QQ588651634BR","상태": "MOVEMENT","service_provider": "api.melhorrastreio.com.br","data": [
                {"date": "03-09-2024 07:27:10","to": "배포 장치 - MARECHAL CANDIDO RONDON/PR","from": "처리 장치 - CURITIBA/PR","location ": "처리 장치 - CURITIBA/PR","originalTitle": "개체 전송 중 - 잠시 기다려 주십시오.","details": "개체 전송 중입니다. 잠시 기다려 주세요."},
                {"date": "03-06-2024 12:25:05","to": "치료 유닛 - CASCAVEL/PR","from": "치료 유닛 - SOROCABA/SP","location": "치료 장치 - SOROCABA/SP","originalTitle": "객체 전송 중 - 잠시 기다려 주십시오.","details": "객체 전송 중 - 제발 기다리다"}
            ]
        }
    ]
}

서비스 유형

끝점: /correios/services/
방법: GET

파마:

curl --location '{{base_url}}/correios/services' 
--header 'Access-token: SEU_ACCESS_TOKEN'

응답:

 { "상태": "성공", "결과": {"PAC": "04510","SEDEX": "04014","SEDEX 12": "04782","SEDEX 10": "04790","SEDEX 오늘": "04804"
  }
}

배송비 계산

끝점: /correios/calculate/
방법: GET

주문 유형은 아래 정의를 따르세요.

상자/패키지(1);
롤러/프리즘(2);
봉투(3);

중요 사항:

Envelope인 경우에는 0을 입력하고, Envelope인 경우에는 0을 입력합니다.
봉투인 경우 무게는 1kg을 초과할 수 없습니다.
롤/프리즘인 경우 포장 직경을 알려주십시오.
Roll/Prisma인 경우 높이와 너비에 0을 입력합니다.
상자/패키지인 경우 직경에 0을 입력합니다.
"직접" 및/또는 "영수증 통지" 서비스의 경우 "Y" - 예 또는 "N" - 아니오를 입력합니다.
Declared 값은 선택 사항이며, 선언하지 않으려면 0을 입력합니다.

파마:

curl --location '{{base_url}}/correios/calculate' 
--header 'Access-token: SEU_ACCESS_TOKEN' 
--header 'Content-Type: application/json' 
--data '{
	"servico": "04510",
	"origem": "85930-000",
	"destinatario": "85960-000",
	"tipo": 1,
	"comprimento": 20,
	"altura": 20,
	"largura": 20,
	"diametro": 0,
	"peso": 0.500,
	"maoPropria": "s",
	"valorDeclarado": 150,
	"avisoRecebimento": "s"
}'

몸:

 { "서비스": "04510", "소스": "12460-000", "수신자": "37530-000", "유형": 1, "길이": 20, "높이": 20, "너비" : 20, "직경": 0, "무게": 0.500, "handOwn": "s", "declaredvalue": 150, "영수증 통지": "s"}

응답:

 ^ 29.40", "ValorMaoPropria": "7.50", "ValorAvisoRecebimento": "6.35", "ValorValorDeclarado": "2.58", "Domiciliar Delivery": "Y", "SaturdayDelivery": "N", "obsFim": [], "Error": "0", "MsgError": []
    }
  }
}

ID로 약어 가져오기

끝점: /correios/flag/
방법: GET

파마:

curl --location --request GET '{{base_url}}/correios/flag' 
--header 'Access-token: SEU_ACCESS_TOKEN' 
--header 'Content-Type: application/json' 
--data '{
    "Id": "AR"
}'

몸:

 {"ID": "AR"}

응답:

 {"성공": true,"결과": {"Id": "AR","이름": "수령 승인"}
}

모든 약어 나열

끝점: /correios/flags/
방법: GET

파마:

curl --location '{{base_url}}/correios/flags' 
--header 'Access-token: SEU_ACCESS_TOKEN'

응답:

 {"성공": true,"결과": {"AL": {"name": "대리인 읽기"},"AR": {"name": "수신 승인"},"AS": {" 이름 ": "PAC 명령 – 사회 활동"},"BE": {"name": "디지털 공기 없이 경제적 송금"},"BF": {"name": "디지털 항공 없이 빠른 배송"}
    }
}