Créer une clé API consommateur
curl --request POST \
--url https://api.truthlocks.com/v1/consumer/api-keys \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "CI pipeline key"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'CI pipeline key'})
};
fetch('https://api.truthlocks.com/v1/consumer/api-keys', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/consumer/api-keys"
payload = { "name": "CI pipeline key" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/consumer/api-keys"
payload := strings.NewReader("{\n \"name\": \"CI pipeline key\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"key_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "CI pipeline key",
"prefix": "tlk_abcd1234",
"status": "active",
"scopes": [
"consumer:read",
"consumer:write",
"attestations:mint",
"attestations:read",
"verify:read"
],
"secret": "tlk_abcd1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678",
"created_at": "2026-03-25T14:30:00.000Z",
"expires_at": "2026-06-23T14:30:00.000Z"
}{
"code": "VALIDATION_ERROR",
"message": "Maximum of 5 active API keys reached. Revoke an existing key first.",
"http_status": 400
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Consommateur (B2C)
Créer une clé API consommateur
Crée une nouvelle clé API personnelle. Le secret complet est renvoyé une fois et ne peut plus être récupéré. Les consommateurs peuvent détenir jusqu’à 5 clés actives. Les clés expirent après 90 jours. Nécessite une session de consommateur individuel authentifiée ; une session d’entreprise ou une clé API d’espace de travail ne peut pas remplacer l’identité de l’utilisateur.
POST
/
v1
/
consumer
/
api-keys
Créer une clé API consommateur
curl --request POST \
--url https://api.truthlocks.com/v1/consumer/api-keys \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "CI pipeline key"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'CI pipeline key'})
};
fetch('https://api.truthlocks.com/v1/consumer/api-keys', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/consumer/api-keys"
payload = { "name": "CI pipeline key" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/consumer/api-keys"
payload := strings.NewReader("{\n \"name\": \"CI pipeline key\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"key_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "CI pipeline key",
"prefix": "tlk_abcd1234",
"status": "active",
"scopes": [
"consumer:read",
"consumer:write",
"attestations:mint",
"attestations:read",
"verify:read"
],
"secret": "tlk_abcd1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678",
"created_at": "2026-03-25T14:30:00.000Z",
"expires_at": "2026-06-23T14:30:00.000Z"
}{
"code": "VALIDATION_ERROR",
"message": "Maximum of 5 active API keys reached. Revoke an existing key first.",
"http_status": 400
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Crée une nouvelle clé API personnelle pour le consommateur authentifié. Le secret complet est renvoyé une seule fois dans la réponse et ne peut plus être récupéré — stockez-le en toute sécurité.
Chaque consommateur peut détenir jusqu’à 5 clés actives. Les clés expirent automatiquement après 90 jours.
Réponses
Réponse
Clé API créée. Le secret n'est affiché que dans cette réponse.

