{
  "openapi": "3.0.3",
  "info": {
    "title": "银行卡归属地查询",
    "description": "支持全国500+银行卡查询，银行卡归属地-银行卡开户行查询，支持中国银行、农行、建行、邮政、交通银行、招商银行、浦发银行、兴业银行、华夏银行、民生银行、光大银行等多家卡种。基本资料查询（银行名称、卡类型（是借记卡还是信用卡）， 没有查到归属地不扣次数。",
    "termsOfService": "https://www.showapi.com/helpcenter/view#/4019/2",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://route.showapi.com"
    }
  ],
  "paths": {
    "/30-7": {
      "x-pointCode": 7,
      "x-mode": "mapping",
      "x-read-timeout": 30,
      "x-connect-timeout": 30,
      "post": {
        "summary": "银行卡归属信息查询",
        "description": "通过银行卡号,查询银行卡的归属地,并附加返回卡号对应的地区、银行名、电话号码、网址、卡种、银联luhn和Bin码等信息.当归属地查询失败的时候,不扣费.",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "area": {
                              "type": "string",
                              "description": "地区"
                            },
                            "cardType": {
                              "type": "string",
                              "description": "银行卡种"
                            },
                            "brand": {
                              "type": "string",
                              "description": "银行卡产品名称（品牌），枚举值见文档（帮助手册），可能返回枚举值外的其他值，但概率很小"
                            },
                            "tel": {
                              "type": "string",
                              "description": "银行客服"
                            },
                            "bankName": {
                              "type": "string",
                              "description": "银行名称"
                            },
                            "url": {
                              "type": "string",
                              "description": "银行官网"
                            },
                            "ret_code": {
                              "type": "string",
                              "description": "0为成功，其他失败"
                            },
                            "simpleCode": {
                              "type": "string",
                              "description": "银行简码（该字段为银联支付网关简码，不一定有该字段返回）"
                            },
                            "formatBankName": {
                              "type": "string",
                              "description": "规范化的银行名称，部分银行为空字符串，枚举值见文档（帮助手册）"
                            },
                            "logo": {
                              "type": "string",
                              "description": "银行logo，部分银行为空字符串"
                            },
                            "card_bin": {
                              "type": "string",
                              "description": "银行卡Bin码（需要请求参数中needBin=1才有该值返回）当无法查询到该银行卡bin码时返回空字符串"
                            },
                            "bin_digits": {
                              "type": "string",
                              "description": "银行卡Bin码长度（需要请求参数中needBin=1才有该值返回）"
                            },
                            "card_digits": {
                              "type": "string",
                              "description": "银行卡卡号长度（需要请求参数中needBin=1才有该值返回）"
                            },
                            "isLuhn": {
                              "type": "string",
                              "description": "是否能通过中国银联Luhn效验，1表示可以，0表示不能，空字符串表示不支持（需要请求参数中needBin=1才有该值返回）"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "30_7_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "cardNum": {
                    "type": "string",
                    "description": "银行卡号"
                  },
                  "needBin": {
                    "type": "string",
                    "description": "是否需要返回银行卡BIN码信息和银联luhn效验。1表示需要，0表示不需要，默认不会返回这些信息，返回这些信息将使得查询更加耗时。"
                  }
                },
                "required": [
                  "cardNum"
                ]
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "AppKeyAuth": {
        "type": "apiKey",
        "in": "query",
        "name": "appKey",
        "description": "从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp"
      }
    },
    "schemas": {
      "ShowapiResEnvelope": {
        "type": "object",
        "description": "ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）",
        "properties": {
          "showapi_res_code": {
            "type": "integer",
            "description": "API 返回的状态码"
          },
          "showapi_res_error": {
            "type": "string",
            "description": "API 返回的错误信息"
          },
          "showapi_res_id": {
            "type": "string",
            "description": "API 请求的唯一标识"
          },
          "showapi_fee_num": {
            "type": "integer",
            "description": "API 调用计费次数"
          }
        }
      }
    }
  },
  "security": [
    {
      "AppKeyAuth": []
    }
  ],
  "externalDocs": {
    "url": "https://www.showapi.com/apiGateway/view/30?tab=book"
  },
  "x-apiCode": "30",
  "x-is-own": false,
  "x-is-op": true
}