Skip to content

Latest commit

 

History

History
60 lines (50 loc) · 1.4 KB

user.md

File metadata and controls

60 lines (50 loc) · 1.4 KB

User

GET /user/search

Search for keys by user name or service.

::: warning If you use these search results directly, you are trusting the keys.pub server. It is recommended to use this API to find a key and then to verify the user statement in the key's sigchain yourself. For details on how to verify sigchains and users see User#Verify. :::

Request Description
q Query.
limit Limit number of results.
curl https://keys.pub/user/search?q=gabriel
{
  "users": [
    {
      "id": "gabriel@github",
      "name": "gabriel",
      "kid": "kex1mnseg28xu6g3j4wur7hqwk8ag3fu3pmr2t5lync26xmgff0dtryqupf80c",
      "seq": 1,
      "service": "github",
      "url": "https://gist.github.com/gabriel/ceea0f3b675bac03425472692273cf52",
      "status": "ok",
      "verifiedAt": 1581680761310
    }
  ]
}

GET /user/:kid

Get user for key.

curl https://keys.pub/user/kex1mnseg28xu6g3j4wur7hqwk8ag3fu3pmr2t5lync26xmgff0dtryqupf80c
{
  "user": {
    "id": "gabriel@github",
    "name": "gabriel",
    "kid": "kex1mnseg28xu6g3j4wur7hqwk8ag3fu3pmr2t5lync26xmgff0dtryqupf80c",
    "seq": 1,
    "service": "github",
    "url": "https://gist.github.com/gabriel/ceea0f3b675bac03425472692273cf52",
    "status": "ok",
    "verifiedAt": 1582097462744
  }
}