API.fetchSubscriberDRMSeries
This action allows you to recover all the serial subscriptions of a subscriber
Request
The API key must have the subscribers_read access right.
| Name | Type | Description |
|---|---|---|
| apikey[required] | string | API public key |
| signature[required] | string | Signature of the request. See how to sign your requests. |
| expires | timestamp | UNIX timestamp for request expiration. |
| output | string | Format of the response. Either XML (default), JSON or PHP. |
| subscription_id[required] | integer | ID of the subscription. |
| login[required] | string | Login of the subscriber. |
Response
This request sends a array containing the requested subscriptions with the following information:
| Name | Type | Description |
|---|---|---|
| ID | integer | DRM ID. |
| SubscriptionID | integer | ID of the subscription. |
| SubscriberLogin | string | Login of the subscriber. |
| From | date | Start date of the subscription period. |
| Books | integer | Number of publications. |
| Date | datetime | Date of the subscription. |
| Extras | string | Free field of up to 255 characters |
Example responses
<response>
<requestid>...</requestid>
<requests>...</requests>
<status>ok</status>
<content>
<total>...</total>
<start>...</start>
<step>...</step>
<items>
<item>
<ID>...</ID>
<SubscriptionID>...</SubscriptionID>
<SubscriberLogin>...</SubscriberLogin>
<From>...</From>
<Books>...</Books>
<Date>...</Date>
<Extras>...</Extras>
</item>
</items>
</content>
</response>
{
"response": {
"requestid": ...,
"requests": ...,
"status": "ok",
"content": {
"total": ...,
"start": ...,
"step": ...,
"items": [
{
"ID": ...,
"SubscriptionID": ...,
"SubscriberLogin": ...,
"From": ...,
"Books": ...,
"Date": ...,
"Extras": ...
}
]
}
}
}
[
"response" => [
"requestid" => ...,
"requests" => ...,
"status" => "ok",
"content" => [
"total" => ...,
"start" => ...,
"step" => ...,
"items" => [
[
"ID" => ...,
"SubscriptionID" => ...,
"SubscriberLogin" => ...,
"From" => ...,
"Books" => ...,
"Date" => ...,
"Extras" => ...
]
]
]
]
]
Error codes
See the error code section.
