草庐IT

支付宝小程序跳转第三方H5页面

stupid_muscleman 2023-04-18 原文

支付宝小程序跳转第三方H5页面

基础API跳转

web-view

支付宝小程序想要跳转H5页面，之前只用过 web-view，内嵌H5，这种方式需要配置域名白名单，并且在外链域名的根目录放置校验文件，H5不是自有页面的话，就不能这样去实现。

 <web-view
    src="https://render.alipay.com/p/s/web-view/index"
    onMessage="onmessage">
 </web-view>

my.ap.openURL

相对于 web-view，还有一种跳转H5的方式， my.ap.openURL，不需要配置域名，但是非支付宝官网页面只有部分符合开放类目的小程序可以使用，且需要到开放平台配置 openURL 白名单。已知目标页面的 URL 或 scheme，可以使用 my.ap.openURL。
跳转到支付宝官方 H5 页面是不需要配置白名单的。

  • https://render.alipay.com/p/ 开头的 URL。
  • https://ds.alipay.com/?scheme= 开头的 URL。
my.ap.openURL({
  // 请将 url 替换为后台加白过的跳转地址
  url: 'https://please.replace.me/page',
  success: (res) => console.log('openURL success'),
  fail: (err) => my.alert({ title: 'openURL fail: ' + JSON.stringify(err) })
});

web-view 和 my.ap.openURL 两者比较

两者都有不同的权限要求，下面是从文档拷过来的优劣对比表格，可以对照着选用合适的方式。

跳转方式优势劣势
内嵌H5页面，使用 web-view 内嵌H5流量归属于小程序本身。不限行业，无需审批。可以在H5页面上调用部分小程序的接口能力。需要完成 H5域名配置
外跳H5页面，使用 my.ap.openURL 外跳H5无需H5域名配置。可以免审跳转支付宝官方H5运营页面。流量不再归属于小程序本身。跳转到非支付宝官方页面只针对部分行业开放，并且需要完成平台侧审批流程（官方H5运营页面无此限制）。

my.ap.navigateToAlipayPage

my.ap.navigateToAlipayPage 是用于跳转到支付宝官方业务或运营活动页面的 API。这里利用不需要配置白名单的域名和scheme语法可以实现跳转。

// 支付宝客户端的标准scheme为：alipays://platformapi/startapp?appId=H5App自身的appId
// 但如果是某些运营页之类的单独页面，没有自己的appId，
// 可以使用Nebula容器的通用浏览器模式appId=20000067 来启动，
// 同时将需要打开的H5页面url经过encode编码后设置到url参数内
const url = 'https://www.baidu.com';
// https://render.alipay.com/p/ 不需要配置白名单
// 开了个后门，在不需要配置白名单的链接后面拼上自己的链接
const link = 'https://render.alipay.com/p/s/i/?scheme=' + encodeURIComponent('alipays://platformapi/startapp?appId=20000067&url=' + encodeURIComponent(url));
my.ap.navigateToAlipayPage({
  path: link
});

JSAPI跳转

JSAPI 是支付宝钱包提供的丰富的原生API功能，开发者可以使用它们方便调用支付宝提供的各种能力，达到媲美原生应用的体验，如页面跳转，支付功能等。
其中有一个跳转页面的API，pushWindow，用来打开一个新的页面，系统自带转场动画。

注意点

  • scheme 跳转请尽量使用 location.href 而不是 pushWindow。用 schema 的方式打开页面已经禁止使用，仅用于向下兼容老业务。
  • 与 location.href 的区别，pushWindow 类同于 PC 浏览器的新开标签页，每个 window 都是一个新的标签页，因此原页面仅仅是被压到后台，状态始终保持，JS 也会继续运行。location.href 则是在当前标签页直接跳转。

JSAPI是给H5使用的，而不是支付宝小程序。
现有的功能代码这样使用，应该是因为白名单限制，基础API中的前两种方式都不适合，才被迫使用JSAPI和禁止使用的scheme的。navigateToAlipayPage 是最近新发的文章里才看到可以支持支付宝小程序跳转H5连接（无需添加白名单） 。但是 navigateToAlipayPage 也已经不维护，而是用 openURL 替代。

my.call('pushWindow', {
  url: `alipays://platformapi/startapp?appId=20000067&url=${encodeURIComponent(
   'https://xxxx')}`
});

在小程序直接使用https链接会导致页面访问受限，无法打开，用scheme的方式可以跳过限制。但是不应该这么做，只是单纯的记录一下有这种操作。

startApp

需要申请startApp权限，可以跳转任意URL

my.call('startApp', {
  appId: '20000067',
  param: {
    url: 'https://xxx'
  }
});

总结

综上，跳转方式需具体情况具体分析，选择能力范围内最适合的方式，尽量不要选择禁用和停止维护的方法。这里不讨论支付宝官方页面，对自己人并没有太多限制。

跳转方式适用范围
web-view方便在H5根目录下放置校验文件
my.ap.openURL在限制类目范围内
my.ap.navigateToAlipayPage无限制，但是此API已停止维护
pushWindow无限制，但是pushWindow 禁止使用scheme的方式打开页面
startApp可以申请到支付宝的startApp权限，很难

扩展: 小程序scheme链接介绍

支付宝支付spanclasstoken小程序前端javascript

有关支付宝小程序跳转第三方H5页面的更多相关文章

  1. ruby - 在 Ruby 程序执行时阻止 Windows 7 PC 进入休眠状态 - 2

    我需要在客户计算机上运行Ruby应用程序。通常需要几天才能完成(复制大备份文件)。问题是如果启用sleep，它会中断应用程序。否则，计算机将持续运行数周，直到我下次访问为止。有什么方法可以防止执行期间休眠并让Windows在执行后休眠吗？欢迎任何疯狂的想法;-) 最佳答案 Here建议使用SetThreadExecutionStateWinAPI函数，使应用程序能够通知系统它正在使用中，从而防止系统在应用程序运行时进入休眠状态或关闭显示。像这样的东西:require'Win32API'ES_AWAYMODE_REQUIRED=0x0

  2. ruby - 如何指定 Rack 处理程序 - 2

    Rackup通过Rack的默认处理程序成功运行任何Rack应用程序。例如:classRackAppdefcall(environment)['200',{'Content-Type'=>'text/html'},["Helloworld"]]endendrunRackApp.new但是当最后一行更改为使用Rack的内置CGI处理程序时，rackup给出“NoMethodErrorat/undefinedmethod`call'fornil:NilClass”:Rack::Handler::CGI.runRackApp.newRack的其他内置处理程序也提出了同样的反对意见。例如Rack

  3. ruby - 在 Ruby 中编写命令行实用程序 - 2

    我想用ruby​​编写一个小的命令行实用程序并将其作为gem分发。我知道安装后，Guard、Sass和Thor等某些gem可以从命令行自行运行。为了让gem像二进制文件一样可用，我需要在我的gemspec中指定什么。 最佳答案 Gem::Specification.newdo|s|...s.executable='name_of_executable'...endhttp://docs.rubygems.org/read/chapter/20 关于ruby-在Ruby中编写命令行实用程序

  4. ruby-on-rails - Rails 应用程序之间的通信 - 2

    我构建了两个需要相互通信和发送文件的Rails应用程序。例如，一个Rails应用程序会发送请求以查看其他应用程序数据库中的表。然后另一个应用程序将呈现该表的json并将其发回。我还希望一个应用程序将存储在其公共(public)目录中的文本文件发送到另一个应用程序的公共(public)目录。我从来没有做过这样的事情，所以我什至不知道从哪里开始。任何帮助，将不胜感激。谢谢! 最佳答案 无论Rails是什么，几乎所有Web应用程序都有您的要求，大多数现代Web应用程序都需要相互通信。但是有一个小小的理解需要你坚持下去，网站不应直接访问彼此

  5. ruby - 无法运行 Rails 2.x 应用程序 - 2

    我尝试运行2.x应用程序。我使用rvm并为此应用程序设置其他版本的ruby​​:$rvmuseree-1.8.7-head我尝试运行服务器，然后出现很多错误:$script/serverNOTE:Gem.source_indexisdeprecated,useSpecification.Itwillberemovedonorafter2011-11-01.Gem.source_indexcalledfrom/Users/serg/rails_projects_terminal/work_proj/spohelp/config/../vendor/rails/railties/lib/r

  6. ruby-on-rails - Rails 应用程序中的 Rails : How are you using application_controller. rb 是新手吗？ - 2

    刚入门rails，开始慢慢理解。有人可以解释或给我一些关于在application_controller中编码的好处或时间和原因的想法吗？有哪些用例。您如何为Rails应用程序使用应用程序Controller？我不想在那里放太多代码，因为据我了解，每个请求都会调用此Controller。这是真的？ 最佳答案 ApplicationController实际上是您应用程序中的每个其他Controller都将从中继承的类(尽管这不是强制性的)。我同意不要用太多代码弄乱它并保持干净整洁的态度，尽管在某些情况下ApplicationContr

  7. ruby-on-rails - 如何在我的 Rails 应用程序 View 中打印 ruby​​ 变量的内容？ - 2

    我是一个Rails初学者，但我想从我的RailsView(html.haml文件)中查看Ruby变量的内容。我试图在ruby​​中打印出变量(认为它会在终端中出现)，但没有得到任何结果。有什么建议吗？我知道Rails调试器，但更喜欢使用inspect来打印我的变量。 最佳答案 您可以在View中使用puts方法将信息输出到服务器控制台。您应该能够在View中的任何位置使用Haml执行以下操作:-puts@my_variable.inspect 关于ruby-on-rails-如何在我的R

  8. ruby - 检查是否通过 require 执行或导入了 Ruby 程序 - 2

    如何检查Ruby文件是否是通过“require”或“load”导入的，而不是简单地从命令行执行的？例如:foo.rb的内容:puts"Hello"bar.rb的内容require'foo'输出:$./foo.rbHello$./bar.rbHello基本上，我想调用bar.rb以不执行puts调用。 最佳答案 将foo.rb改为:if__FILE__==$0puts"Hello"end检查__FILE__-当前ruby​​文件的名称-与$0-正在运行的脚本的名称。 关于ruby-检查是否

  9. ruby-on-rails - 如何在 Gem 中获取 Rails 应用程序的根目录 - 2

    是否可以在应用程序中包含的gem代码中知道应用程序的Rails文件系统根目录？这是gem来源的示例:moduleMyGemdefself.included(base)putsRails.root#returnnilendendActionController::Base.send:include,MyGem谢谢，抱歉我的英语不好 最佳答案 我发现解决类似问题的解决方案是使用railtie初始化程序包含我的模块。所以，在你的/lib/mygem/railtie.rbmoduleMyGemclassRailtie使用此代码，您的模块将在

  10. 程序员如何提高代码能力？ - 2

    前言作为一名程序员，自己的本质工作就是做程序开发，那么程序开发的时候最直接的体现就是代码，检验一个程序员技术水平的一个核心环节就是开发时候的代码能力。众所周知，程序开发的水平提升是一个循序渐进的过程，每一位程序员都是从“菜鸟”变成“大神”的，所以程序员在程序开发过程中的代码能力也是根据平时开发中的业务实践来积累和提升的。提高代码能力核心要素程序员要想提高自身代码能力，尤其是新晋程序员的代码能力有很大的提升空间的时候，需要针对性的去提高自己的代码能力。提高代码能力其实有几个比较关键的点，只要把握住这些方面，就能很好的、快速的提高自己的一部分代码能力。1、多去阅读开源项目，如有机会可以亲自参与开源

随机推荐