1. Overview
Support with the province list inquiry for registration scenario
2. API Specification
Endpoint |
|
BNC Service Code | Q5 |
3. Request
3.1. Request Header
Name | Type | M/O | Description | Sample |
|---|---|---|---|---|
Content-Type | application/json | M | Content type | application/json |
Authorization | String | M | / | Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a" |
X-TIMESTAMP | String | M | yyyy-MM-dd HH:mm:ss | 2020-12-17T10:55:00+07:00 |
X-SIGNATURE | String | M | / | 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c8625 61b19a5 |
ORIGIN | String | M | / | |
X-PARTNER-ID | String | M | / | 82150823919040624621823174737537 |
X-EXTERNAL-ID | String (36) | M | / | 41807553358950093184162180797837 |
CHANNEL-ID | String | M | / | 95221 |
3.1.1 Sample Request Header
Content-type: application/json Authorization: Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a" X-TIMESTAMP: 2020-12-17T10:55:00+07:00 X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5 ORIGIN: www.hostname.com X-PARTNER-ID: 82150823919040624621823174737537 X-EXTERNAL-ID: 41807553358950093184162180797837 CHANNEL-ID: 95221
3.2 Request Body
No parameters
3.2.1 Sample Request Body
N/A
4. Response
4.1 Response Body
Field | Type | M/O | Length | Description |
|---|---|---|---|---|
responseCode | String | M | 7 | SNAP Response code. |
responseMessage | String | M | 256 | SNAP response message |
provinceList | Object | M | ||
● provinceId | Long | M | 20 | Used for the city list inquiry. |
● ProvinceName | String | M | 64 | Name of the province. |
4.1.1 Sample Response Body
Success:
{
"provinceList":[
{
"provinceName":"Sulawesi Utara",
"provinceId":1
},
{
"provinceName":"Sulawesi Barat",
"provinceId":2
},
{
"provinceName":"Papua",
"provinceId":3
},
{
"provinceName":"Bali",
"provinceId":34
}
],
"additionalInfo":{
},
"responseMessage":"Successful",
"responseCode":"200Q500"
}
5. Reference
Field Code | Field Name | Description | |
|---|---|---|---|
| 1 | M | Mandatory | Mandatory |
| 2 | ME | Mandatory Equal | Mandatory Equal – value in the request and the response must be the same. |
| 3 | C | Conditional | Conditional |
| 4 | CE | Conditional Equal | Conditional Equal – value in the request and the response must be the same. |
| 5 | O | Optional | Optional |