什么是Callback URL？如何为SignalHire API配置Callback URL

Callback URL（回调地址）是你提供给SignalHire服务的、属于你自己服务端的可公开访问的HTTP接口地址。
由于候选人搜索类接口处理耗时较长，接口不会实时返回最终搜索结果，你提交请求后只会收到任务提交成功的响应。当SignalHire后台处理完你的搜索任务后，会自动向你填写的回调地址发送POST请求，把完整的搜索结果推送给你，无需你反复轮询接口查询任务状态。

• 第一步：开发回调接收接口
  你需要先在自己的服务中开发一个支持接收POST请求的HTTP接口，要求该接口可以被公网正常访问（禁止使用localhost等本地地址，SignalHire的服务器无法访问你的本地环境）。接口需要支持解析JSON格式的请求体，拿到推送的搜索结果后按你的业务逻辑做后续处理即可，处理完成后返回200状态码告知平台推送成功，避免平台重复推送数据。
  本地调试阶段可以使用内网穿透工具临时生成公网地址映射到你本地的服务端口，用于测试回调逻辑。
  你可以参考下面的极简Python Flask示例实现回调接口：

from flask import Flask, request, jsonify
app = Flask(__name__)

@app.route('/signalhire-callback', methods=['POST'])
def receive_signalhire_result():
    # 拿到SignalHire推送的搜索结果
    search_result = request.get_json()
    # 这里写你自己的业务逻辑，比如存储结果到数据库
    print(search_result)
    # 返回200状态码告知推送成功
    return jsonify({"status": "success"}), 200

if __name__ == '__main__':
    app.run(port=5000)

• 第二步：填充请求参数
  把你准备好的回调接口完整地址（示例：https://你的域名/signalhire-callback）填写到你代码中headers的callbackUrl字段即可，修改后的代码示例如下：

import requests
import json

API_KEY = 'testapikey'
headers = {'apikey': API_KEY,
           'callbackUrl': 'https://你的域名/signalhire-callback'} # 替换为你自己的回调地址

data = {'items': ['https://www.linkedin.com/in/testprofile/']}
response = requests.post("https://www.signalhire.com/api/v1/candidate/search", headers=headers, json=data)

if response.status_code == 200:
    print(json.dumps(response.json(), sort_keys=True, indent=4))

内容的提问来源于stack exchange，提问作者codr