Compte

Vérifiez une clé : le compte client auquel elle appartient, ses scopes, son offre et sa limite de débit.

URL de base https://api.hillsmusic.com/v1. Chaque requête envoie une clé d’API : Authorization: Bearer hm_live_….

• Qui suis-je
• Test de connexion

Qui suis-je

GET /v1/me · Toute clé valide

Le compte client auquel appartient la clé, ainsi que le nom, les scopes et l’expiration de la clé. Pratique pour vérifier qu’une clé fonctionne.

Exemple de requête

curl "https://api.hillsmusic.com/v1/me" \
  -H "Authorization: Bearer $HILLS_API_KEY"

Réponse 200

{
  "partner": {
    "id": 12,
    "name": "Nova Records",
    "email": "ops@novarecords.com"
  },
  "environment": "production",
  "key": {
    "id": 3,
    "name": "ERP sync",
    "prefix": "hm_live_ab12cd34",
    "environment": "production",
    "scopes": [
      "catalog:read",
      "earnings:read"
    ],
    "expires_at": null,
    "created_at": "2026-10-01T09:00:00Z"
  }
}

Erreurs

Test de connexion

GET /v1/ping · Toute clé valide

Toute clé valide : le compte, l’offre, les scopes de la clé, la limite de débit restante et l’heure du serveur. L’appel apparaît sur la page de livraison DDEX (Connection, Activity).

Exemple de requête

curl "https://api.hillsmusic.com/v1/ping" \
  -H "Authorization: Bearer $HILLS_API_KEY"

Réponse 200

{
  "ok": true,
  "environment": "production",
  "server_time": "2026-10-07T09:00:00.000Z",
  "account": {
    "id": 12,
    "name": "Nova Records",
    "email": "ops@novarecords.com"
  },
  "plan": {
    "included": true,
    "plan": "enterprise",
    "rate": 120
  },
  "key": {
    "prefix": "hm_live_ab12cd34",
    "scopes": [
      "ddex:write"
    ]
  },
  "rate_limit": {
    "limit": 120,
    "remaining": 119
  }
}

Erreurs