快速开始
2021-03-22 07:27:42
欢迎使用PayOtc365的API文档。从初创企业到企业业务,PayOtc365将帮助您从头到尾管理客户的体验。
在本文档中,您将找到教程和完整的API参考。
要求
在开始之前您需要先开通“商户账户”,申请开通我们会在48小时内进行审核。审核通过后您可以通过下方步骤获取APP ID 和 密钥:
- 登录账户
- 导航栏右上角”我的工作台“
- 设置中查看 APP ID和密钥
基本网址和环境
所有端点都是REST ful:
在沙箱环境,让您在不影响实时数据运行测试。
在沙箱测试完成后,确认没问题后只要把URL更改成“生产” url即可投入正式环境。
身份认证
要使用身份认证,您需要app id
和 secret
。
1.编码您的app id 和 secret
使用Base64对您的app id 和 secret进行编码,不带空格,以冒号分割。
// 例子
$ echo -n myapp_id:secret | base64
bXshJklQG5leGlvaHViLmNvbTpteXBhc3N3b2lK
2.创建授权标题
将步骤1中的值作为内容,并在前面添加字符串”Basic”
。
// 例子
Authorization: Basic bXshJklQG5leGlvaHViLmNvbTpteXBhc3N3b2lK
3.发送请求
在API请求的授权标头中包含步骤2中的字符串。
// 例子
curl -X POST https://api.payotc365.com/pay/inquire/wallet \
-H 'Accept: application/json' \
-H 'Authorization: Basic bXshJklQG5leGlvaHViLmNvbTpteXBhc3N3b2lK'
创建第一个请求
一个开始熟悉我们的API的好地方是通过向服务端发送“查询余额”请求。
如果请求成功将返回对应json信息。
通过 POST
向服务端发送请求。
示例:
curl -X POST https://api.payotc365.com/pay/inquire/wallet \
-H 'Accept: application/json' \
-H 'Authorization: Basic <Your Basic Auth>'
如果一切顺利您向获得一个状态为 200
的响应
{
"status" : "success",
"data" : {
"totalAssets" : 0.000000,
"coin" : "USDT"
}
}
当然,或许您也会得到一个状态为 412
的响应
{
"status" : "fail",
"code" : 10000,
"message" : "xxxxxxx"
}
这是一个错误的json返回,您可以根据错误 code
代码查找对应错误信息。错误代码参考表
下一步
当您成功发送第一个请求后,就可以根据您的需求进行下列工作了。