GraphQL API
The most powerful API for accessing your WebAssembly modules, now completely open for all to use
What is GraphQL?
GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data. GraphQL provides a complete and understandable description of the data in your API, gives clients the power to ask for exactly what they need and nothing more, makes it easier to evolve APIs over time, and enables powerful developer tools.
How I can use the WAPM API?
The WAPM GraphQL API (and the GraphiQL IDE) can be accessed here:
Did you know...?
WebAssembly.sh is using the WAPM GraphQL API to automatically expose the WASI modules and commands in the online shell
Examples
Let's see now a few things that we can do with it!
Get a Package Version
We can do a POST to https://registry.wapm.io/graphql with the the following as the
query POST field:1
{
2
getPackageVersion(name: "python") {
3
version
4
repository
5
homepage
6
distribution {
7
downloadUrl
8
size
9
}
10
}
11
}
Copied!
Which should return something similar to:
1
{
2
"data": {
3
"getPackageVersion": {
4
"version": "0.1.0",
5
"repository": "https://github.com/wapm-packages/python",
6
"homepage": null,
7
"distribution": {
8
"downloadUrl": "https://registry-cdn.wapm.io/packages/_/python/python-0.1.0.tar.gz",
9
"size": 5097541
10
}
11
}
12
}
13
}
Copied!
Get all Packages for a given Interface
If we want to search all the packages published that have certain interface (for example, WASI), we can do a POST to https://registry.wapm.io/graphql with the the following as the
query POST field:1
{
2
getInterfaceVersion(name: "wasi", version: "latest") {
3
interface {
4
name
5
description
6
}
7
packageVersions {
8
edges {
9
node {
10
version
11
package {
12
name
13
}
14
distribution {
15
downloadUrl
16
}
17
}
18
}
19
}
20
}
21
}
Copied!
Which should return something similar to:
1
{
2
"data": {
3
"getInterfaceVersion": {
4
"interface": {
5
"name": "wasi",
6
"description": "The WebAssembly System Interface. WASI is a modular system interface for WebAssembly. It’s focused on security and portability."
7
},
8
"packageVersions": {
9
"edges": [
10
{
11
"node": {
12
"version": "0.1.0",
13
"package": {
14
"name": "_/python"
15
},
16
"distribution": {
17
"downloadUrl": "https://registry-cdn.wapm.io/packages/_/python/python-0.1.0.tar.gz"
18
}
19
}
20
},
21
{
22
"node": {
23
"version": "0.0.2",
24
"package": {
25
"name": "JeremyLikness/wasi-ubasic"
26
},
27
"distribution": {
28
"downloadUrl": "https://registry-cdn.wapm.io/packages/JeremyLikness/wasi-ubasic/wasi-ubasic-0.0.2.tar.gz"
29
}
30
}
31
},
32
{
33
"node": {
34
"version": "0.4.6",
35
"package": {
36
"name": "vshymanskyy/wasm3"
37
},
38
"distribution": {
39
"downloadUrl": "https://registry-cdn.wapm.io/packages/vshymanskyy/wasm3/wasm3-0.4.6.tar.gz"
40
}
41
}
42
}
43
]
44
}
45
}
46
}
47
}
Copied!
Happy hacking! 🎉
Last modified 2mo ago